add support for Ayatana indicator to Notification plugin

[claws.git] / manual / en / keyboard.xml

<?xml version="1.0" encoding="utf-8"?>
<appendix id="ap_keyboard">
<title>Default keyboard shortcuts</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>
          <row><entry><option>Ctrl+F12</option></entry><entry>Toggles menu bar visibility</entry></row>
          <row><entry><option>Ctrl+&lt;wheel-&uarr;&gt;</option></entry>
                <entry>When focused on message view, increases displayed font size.</entry></row>
          <row><entry><option>Ctrl+&lt;wheel-&darr;&gt;</option></entry>
                <entry>When focused on message view, decreases displayed font size.</entry></row>
        </tbody>
      </tgroup>
    </informaltable>
  </section>

  <section id="keyb_compose">
    <title>Compose 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+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>