Finish first draft of manual.

[enjoyable.git] / Enjoyable Help / pgs / mappings.html

diff --git a/Enjoyable Help/pgs/mappings.html b/Enjoyable Help/pgs/mappings.html
index 27942d4..6a49461 100644 (file)
--- a/Enjoyable Help/pgs/mappings.html
+++ b/Enjoyable Help/pgs/mappings.html
@@ -34,11 +34,59 @@
       <h1>Application Mappings</h1>
     </div>
 
+    <p>
+      You can make many different mappings and switch between them
+      easily.  To open the list of mappings click the button at the
+      top-left or press ⌘L.
+    </p>
+
+    <p>
+      Click on a mapping to switch to it. Create a new mapping with
+      the + button or by typing ⌘N. Delete the current mapping with
+      the - button or ⌘⌫. Rename a mapping by double-clicking on it or
+      pressing Return while it's selected.
+    </p>
+
+    <p>
+      You can also switch mappings with the <b>Mappings</b> menu, with
+      Enjoyable's dock menu, or by pressing ⌘1 through ⌘9.
+    </p>
+
+    <p>
+      Switching mappings can also be mapped to an input. Select the
+      input you wish to use and then choose a mapping from
+      the <b>Switch to mapping</b> option. For example, you could have
+      one mapping for a game's menu and another for its main screen
+      and switch between them in-game without returning to Enjoyable.
+    </p>
+
     <h3><a name="automatic"></a>Automatic Switching</h3>
-    
+    <p>
+      If you name a mapping after an application it will be
+      automatically chosen when you switch to that application. The
+      name of an application is usually shown on the dock when you
+      hover your mouse over it. If you don't know the name of the
+      application you want to create a mapping for, create a mapping
+      with the name <kbd>@Application</kbd> (note the <kbd>@</kbd> at
+      the start). The mapping will automatically be renamed for the
+      next application you switch to while it's enabled.
+    </p>
 
     <h3><a name="sharing"></a>Import and Export</h3>
-    
-
+    <p>
+      Mappings can be exported and shared with other people. To export
+      your current mapping choose <b>Mappings > Export…</b> or press ⌘S and
+      save the file. This file can be shared with anyone; it doesn't
+      contain any personal information other than the product IDs of
+      the input devices you used and what you mapped them to.
+    </p>
+    <p>
+      To import a mapping choose <b>Mappings > Import…</b> or press
+      ⌘O and select the file you want to import. Mapping files end
+      with <kbd>.enjoyable</kbd> (the default), <kbd>.json</kbd>,
+      or <kbd>.txt</kbd>. If the imported mapping conflicts with one
+      you already made, you can choose to merge the two mappings or
+      create a new one with the same name.
+    </p>
     </body>
 </html>