2011-08-30 [colin] 3.7.10cvs8
[claws.git] / manual / keyboard.xml
index d47eb80..4110d92 100644 (file)
 <appendix id="ap_keyboard">
 <title>Default keyboard shortcuts</title>
 
-  <section id="keyb_mail">
-    <title>Main window</title>
+  <section id="keyb_general">
+    <title>Motivations and general conventions</title>
+    <para>
+       Although Claws Mail is a graphical application and can mainly be 
+       commanded with your mouse, it also requires the frequent use of the 
+       keyboard. Composing a mail is the most common of the tasks that 
+       require the use of the keyboard. For people who write a lot of mails, 
+       having to move hands from keyboard to mouse greatly reduces 
+       productivity, so Claws Mail provides keyboard shortcuts to allow 
+       faster operation.
+    </para>
+    <para>
+       This not only benefits power users by providing keyboard alternatives 
+       and keyboard navigation, it also enables people with disabilities, 
+       (who may not be able to properly control a pointing device), to use 
+       Claws Mail.
+    </para>
+    <para>
+       The most general convention is the <option>Escape</option> key. Focused 
+       dialogues or windows can be closed by hitting the <option>Esc</option> 
+       key.
+    </para>
     <para>
+       There are other key combinations which are assigned by default to menu 
+       items. We won't list these here, as they are already shown on the 
+       righthand side of the menus themselves, so you can easily learn them 
+       with usage. Furthermore, if you don't like them, these shortcuts can be 
+       changed on the fly by focusing on the menu item and pressing the 
+       desired key combination.
     </para>
+    <para>
+       In addition to these shortcuts there are others which vary from window 
+       to window, which are summarised in the following sections.
+    </para>
+  </section>
+
+  <section id="keyb_mail">
+    <title>Main window</title>
+    <informaltable frame="topbot">
+      <tgroup cols="2">
+        <colspec colwidth="*" />
+        <colspec colwidth="4*" />
+       <thead>
+          <row><entry>Shortcut</entry><entry></entry></row>
+       </thead>
+        <tbody>
+         <row><entry><option>Ctrl+p</option></entry><entry>Print...</entry></row>
+         <row><entry><option>Ctrl+w</option></entry><entry>Work offline</entry></row>
+         <row><entry><option>Ctrl+Shift+s</option></entry><entry>Synchronise folders</entry></row>
+         <row><entry><option>Ctrl+s</option></entry><entry>Save as...</entry></row>
+         <row><entry><option>Ctrl+q</option></entry><entry>Exit</entry></row>
+         <row><entry><option>Ctrl+c</option></entry><entry>Copy</entry></row>
+         <row><entry><option>Ctrl+a</option></entry><entry>Select all</entry></row>
+         <row><entry><option>Ctrl+f</option></entry><entry>Find in current message...</entry></row>
+         <row><entry><option>Shift+Ctrl+f</option></entry><entry>Search folder...</entry></row>
+         <row><entry><option>Ctrl+t</option></entry><entry>Toggle threaded display</entry></row>
+          <row><entry><option>n</option></entry><entry>Go to next mail in Message List. The <option>Down</option> arrow does the same.</entry></row>
+          <row><entry><option>p</option></entry><entry>Go to previous mail. The <option>Up</option> arrow is a synonym.</entry></row>
+         <row><entry><option>Shift+n</option></entry><entry>Go to next unread mail.</entry></row>
+          <row><entry><option>Shift+p</option></entry><entry>Go to previous unread mail.</entry></row>
+         <row><entry><option>g</option></entry><entry>Go to other folder...</entry></row>
+         <row><entry><option>Ctrl+u</option></entry><entry>Show message source</entry></row>
+         <row><entry><option>Ctrl+h</option></entry><entry>Show all message headers</entry></row>
+         <row><entry><option>v</option></entry><entry>Toggles the message view panel visibility. When invisible, Message List expands itself to fill the full window height and more summary lines are displayed.</entry></row>
+         <row><entry><option>/</option></entry><entry>Positions the cursor on the Quicksearch field, also opening the Quicksearch panel if needed.</entry></row>
+         <row><entry><option>Ctrl+Alt+u</option></entry><entry>Update summary</entry></row>
+         <row><entry><option>Ctrl+i</option></entry><entry>Get mail from current account</entry></row>
+         <row><entry><option>Shift+Ctrl+i</option></entry><entry>Get mail from all accounts</entry></row>
+         <row><entry><option>Ctrl+m</option></entry><entry>Compose a new message</entry></row>
+         <row><entry><option>Ctrl+r</option></entry><entry>Reply</entry></row>
+         <row><entry><option>Shift+Ctrl+r</option></entry><entry>Reply to all</entry></row>
+         <row><entry><option>Ctrl+l</option></entry><entry>Reply to mailing list</entry></row>
+         <row><entry><option>Ctrl+Alt+f</option></entry><entry>Forward message</entry></row>
+         <row><entry><option>Ctrl+o</option></entry><entry>Move...</entry></row>
+         <row><entry><option>Shift+Ctrl+o</option></entry><entry>Copy...</entry></row>
+         <row><entry><option>Ctrl+d</option></entry><entry>Move to trash</entry></row>
+         <row><entry><option>Shift+d</option></entry><entry>Empty all Trash folders</entry></row>
+         <row><entry><option>Shift+*</option></entry><entry>Mark message</entry></row>
+         <row><entry><option>u</option></entry><entry>Unmark message</entry></row>
+         <row><entry><option>Shift+!</option></entry><entry>Mark message as unread</entry></row>
+         <row><entry><option>Shift+Ctrl+a</option></entry><entry>Open address book</entry></row>
+         <row><entry><option>x</option></entry><entry>Execute</entry></row>
+         <row><entry><option>Shift+Ctrl+l</option></entry><entry>Open log window</entry></row>
+        </tbody>
+      </tgroup>
+    </informaltable>
   </section>
 
   <section id="keyb_compose">
     <title>Compose window</title>
