2011-08-30 [colin] 3.7.10cvs8
[claws.git] / manual / keyboard.xml
index 0dedc6b..4110d92 100644 (file)
@@ -4,15 +4,37 @@
 
   <section id="keyb_general">
     <title>Motivations and general conventions</title>
-    <para>Although Sylpheed-Claws is a graphical application and can be mainly commanded with your preferred point-and-click device, it also requires to use the keyboard frequently. Composing mail is the most common of this keyboard requiring tasks, and there's people who writes lots of mails. Moving hands appart from keyboard greatly reduces productivity for these people, so Sylpheed-Claws tries to provide keyboard shortcuts to allow faster operation.
+    <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: providing keyboard alternatives and keyboard navigation also enables people with disabilities (who may not be able to properly control a pointing device) to use Sylpheed-Claws.
+    <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. Dialogs or windows opened on top of Sylpheed-Claws' main window can be closed by hitting <option>Esc</option> key.
+    <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 who are assigned by default to options on menus. We won't list these here, as they are already shown on the right side of the menus themselves, so you can easly learn them with the usage. Furthermore, if you don't like them, these shortcuts can be changed on the fly, just by positioning the focus on the menu option and pressing the desired key combination (but only for combinations of keys and Alt, Ctrl and Shift mofifier keys, single keys cannot be assigned)<footnote label="1"><para>This is a standard behaviour of GTK2 library based programs like Sylpheed-Claws. Notice that this behaviour may also appear disabled by default on some desktops.</para></footnote>.
+    <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>Appart from these shortcuts there are others which vary from window to window, which are sumarized in the following sections.
+    <para>
+       In addition to these shortcuts there are others which vary from window 
+       to window, which are summarised in the following sections.
     </para>
   </section>
 
     <informaltable frame="topbot">
       <tgroup cols="2">
         <colspec colwidth="*" />
-        <colspec colwidth="7*" />
+        <colspec colwidth="4*" />
        <thead>
           <row><entry>Shortcut</entry><entry></entry></row>
        </thead>
         <tbody>
-          <row><entry><option>n</option></entry><entry>Goes to next mail in summaryview. The <option>Up</option> arrow does the same.</entry></row>
-          <row><entry><option>p</option></entry><entry>Goes to previous mail. The <option>Down</option> arrow is a synonym.</entry></row>
-         <row><entry><option>Shift+n</option></entry><entry>Goes to next unread mail.</entry></row>
-          <row><entry><option>Shift+p</option></entry><entry>Goes to previous unread mail.</entry></row>
-         <row><entry><option>v</option></entry><entry>Toggles the message view panel visibility. When invisible, summary view expands itself to fill the full window height and more summary lines are displayed.</entry></row>
+         <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 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>