Update documentation for mouse events.
authorJoe Wreschnig <joe.wreschnig@gmail.com>
Sat, 9 Mar 2013 20:09:22 +0000 (21:09 +0100)
committerJoe Wreschnig <joe.wreschnig@gmail.com>
Sat, 9 Mar 2013 20:09:22 +0000 (21:09 +0100)
Enjoyable.xcodeproj/project.pbxproj
Info.plist
Resources/Help/Contents/Info.plist
Resources/Help/Contents/Resources/English.lproj/index.html
Resources/Help/Contents/Resources/English.lproj/pgs/mouse.html
Resources/Help/Contents/Resources/English.lproj/pgs/problems.html
Resources/Help/Contents/Resources/English.lproj/pgs/whatsnew.html [new file with mode: 0644]

index 837baa9..276335d 100644 (file)
@@ -14,6 +14,7 @@
                EE3D897F16EA817E00596D1F /* Status Menu Icon Disabled.png in Resources */ = {isa = PBXBuildFile; fileRef = EE3D897D16EA817E00596D1F /* Status Menu Icon Disabled.png */; };
                EE3D898016EA817E00596D1F /* Status Menu Icon.png in Resources */ = {isa = PBXBuildFile; fileRef = EE3D897E16EA817E00596D1F /* Status Menu Icon.png */; };
                EE6A122E16E8F46300EDBD32 /* Icon.icns in Resources */ = {isa = PBXBuildFile; fileRef = EE6A122D16E8F46300EDBD32 /* Icon.icns */; };
+               EECDEE2916EBCAF800DE7450 /* whatsnew.html in Resources */ = {isa = PBXBuildFile; fileRef = EECDEE2816EBCAF800DE7450 /* whatsnew.html */; };
                EEE73B1616EA42E5009D9D99 /* NSRunningApplication+NJPossibleNames.m in Sources */ = {isa = PBXBuildFile; fileRef = EEE73B1516EA42E5009D9D99 /* NSRunningApplication+NJPossibleNames.m */; };
                EEF17D1916E8E21A00D7DC4D /* com.yukkurigames.Enjoyable.mapping.icns in Resources */ = {isa = PBXBuildFile; fileRef = EEF17D1716E8E21A00D7DC4D /* com.yukkurigames.Enjoyable.mapping.icns */; };
                EEF17D1F16E8E23A00D7DC4D /* InfoPlist.strings in Resources */ = {isa = PBXBuildFile; fileRef = EEF17D1B16E8E23A00D7DC4D /* InfoPlist.strings */; };
@@ -57,6 +58,7 @@
                EE3D897D16EA817E00596D1F /* Status Menu Icon Disabled.png */ = {isa = PBXFileReference; lastKnownFileType = image.png; name = "Status Menu Icon Disabled.png"; path = "Resources/Status Menu Icon Disabled.png"; sourceTree = "<group>"; };
                EE3D897E16EA817E00596D1F /* Status Menu Icon.png */ = {isa = PBXFileReference; lastKnownFileType = image.png; name = "Status Menu Icon.png"; path = "Resources/Status Menu Icon.png"; sourceTree = "<group>"; };
                EE6A122D16E8F46300EDBD32 /* Icon.icns */ = {isa = PBXFileReference; lastKnownFileType = image.icns; path = Icon.icns; sourceTree = "<group>"; };
