Contact lists.

2001-09-10  Aaron Weber  <aaron@ximian.com>

	* C/usage-contact.sgml: Contact lists.

	* C/usage-mail.sgml: Contact Lists.

	* C/menuref.sgml: Verified and Corrected.

svn path=/trunk/; revision=12762

4 files changed, 168 insertions, 59 deletions

diff --git a/help/C/config-sync.sgml b/help/C/config-sync.sgml
index 8f3b30d1f0..b2b2fe6cd5 100644
--- a/help/C/config-sync.sgml
+++ b/help/C/config-sync.sgml
@@ -15,7 +15,6 @@
            want.
           </member>
         </simplelist>
-
     </para>
 
     <para>
@@ -28,8 +27,7 @@
        <guilabel>Pilot Conduits</guilabel> section of the Control
        Center.
   </para>
-  
-  <para>
+    <para>
         Once your computer and your Palm-OS device are talking happily
         to each other, you'll have to decide what exactly you want
         them to do with the data they exchange.  To enable a conduit, click the
@@ -39,7 +37,7 @@
 
         <variablelist>
          <varlistentry>
-            <term>Disabled </term>
+            <term>Disabled</term>
             <listitem> 
                <para>
                   Do nothing.
diff --git a/help/C/menuref.sgml b/help/C/menuref.sgml
index e053f3250d..fca576d52c 100644
--- a/help/C/menuref.sgml
+++ b/help/C/menuref.sgml
@@ -11,20 +11,31 @@
       <application>Ximian Evolution</application>.
    </para>
 
-<!--  Put this in a note somewhere
-  <para>
-    Menus in <application>Evolution</application> are
-    context-sensitive, which means that they vary depending on what
-    you're doing.  If you're reading your mail, you'll have
-    mail-related menus; for your calendar, you'll have
-    calendar-related menu items.  Some menus, of course, like
-    <guimenu>Help</guimenu> and <guimenu>File</guimenu> don't much, if
-    at all, because they have more universal functions.  But you'd
-    never mark an address card as "read," or set the recurrence for an
-    email message you've recieved. depending on whether you're looking
-    at mail, contacts, or calendar information. 
-  </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>
@@ -39,7 +50,7 @@
                 <keycombo action="simul">
 		  <keycap>Ctrl</keycap>
 		  <keycap>Shift </keycap>
-		  <keycap>F</keycap>
+		  <keycap>E</keycap>
                 </keycombo>
                 </para>
 	    </listitem>
@@ -98,7 +109,10 @@
 	    <term>Enter a new Contact</term>
 	    <listitem>
 	      <para>       
-                  <menuchoice><guimenu>File</guimenu>
+                  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">
@@ -110,7 +124,6 @@
 	    </listitem>
 	  </varlistentry>
 
-
 	  <varlistentry>
 	    <term>Create a new Task</term>
 	    <listitem>
@@ -126,7 +139,6 @@
                 </para>
 	    </listitem>
 	  </varlistentry>
-
 	</variablelist>
       </para>
     </sect1> 
@@ -218,18 +230,34 @@
 	    <term>Create Filters and Virtual Folders</term>
 	    <listitem>
 	      <para>
-                Right-click on a message and select "Create Rule..."
-                menu items. You can also create filters and virtual
-                folders in the <guimenu>Tools</guimenu> menu.
+                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>Address Book</title>
+      <title>Calendar</title>
       <para>
         <variablelist>
 	  <varlistentry>
@@ -239,7 +267,8 @@
 		<tip id="new-appt">
 		  <title>New Appointments Fast</title>
 		  <para>
-		    Double-click in a blank space to create a new contact.
+		    Click on any blank spot in the calendar and start
+		    typing to create a new appointment entry.
 		  </para>
 		</tip>
 	      </para>
@@ -308,9 +337,19 @@
 	
         <variablelist>
 	  <varlistentry>
-	    <term></term>
+	    <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>
diff --git a/help/C/usage-contact.sgml b/help/C/usage-contact.sgml
index 80c438283d..6fcf6afd46 100644
--- a/help/C/usage-contact.sgml
+++ b/help/C/usage-contact.sgml
@@ -1,6 +1,4 @@
-<!--
 <!DOCTYPE Chapter PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.1//EN">
--->
 
 <chapter id="usage-contact">
   <title>Working with Your Contacts</title>
@@ -17,29 +15,19 @@
        The toolbar for the address book is quite simple.
        <itemizedlist>
 	<listitem><para>
-           Click <guibutton>New</guibutton> to create a new card, or double-click 
+           Click <guibutton>New Contact</guibutton> to create a new card, or double-click 
            in a blank space in the contact list. 
 	</para></listitem>
 
 	<listitem><para>
-           <guibutton>Find</guibutton> brings up an in-depth search window.
-         </para></listitem>
-	
-	<listitem><para>
-	    <guibutton>Print</guibutton> sends one or more of your cards to the printer.
+           Click <guibutton>New List</guibutton> to create a new card, or double-click 
+           in a blank space in the contact list. 
 	</para></listitem>
-        <listitem><para>
-           <guibutton>Delete</guibutton> deletes a selected card.
-        </para></listitem>
-
-        <listitem><para> <guibutton>View All</guibutton> displays all
-           the address information in the folder.  Use this button to
-           refresh the display for a network folder, or to switch from
-           viewing the results of a search and see all your contacts.
-	    <!-- Lets xref to search feature -->
-           </para></listitem>
-
-        <listitem><para> <guibutton>Stop</guibutton> stops loading
+
+	<listitem><para> The <guiicon>printer</guiicon> icon sends one
+	    or more of your cards to the printer.  </para></listitem>
+
+        <listitem><para> The <guiicon>stop sign</guiicon> icon stops loading
            contact data from the network.  This button is only
            relevant if you are looking at contact information on a
            network.  </para></listitem>
