path: root/help/C/menuref.xml

<!--
<!DOCTYPE Appendix PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.1//EN">
-->

<appendix id="menuref">
  <title>Quick Reference</title>
  <para>
      You might want to copy this section and tape it to the wall
      next to your computer: it's a very short summary of most of
      the things you'll want to do with
      <application>Ximian Evolution</application>.
   </para>


<note id="shortcuts">
<title>Custom Keyboard Shortcuts</title>
<para>
   As of GNOME 2.0, custom keyboard shortcuts lose out to keyboard
  shortcuts as defined in application menus. For example, even if you have
  chosen Emacs-style keybindings, the
<keycombo>
<keycap>Ctrl</keycap>
<keycap>A</keycap>
</keycombo> shortcut
select the entire message (as noted in in
<menuchoice><guimenu>Edit</guimenu><guimenuitem>Select
All</guimenuitem></menuchoice>), not go to the beginning of a line, as it would in Emacs.
 </para>

 <para>
   Keybindings that are not overridden by menu definitions are not affected. For example, 
   <keycombo action="simul">
    <keycap>Ctrl</keycap>
    <keycap>K</keycap>
  </keycombo>
  still acts as "cut line."
</para>

<para>
  To change keybinding settings, select
  <menuchoice><guimenu>System</guimenu><guimenuitem>Personal
  Settings</guimenuitem></menuchoice>
  from your menu panel and double-click the
<guiicon>Shortcuts</guiicon> icon.
</para>

</note>


<sect1 id="commandline">
  <title>Command Line Options</title>
  <para>
    Evolution is primarily a graphical (GUI) tool, but it has a few
    command-line flags and options you may want to use. 
  </para>

    <variablelist>
      <varlistentry>
        <term>Force Evolution to Quit</term>
        <listitem>
          <para>
            Earlier versions of Evolution shipped with a "killev"
            script to halt all Evolution processes. Evolution 1.4 uses
            the --force-shutdown flag instead. If Evolution has
            stopped responding, try runing the command <command>evolution-1.4
          --force-shutdown</command>.
          </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>Handling Mailto Links with a Subject</term>
        <listitem>
          <para>
            Evolution handles mailto links from browsers. If you use
            Galeon, you can set the mail handler by selecting
            <menuchoice><guimenu>System</guimenu><guimenuitem>Personal
            Preferences</guimenuitem></menuchoice> and double-clicking the <guiicon>File
            Associations</guiicon> icon.
          </para>
          <para>
            For other browsers or applications, enter your custom
            email handler as the command <userinput>evolution-1.4 "%s"</userinput> </para>
          <para>
            To create a preformed subject, enter the command like so:
            <command>evolution-1.4 mailto:address@isp.com?subject="Subject of Message"</command>
          </para>
        </listitem>
      </varlistentry>
                 


      <varlistentry>
        <term>  Disable splash screen</term>
        <listitem>
          <para>
            If you dislike the splash screen, add the flag
            <userinput>--no-splash.</userinput>
          </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>Start Online or Offline</term>
        <listitem>
          <para>
            To start in online mode or in offline mode, add the <userinput>--offline</userinput>
          or  <userinput>--online</userinput> flag to the command line.
          </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>Capture Debugging Output</term>
        <listitem>
          <para> 
          To gather debugging information for a bug report, run
          Evolution with the flag
          <userinput>--debug=filename.txt</userinput>.  All debugging output
          will go to the file name you choose.
          </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>Additional Command Line Help</term>
        <listitem>
          <para>
            Run <command>evolution --help</command> or
          <command>evolution -?</command> to get a long listing of
          additional options, most of which are available for all GNOME
          applications. To get a short syntax summary, run the command
          <command>evolution-1.4 --usage</command>.
          </para>
        </listitem>
      </varlistentry>
    </variablelist>