-    <para>
-    </para>
+    <informaltable frame="topbot">
+     <tgroup cols="2">
+     <colspec colwidth="*" />
+     <colspec colwidth="4*" />
+     <thead>
+       <row><entry>Shortcut</entry><entry></entry></row>
+     </thead>
+      <tbody>
+         <row><entry><option>Ctrl+Return</option></entry><entry>Send</entry></row>
+         <row><entry><option>Shift+Ctrl+s</option></entry><entry>Send later</entry></row>
+         <row><entry><option>Ctrl+m</option></entry><entry>Attach file</entry></row>
+         <row><entry><option>Ctrl+i</option></entry><entry>Insert file</entry></row>
+         <row><entry><option>Ctrl+g</option></entry><entry>Insert signature</entry></row>
+         <row><entry><option>Ctrl+s</option></entry><entry>Save</entry></row>
+         <row><entry><option>Ctrl+w</option></entry><entry>Close</entry></row>
+         <row><entry><option>Ctrl+z</option></entry><entry>Undo</entry></row>
+         <row><entry><option>Ctrl+y</option></entry><entry>Redo</entry></row>
+         <row><entry><option>Ctrl+x</option></entry><entry>Cut</entry></row>
+         <row><entry><option>Ctrl+c</option></entry><entry>Copy</entry></row>
+         <row><entry><option>Ctrl+v</option></entry><entry>Paste</entry></row>
+         <row><entry><option>Ctrl+a</option></entry><entry>Select all</entry></row>
+         <row><entry><option>Ctrl+b</option></entry><entry>Move a character backward</entry></row>
+         <row><entry><option>Ctrl+f</option></entry><entry>Move a character forward</entry></row>
+         <row><entry><option>Ctrl+e</option></entry><entry>Move to end of line</entry></row>
+         <row><entry><option>Ctrl+p</option></entry><entry>Move a previous line</entry></row>
+         <row><entry><option>Ctrl+n</option></entry><entry>Move a next line</entry></row>
+         <row><entry><option>Ctrl+h</option></entry><entry>Delete a character backward</entry></row>
+         <row><entry><option>Ctrl+d</option></entry><entry>Delete a character forward</entry></row>
+         <row><entry><option>Ctrl+u</option></entry><entry>Delete line</entry></row>
+         <row><entry><option>Ctrl+k</option></entry><entry>Delete to end of line</entry></row>
+         <row><entry><option>Ctrl+l</option></entry><entry>Wrap current paragraph</entry></row>
+         <row><entry><option>Ctrl+Alt+l</option></entry><entry>Wrap all long lines</entry></row>
+         <row><entry><option>Shift+Ctrl+l</option></entry><entry>Toggle auto wrapping</entry></row>
+         <row><entry><option>Shift+Ctrl+x</option></entry><entry>Edit with external editor</entry></row>
+         <row><entry><option>Shift+Ctrl+a</option></entry><entry>Open address book</entry></row>
+      </tbody>
+     </tgroup>
+    </informaltable>
   </section>
 
 </appendix>