@@ -189,13 +177,14 @@
 	  <term>Multiple Values for Fields</term>
             <listitem>
 	      <para>
-                If you click on the small arrow buttons next to the
-                <guilabel>Primary Email</guilabel> field, you can also
-                choose <guilabel>Email 2</guilabel> and
+                If you click on the downward pointing triangle buttons
+                next to the <guilabel>Primary Email</guilabel> field,
+                you can also choose <guilabel>Email 2</guilabel> and
                 <guilabel>Email 3</guilabel>.  Although the contact
                 editor will only display one of those at any given
-                time, <application>Evolution</application> will
-                store them all.  The arrow buttons next to the
+                time, <application>Evolution</application> will store
+                them all.  Entries that have information in them have
+                a check mark next to them.  The buttons next to the
                 telephone and postal address fields work in the same
                 way.
               </para>
@@ -370,7 +359,9 @@
          to organize your cards.  The first way is to use folders;
          this works the same way mail folders do.  For more
          flexibility, you can also mark contacts as elements of
-         different categories.
+         different categories.  To better integrate with email tools,
+         you can also create lists of contacts that you can send mail
+         to as a single person.
       </para>
 
       <sect3 id="usage-contact-organize-group-folder">
@@ -432,6 +423,72 @@
        -->
 
       </sect3>
+
+      <sect3 id="usage-contact-organize-group-list">
+	<title>Creating a List of Contacts</title>
+	<para>
+           To create a list of contacts:
+
+         <orderedlist numeration="arabic">
+	    <listitem>
+	      <para>
+                Open the list creation dialog box by clicking the
+                <guibutton>New List</guibutton> button or selecting
+                 <menuchoice>
+		  <guimenu>
+                     File
+                  </guimenu>
+		  <guisubmenu>
+                      New
+                   </guisubmenu>
+		   <guimenuitem>
+                     Contact List
+                   </guimenuitem>
+		</menuchoice>.
+               </para>
+	    </listitem>
+
+	    <listitem>
+	      <para>
+                Enter a name for the list.
+              </para>
+	    </listitem>
+	    <listitem>
+	      <para>
+                Enter names or email addresses of contacts, or just
+	        drag contacts from the main window into the list.
+              </para>
+	    </listitem>
+
+	    <listitem>
+	      <para>
+                 Choose whether you would like to hide the email
+                 addresses when you send a message to the list.
+                 Unless it is a very small list, it is recommended
+                 that you leave the addresses hidden.  This is the
+                 same thing as using the "Bcc:" feature discussed in
+                 <xref linkend="usage-mail-getnsend-send-to-types">.
+              </para>
+	    </listitem>
+
+	  </orderedlist>
+	<para>
+           When you are done, click <guibutton>OK</guibutton>. The
+           list will appear as a contact card, which you can use as
+           you would any other. That includes emailing the list to
+           another person, and, of course, sending email to the list.
+        </para>
+	<para>
+           To mail the list, open a new email and type the name you
+           chose for the list. Ximian Evolution will address the
+           message to the entire list when you send it. You can also
+           right-click on the list's address card in the Contact
+           Manager and select <guimenuitem>Send Message to
+           List</guimenuitem>,
+        <para>
+      </sect3>
+
+
     </sect2>
   </sect1>
   
diff --git a/help/C/usage-mail.sgml b/help/C/usage-mail.sgml
index 434198da93..36fe9b39ad 100644
--- a/help/C/usage-mail.sgml
+++ b/help/C/usage-mail.sgml
@@ -14,9 +14,10 @@
   <note>
     <title>If you use IMAP Mail</title>
     <para>
-      If you chose IMAP mail during the setup process, you must subscribe to
-      your mail folders before you can read mail in them. Read <xref
-								     linkend="usage-mail-subscriptions"> to find out how.
+      If you chose IMAP mail during the setup process, you must
+      subscribe to your mail folders before you can read mail in
+      them. Read <xref linkend="usage-mail-subscriptions"> to find out
+      how.
     </para>
   </note>
   
@@ -496,7 +497,9 @@
            "Send Later" feature is particularly useful if you use a
            modem to connect to the Internet and pay per-minute
            charges: you can remain offline until you need to send
-           mail, then connect and send all your mail at once.  Mail in the outbox is sent when you click <guibutton>Send/Recieve</guibutton> in the main window.
+           mail, then connect and send all your mail at once.  Mail in
+           the outbox is sent when you click
+           <guibutton>Send/Recieve</guibutton> in the main window.
         </para>
         <para>
            To learn more about how you can specify message queue and
@@ -629,6 +632,15 @@
 	    </menuchoice>.
 		
           </para>
+
+         <para>
+           If you frequently write email to the same groups of people,
+           you can create address lists in the Contact Manager, and
+           then send them mail as though they had a single address.
+           To learn how to do that, read <xref
+           linkend="usage-contact-organize-group-list">.
+        </para>
+
         </sect3>
 
         <sect3 id="usage-mail-getnsend-send-to">
@@ -1435,7 +1447,10 @@ with quoted materials and the relevant replies interspersed-->
 
             <listitem>
               <para>
-               Check your spelling and use complete sentences.
+               Check your spelling and use complete sentences. By
+               default, <application>Evolution</application> will put
+               a red line beneath words it doesn't recognize, as you
+               type them.
               </para>
             </listitem>