</sect1>


  <sect1 id="quickref-open">
      <title>Opening or Creating Anything</title>
      <para>
          <variablelist>


      <varlistentry>
        <term>New Item:</term>
        <listitem>
          <para>
                Press <keycombo action="simul"> <keycap>Ctrl</keycap>
          <keycap>N</keycap> </keycombo> to open a new item
          for whatever part of <application>Ximian
          Evolution</application> you're working on. In mail,
          that means you'll create a new message. If you're
          looking at your addressbook, <keycombo
          action="simul"> <keycap>Ctrl</keycap>
          <keycap>N</keycap> </keycombo> creates a new contact
          card, and in the calendar, a new appointment.
                </para>
        </listitem>
      </varlistentry>


      <varlistentry>
        <term>Create a new folder:</term>
        <listitem>
          <para>
                <menuchoice><guimenu>File</guimenu><guisubmenu>New</guisubmenu>
                <guimenuitem>Folder</guimenuitem></menuchoice> or
                <keycombo action="simul">
          <keycap>Ctrl</keycap>
          <keycap>Shift </keycap>
          <keycap>E</keycap>
                </keycombo>
                </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>Create a new Shortcut in the Evolution Bar:</term>
        <listitem>
          <para>       
                  <menuchoice><guimenu>File</guimenu>
          <guisubmenu>New</guisubmenu>
          <guimenuitem>Shortcut</guimenuitem> </menuchoice> or 
                <keycombo action="simul">
          <keycap>Ctrl</keycap>
          <keycap>Shift</keycap>
          <keycap>S</keycap>
                </keycombo>
                </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>Create a new email message:</term>
        <listitem>
          <para>
                Use
                <menuchoice><guimenu>File</guimenu><guisubmenu>New</guisubmenu><guimenuitem>Mail
                Message</guimenuitem>  </menuchoice> or 
                <keycombo action="simul">
          <keycap>Ctrl</keycap>
          <keycap>Shift </keycap>
          <keycap>M</keycap>
                </keycombo>
              </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>Create a new Appointment:</term>
        <listitem>
          <para>       
                  <menuchoice><guimenu>File</guimenu>
          <guisubmenu>New</guisubmenu>
          <guimenuitem>Appointment</guimenuitem> </menuchoice>  or 
                <keycombo action="simul">
          <keycap>Ctrl</keycap>
          <keycap>Shift</keycap>
          <keycap>A</keycap>
                </keycombo>
                </para>
        </listitem>
      </varlistentry>


      <varlistentry>
        <term>Enter a new Contact:</term>
        <listitem>
          <para>       
                  Double-click in any blank space in the contact
                  manager to create a new address card.  You can also
                  use 
                 <menuchoice><guimenu>File</guimenu>
          <guisubmenu>New</guisubmenu>
          <guimenuitem>Contact</guimenuitem> </menuchoice>  or 
                <keycombo action="simul">
          <keycap>Ctrl</keycap>
          <keycap>Shift</keycap>
          <keycap>C</keycap>
                </keycombo>
                </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>Create a new Task:</term>
        <listitem>
          <para>       
                  <menuchoice><guimenu>File</guimenu>
          <guisubmenu>New</guisubmenu>
          <guimenuitem>Task</guimenuitem>  </menuchoice> or 
                <keycombo action="simul">
          <keycap>Ctrl</keycap>
          <keycap>Shift</keycap>
          <keycap>T</keycap>
                </keycombo>
                </para>
        </listitem>
      </varlistentry>
    </variablelist>
      </para>
    </sect1> 
    <sect1 id="quickref-mail">
      <title>Mail Tasks</title>
      <para>
        Here are the most frequent email tasks, and shortcuts for
        navigating your mailbox with the keyboard instead of the
        mouse:
         <variablelist>

  
        <varlistentry>
        <term>Send and Receive Mail:</term>
        <listitem>
          <para>
                Press <keycap>F9</keycap>, click the
                <guibutton>Send/Receive</guibutton> button in the
                toolbar, or choose
                <menuchoice><guimenu>Actions</guimenu> 
                 <guimenuitem>Send/Receive</guimenuitem></menuchoice>.
                </para>
        </listitem>
      </varlistentry>
        <varlistentry>
        <term>Navigating the Message List with the Keyboard:</term>
        <listitem>
          <para>
                Press <keycap>]</keycap> or <keycap>.</keycap> to jump to the next unread
                message. <keycap>[</keycap> or <keycap>,</keycap> goes to the previous
                unread message.  Use the arrow keys to move up
                and down along the list of all messages.
                </para>
        </listitem>
      </varlistentry>

          <varlistentry>
        <term>Move the display up and down in the preview pane:</term>
        <listitem>
          <para>
                Press the space bar to go a page down.  Press
                <keycap>Backspace</keycap> to go a page up.
                </para>
        </listitem>
      </varlistentry>

          <varlistentry>
        <term>Reply to a Message:</term>
        <listitem>
          <para>
                To reply to the sender of the message only:
                click <guibutton>Reply</guibutton> in the
                toolbar, or press
                <keycombo action="simul">
          <keycap>Ctrl</keycap>
          <keycap>R</keycap>
                </keycombo>
                </para>
          <para>
                To reply to the sender and all the other visible
                recipients of the message, click <guibutton>Reply to
                All</guibutton> or select the message and press
                <keycombo action="simul">
          <keycap>Shift</keycap>
          <keycap>Ctrl</keycap>
          <keycap>R</keycap>
                </keycombo>
              </para>
        </listitem>
      </varlistentry>
      
          <varlistentry>
        <term>Forward a Message:</term>
        <listitem>
          <para>
                Select the message or messages you want to forward,
                and click <guibutton>Forward</guibutton> in the
                toolbar, or press
                <keycombo action="simul">
          <keycap>Ctrl</keycap>
          <keycap>F</keycap>
                </keycombo>
                </para>
        </listitem>
      </varlistentry>

          <varlistentry>
        <term>Open a Message in a New Window:</term>
        <listitem>
          <para>
                Double-click the message you want to view, or select
                it and press <keycap>Return</keycap>
                <keycombo action="simul">
          <keycap>Ctrl</keycap>
          <keycap>O</keycap>
                </keycombo>
          </para>
        </listitem>
      </varlistentry>
      
          <varlistentry>
        <term>Create Filters and Virtual Folders:</term>
        <listitem>
          <para>
                Right-click on a message and select
                <guimenuitem>Create Rule From
                Message</guimenuitem>. You can also create filters and
                virtual folders in the <guimenu>Tools</guimenu> menu.
          </para>
        </listitem>
      </varlistentry>


          <varlistentry>
        <term>Add Sender to Address Book:</term>
        <listitem>
          <para>
                Right-click on a message and select <guimenuitem>Add
                Sender to Address Book</guimenuitem>.  You can also
                right-click on any email address to add it to your
                address book.
          </para>
        </listitem>
      </varlistentry>
    </variablelist>
    


      </para>
    </sect1>
    <sect1 id="quickref-cal">
      <title>Calendar</title>
      <para>
        <variablelist>

      <varlistentry>
        <term>Create a new Appointment:</term>
        <listitem>
          <para>       
                  <menuchoice><guimenu>File</guimenu>
          <guisubmenu>New</guisubmenu>
          <guimenuitem>Appointment</guimenuitem> </menuchoice>  or 
                <keycombo action="simul">
          <keycap>Ctrl</keycap>
          <keycap>Shift</keycap>
          <keycap>A</keycap>
                </keycombo>
                </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>Create a new Task:</term>
        <listitem>
          <para>       
                  <menuchoice><guimenu>File</guimenu>
          <guisubmenu>New</guisubmenu>
          <guimenuitem>Task</guimenuitem>  </menuchoice> or 
                <keycombo action="simul">
          <keycap>Ctrl</keycap>
          <keycap>Shift</keycap>
          <keycap>T</keycap>
                </keycombo>
                </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term></term>
        <listitem>
          <para>
        <tip id="new-appt">
          <title>New Appointments Fast</title>
          <para>
            Click on any blank spot in the calendar and start
            typing to create a new appointment entry.
          </para>
        </tip>
          </para>
        </listitem>
        </varlistentry>
      </variablelist>

        </para>
  </sect1>
    <sect1 id="quickref-contact">
        <title>Addressbook</title>
        <para>
    Here are shortcuts for the most frequent addressbook actions:
        <variablelist>
      <varlistentry>
        <term>Edit a Contact:</term>
        <listitem>
          <para>
        You can edit a contact two ways:
        <itemizedlist>
          <listitem>
            <para>
              Click once on the person's address card and you can
              edit the person's properties all in the same window.
            </para>
          </listitem>
          <listitem>
            <para>
              Double-click on the contact's card and alter their details.
            </para>
          </listitem>
        </itemizedlist>
               </para>
        </listitem>
        </varlistentry>
      </variablelist>
    
    <variablelist>
      <varlistentry>
        <term>Deleting a Contact:</term>
        <listitem>
          <para>
        Right click on a contact and click <guilabel>Delete</guilabel>
        or select a contact and press the <guibutton>Delete</guibutton>
        on the toolbar.
          </para>
        </listitem>
      </varlistentry>
    </variablelist>
    
    
        <variablelist>
      <varlistentry>
        <term>Email a Contact:</term>
        <listitem>
          <para>
        Right click on a contact and select 
        <guilabel>Send message to contact</guilabel>.
               </para>
        </listitem>
      </varlistentry>
    </variablelist>
    
        <variablelist>
      <varlistentry>
        <term>Creating a New Contact:</term>
        <listitem>
          <para>
                  Double-click in any blank space in the contact
                  manager to create a new address card.  You can also
                  use <menuchoice><guimenu>File</guimenu>
                  <guisubmenu>New</guisubmenu>
                  <guimenuitem>Contact</guimenuitem> </menuchoice> or
                <keycombo action="simul">
          <keycap>Ctrl</keycap>
          <keycap>Shift</keycap>
          <keycap>C</keycap>
                </keycombo>
          </para>
        </listitem>
      </varlistentry>
    </variablelist>
      </para>
  </sect1>
</appendix>