+               EECDEE2816EBCAF800DE7450 /* whatsnew.html */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = text.html; name = whatsnew.html; path = Resources/Help/Contents/Resources/English.lproj/pgs/whatsnew.html; sourceTree = "<group>"; };
                EEE73B1416EA42E5009D9D99 /* NSRunningApplication+NJPossibleNames.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; name = "NSRunningApplication+NJPossibleNames.h"; path = "Categories/NSRunningApplication+NJPossibleNames.h"; sourceTree = "<group>"; };
                EEE73B1516EA42E5009D9D99 /* NSRunningApplication+NJPossibleNames.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; name = "NSRunningApplication+NJPossibleNames.m"; path = "Categories/NSRunningApplication+NJPossibleNames.m"; sourceTree = "<group>"; };
                EEF17D1716E8E21A00D7DC4D /* com.yukkurigames.Enjoyable.mapping.icns */ = {isa = PBXFileReference; lastKnownFileType = image.icns; name = com.yukkurigames.Enjoyable.mapping.icns; path = Resources/com.yukkurigames.Enjoyable.mapping.icns; sourceTree = "<group>"; };
                29B97314FDCFA39411CA2CEA /* Enjoy */ = {
                        isa = PBXGroup;
                        children = (
+                               EECDEE2816EBCAF800DE7450 /* whatsnew.html */,
                                8D1107310486CEB800E47090 /* Info.plist */,
                                080E96DDFE201D6D7F000001 /* Classes */,
                                EE1D5F8B16E403D600749C36 /* Categories */,
                                EE3D897C16EA806E00596D1F /* Status Menu Icon Disabled@2x.png in Resources */,
                                EE3D897F16EA817E00596D1F /* Status Menu Icon Disabled.png in Resources */,
                                EE3D898016EA817E00596D1F /* Status Menu Icon.png in Resources */,
+                               EECDEE2916EBCAF800DE7450 /* whatsnew.html in Resources */,
                        );
                        runOnlyForDeploymentPostprocessing = 0;
                };
index c382613..76b3f48 100644 (file)
@@ -46,7 +46,7 @@
        <key>CFBundleSignature</key>
        <string>????</string>
        <key>CFBundleVersion</key>
-       <string>77</string>
+       <string>84</string>
        <key>LSApplicationCategoryType</key>
        <string>public.app-category.utilities</string>
        <key>NSHumanReadableCopyright</key>
index e62b80f..1f4edfb 100644 (file)
        <key>CFBundlePackageType</key>
        <string>BNDL</string>
        <key>CFBundleShortVersionString</key>
-       <string>1</string>
+       <string>1.1</string>
        <key>CFBundleSignature</key>
        <string>hbwr</string>
        <key>CFBundleVersion</key>
-       <string>1</string>
+       <string>2</string>
        <key>HPDBookAccessPath</key>
        <string>index.html</string>
        <key>HPDBookIconPath</key>
index 1a52296..10d998a 100644 (file)
     </p>
 
     <div style="display: table-cell; width: 40%; padding-right: 1em">
+        <p>
+        <a href="help:anchor='whatsnew' bookID='com.yukkurigames.Enjoyable.help'">
+            What's New in 1.1?
+        </a>
+        </p>
       <h3>Quick Start</h3>
       <ul>
         <li>Connect a joystick or gamepad.</li>
index 0293fd0..c88e8ad 100644 (file)
     <p>
       Simulated scrolling can be continuous like the scrolling
       gestures on a trackpad, or discrete like a mouse wheel that
-      clicks as you spin it.
+      clicks as you spin it. You can simulate a vertical or horizontal
+      mouse wheel.
     </p>
     <p>
-      To use <em>continuous scrolling</em> choose ↑ or ↓. Use the
-      slider underneath them to adjust the scrolling speed. If you are
-      mapping an analog input then this is the maximum speed; for a
-      button it's a constant speed.
+      To use <em>continuous scrolling</em> check the <b>Smooth</b>
+      button and use the slider underneath the directions to adjust
+      the scrolling speed. If you are mapping an analog input then
+      this is the maximum speed; for a button it's a constant
+      speed. Scrolling will continue as long as as the input is held
+      down.
     <p>
