All sgml files replaced with xml files. XML files validated. Two new XML

2002-11-04  Aaron Weber  <aaron@ximian.com>

	* C/*.sgml: All sgml files replaced with xml files. XML files
	validated. Two new XML files added: apx-fdl.xml and legal.xml

	* C/evolution-C.omf: Altered to fit the GDP template. This may now
	work with the GNOME 2.0 DTD, although I could be wrong.

	* sgmldocs.make: removed and replaced with xmldocs.make. This will
	break all translations until they are also ported to XML. I will
	probably begin doing that tomorrow, since it's just markup and not
	language stuff.

	* C/Makefile.am: added two files to the list. Does this
	Makefile get included in another, somewhere, or is it just
	detected?

svn path=/trunk/; revision=18538

1 files changed, 421 insertions, 0 deletions

diff --git a/help/C/menuref.xml b/help/C/menuref.xml
new file mode 100644
index 0000000000..bb1eccf994
--- /dev/null
+++ b/help/C/menuref.xml
@@ -0,0 +1,421 @@
+<!--
+<!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>
+  If you have set custom keyboard shortcuts for your desktop, (you can
+   do this the control center: select
+   <menuchoice><guimenu>System</guimenu><guimenuitem>Settings</guimenuitem></menuchoice>
+   from your menu panel), they may interfere with Evolution keyboard
+   shortcuts.
+</para>
+<para>
+   For example, if you have chosen Emacs-style key bindings for your
+   desktop-wide text editor, the shortcut
+   <keycombo action="simul">
+    <keycap>Ctrl</keycap>
+    <keycap>W</keycap>
+  </keycombo>
+  will act as "Cut region" rather than as "Close Window" in the
+  message composer.
+</para>
+</note>
+
+
+
+
+  <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>Evolution Bar 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 <guilabel>toolbar</guilabel>.
+	      </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>
\ No newline at end of file