2011-08-30 [colin] 3.7.10cvs8
[claws.git] / manual / keyboard.xml
index 3d4c8fb..4110d92 100644 (file)
@@ -4,15 +4,37 @@
 
   <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>
+       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>
+       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>
+       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, but only for key combinations that include the <option>Alt</option>, <option>Ctrl</option> and/or <option>Shift</option> modifier keys; single keys cannot be assigned. (This is a standard behaviour of GTK2 library based programs like Claws Mail. Note that this behaviour may be disabled by default on some desktops.)
+    <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>
+       In addition to these shortcuts there are others which vary from window 
+       to window, which are summarised in the following sections.
     </para>
   </section>
 
          <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>Goes to next mail in Message List. The <option>Down</option> arrow does the same.</entry></row>
-          <row><entry><option>p</option></entry><entry>Goes to previous mail. The <option>Up</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>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>