-      To use <em>discrete scrolling</em> choose ⤒ or ⤓. The input
-      will trigger scrolling up or down by exactly one line and stop,
-      regardless of how long you hold the button down or how far
-      you move an analog input.
+      To use <em>discrete scrolling</em> leave the button
+      unchecked. The input will trigger scrolling by exactly one line
+      and stop, regardless of how long you hold the button down or how
+      far you move an analog input.
     </p>
     <p>
       The arrows indicate the direction you would spin a mouse wheel
     
     <h3><a name="mouseissues"></a>Known Issues</h3>
     <p>
-      Mouse events are more fragile than keyboard ones. While Enjoyble
-      will work fine for most games, regular OS X (Cocoa) applications
-      require specially formatted mouse events. Features such as
-      click-and-drag or double-clicking will not work correctly, so
-      many applications will behave incorrectly if driven by an
-      Enjoyable simulated mouse.
-    </p>
-    <p>
-      If you find a non-Cocoa application that has problems with
-      Enjoyable's mouse
-      support <a href="https://github.com/joewreschnig/enjoyable/issues">please
+      Enjoyable is unable to send most mouse events to itself - the
+      application will freeze until you click on it with a real mouse
+      or touchpad. If you find another appliation that has problems
+      with Enjoyable's mouse support <a
+      href="https://github.com/joewreschnig/enjoyable/issues">please
       file a ticket in the issue tracker</a>.
-    </p>
-    
+    </p>    
   </body>
 </html>
index 8f3aa68..5cb6d8c 100644 (file)
       <a name="brokenmouse"></a>
     </h3>
     <p>
-      This is a known issue with Cocoa applications, as they require
-      more specially-crafted mouse events. We hope to fix it in a
-      future version.
-    </p>
+      For reasons yet to be determined, Enjoyable can freeze if it
+      receives its own simulated mouse events. All other applications
+      should work fine; however, mouse events are finicky and it's
+      possible some applications may not like the way they are
+      handled. If you find an appliation that has problems with
+      Enjoyable's mouse support <a
+      href="https://github.com/joewreschnig/enjoyable/issues">please
+      file a ticket in the issue tracker</a>.  </p>
   </body>
 </html>
diff --git a/Resources/Help/Contents/Resources/English.lproj/pgs/whatsnew.html b/Resources/Help/Contents/Resources/English.lproj/pgs/whatsnew.html
new file mode 100644 (file)
index 0000000..a299806
--- /dev/null
@@ -0,0 +1,61 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+    <head>
+        <title>What's New in Enjoyable</title>
+        <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
+        <link href="../sty/default.css"
+        rel="stylesheet"
+        type="text/css"
+        media="all"/>
+    </head>
+    
+    <body>
+        <a name="whatsnew"></a>
+        
+        <div id="navbox">
+            <div id="navleftbox">
+                <a class="navlink_left"
+                    href="help:anchor='home' bookID='com.yukkurigames.Enjoyable.help'">
+                    Home
+                </a>
+            </div>
+        </div>
+        
+        <div id="headerbox">
+            <div id="iconbox">
+                <img id="iconimg"
+                src="../gfx/Icon.png"
+                alt="Icon"
+                height="32" width="32"/>
+            </div>
+            <h1>What's New in 1.1</h1>
+        </div>
+        
+        <ul>
+            <li>
+                The system menu bar now contains a status item when
+                Enjoyable is running. You can enable and disable it
+                and change mappings from this item. It flashes briefly
+                when the mapping changes automatically.
+            </li>
+            <li>
+                The middle mouse button, mouse buttons 4 and 5, and
+                horizontal scroll wheels can be simulated.
+            </li>
+            <li>
+                Many mouse issues have been fixed.  Click-and-drag,
+                double-click, and other combined mouse gestures work
+                correctly in most applications other than Enjoyable
+                itself.
+            </li>
+            <li>
+                Automatic switching for applications with ambiguous
+                names (e.g. "Flash Player") has been improved. You can
+                now also name a mapping after the application's
+                filename.
+            </li>
+        </ul>
+    </body>
+</html>
\ No newline at end of file