mention the full-advantage section and the exchange features. Expand

2002-01-07  Aaron Weber  <aaron@ximian.com>

	* C/usage-calendar.sgml: mention the full-advantage section and
	the exchange features. Expand mention of "autopick" and general
	polish on the appointment-scheduling and peer-to-peer groupware
	functions.

	* C/usage-exchange.sgml: Fix and expand as per Danw's notes about
	Features that need to be documented.

svn path=/trunk/; revision=15260

2 files changed, 90 insertions, 35 deletions

diff --git a/help/C/usage-calendar.sgml b/help/C/usage-calendar.sgml
index 23c13bea3d..05f5e8e3d8 100644
--- a/help/C/usage-calendar.sgml
+++ b/help/C/usage-calendar.sgml
@@ -37,14 +37,15 @@
 	  </para>
 	</listitem>
       </itemizedlist>
-
+</para>
+<para>
       Press the calendar-shaped buttons on the right side of the toolbar to
       switch between views. 
-
-      You can also select a range of
-      days&mdash; three days, ten days, or a fortnight if you want
-      &mdash; in the small calendar at the upper right.  To do this, simply click and drag on the days that you wish to view in your calendar.
-
+</para>
+<para>
+      You can also select an arbitrary range of days in the small
+      calendar at the upper right.  To do this, click and drag on the
+      days that you wish to view in your calendar.
     </para>
     <para>
        The <guibutton>Prev</guibutton> and <guibutton>Next</guibutton>
@@ -67,7 +68,12 @@
     <para>
       Of course, you'll want to use the calendar to do more than find
       out what day it is. This section will tell you how to schedule
-      appointments, set alarms, and determine appointment recurrence.
+      appointments, set alarms, and determine appointment
+      recurrence. If you have installed the Ximian Connector for
+      Microsoft Exchange, you can also read <xref
+      linkend="full-advantage"> to learn about how to take full
+      advantage of the collaborative group scheduling functions
+      available on the Microsoft Exchange Server.
     </para>
 
     <sect2 id="usage-calendar-apts-basic">
@@ -108,7 +114,10 @@
         multiple columns in the day view of the calendar.
       </para>
       <para>
-	<application>Evolution</application> supports the use of timezones.  If you share calendar files with friends or co-workers, it is quite possible you will need to configure your timezone.  To configure your timezone:
+	<application>Evolution</application> supports the use of
+	timezones.  If you share calendar files with friends or
+	co-workers, it is quite possible you will need to configure
+	your timezone.  To configure your timezone:
 	<orderedlist numeration="arabic">
 	  <listitem>
 	    <para>
@@ -121,7 +130,9 @@
 	  </listitem>
 	  <listitem>
 	    <para>
-	      Click the <guibutton>Globe</guibutton> button in the <guilabel>Time</guilabel> section, located in the <guilabel>General</guilabel> tab.
+	      Click the <guibutton>Globe</guibutton> button in the
+	      <guilabel>Time</guilabel> section, located in the
+	      <guilabel>General</guilabel> tab.
 	    </para>
 	  </listitem>
 	  <listitem>
@@ -132,7 +143,14 @@
 	</orderedlist>
       </para>
       <para>
-	You can also configure timezone information specific to Start and End time in each appointment.  To do that, simply create a new appointment and click on a globe to customize the timezone that the time exists in.
+	You can also configure timezone information specific to the
+	Start and End time in each appointment.  To do that, simply
+	create a new appointment and click on a globe to customize the
+	timezone that the time exists in. For example, if you live in
+	New York but have a telephone meeting set for noon with
+	someone in California, you need to make sure that you're not
+	calling each other a few hours off.  Setting time-zones on a
+	per-appointment basis helps avoid that potential confusion.
       </para>
       <note>
        <title>Multiple Simultanious Appointments</title>
@@ -191,10 +209,15 @@
          higher level.
       </para>
       <para>
-	<application>Evolution</application> can handle not only time that you're busy, but free time. This can be useful if you're on a network sharing calendar files.  You can easily compare schedules with other people, allowing easy setup of a RSVP.
+	<application>Evolution</application> can handle not only time
+	that you're busy, but free time. This can be useful if you're
+	on a network sharing calendar files.  You can easily compare
+	schedules with other people, allowing easy setup of a RSVP.
       </para>
       <para>
-	To set your appointment to be free or busy, simply click the box in the <guilabel>Show Time As</guilabel> section in the <guilabel>Appointment Editor</guilabel>.
+	To set your appointment to be free or busy, simply click the
+	box in the <guilabel>Show Time As</guilabel> section in the
+	<guilabel>Appointment Editor</guilabel>.
       </para>
       <para>
         <application>Evolution</application> lets you categorize your
@@ -421,7 +444,9 @@
       <para>
 	<application>Evolution</application> has a Free/Busy window so
 	that you can view people's schedules together to help you
-	schedule appointments.
+	schedule appointments. Read <xref linkend="full-advantage"> to
+	learn about how to use this feature with the Ximian Connector
+	for Microsoft Exchange.
       </para>
       <para>
 	To access the free/busy view:
@@ -449,9 +474,9 @@
 	</orderedlist>
       </para>
       <figure>
-        <title>Threaded Mail View</title>
+        <title>Appointment Scheduing Window</title>
 	<screenshot>
-	  <screeninfo>Threaded Mail View</screeninfo>
+	  <screeninfo>Appointment Scheduling Window</screeninfo>
 	  <mediaobject><imageobject>
 	      <imagedata  format="png" fileref="figures/freebusy"
 	  srccredit="Kevin Breit">
@@ -501,13 +526,28 @@
 	<title>Scheduling an Appointment</title>
 	<para>
 	  To schedule an appointment, you'll first need people's
-	  free/busy information.  Once you have recieved people's
-	  schedule information, integrate it with your calendar. 
-	  <!-- Describe how to integrate -->
-	  In the <guilabel>Scheduling</guilabel> tab, you'll see the
-	  pending appointment time in white with bold black borders.
-	  You should also see the invitee's free/busy schedules. 
+	  free/busy information.  If you're using the Ximian Connector
+	  for Microsoft Exchange, all of the information is already
+	  available to you in the Global Address List. Otherwise, each
+	  person will have to email you their schedule files and you
+	  will have to incorporate them into your calendar.
+        </para>
+        <para>
+          Regardless of how you get the information, Ximian Evolution
+          will display it in the <guilabel>Scheduling</guilabel> tab.
+          The pending appointment time will appear in white with bold
+          black borders.  Each attendee's free and busy times appear
+          color-coded next to their names in the attendee list.
 	</para>
+        <para>
+          Adjust the meeting time, either by dragging the meeting
+          borders or by using the <guilabel>Autopick</guilabel>
+          buttons to choose a time automatically, then click
+          <guibutton>Save and Close</guibutton>.  Attendees on an
+          Exchange server will have the appointment updated
+          automatically; others will receive email notification of any
+          change in plans.
+        </para>
       </sect3>
     </sect2>
   </sect1>
diff --git a/help/C/usage-exchange.sgml b/help/C/usage-exchange.sgml
index 76232c7cdd..05020d6ca3 100644
--- a/help/C/usage-exchange.sgml
+++ b/help/C/usage-exchange.sgml
@@ -437,32 +437,33 @@ There are, however, some features which are not available:
           it, every card will appear.
         </para>
       </tip>
-    <para>
-      In addition, when you schedule a meeting with your calendar on
-      the <application>Exchange</application>server, you can check
-      when other local Exchange users are busy according to their
-      <application>Exchange</application>calendars. To do so:
+    </sect1>
+    <sect1 id="full-advantage">
+      <title>Taking Full Advantage of the Exchange Server When Scheduling Appointments</title>
+      <para>
+        When you schedule a meeting with your calendar on the
+        <application>Exchange</application>server, you can check when
+        other local Exchange users are busy according to their
+        <application>Exchange</application>calendars. To do so:
       <orderedlist numeration="arabic">
 	<listitem>
 	  <para>
             Open a new appointment in the calendar.
           </para>
 	</listitem>
-
 	<listitem>
 	  <para> Choose <menuchoice> <guimenu>Actions</guimenu>
 	      <guimenuitem>Schedule Meeting</guimenuitem>
 	      </menuchoice> in the meeting editor window.
           </para>
 	</listitem>
-
 	<listitem>
-	  <para> Add attendees, either by entering their email address
-            into the list, or by clicking the <guibutton>Invite
-            Others</guibutton> button. When doing so, it's best to use
-            the Global Address List (GAL).  Choose the GAL from the
-            drop-down list of address sources at the top of the dialog
-            box.
+	  <para> Add attendees, either by entering their email
+            addresses into the list, or by clicking the
+            <guibutton>Invite Others</guibutton> button. If you choose
+            to so, it's best to use the Global Address List (GAL).
+            Choose the GAL from the drop-down list of address sources
+            at the top of the dialog box.
          </para>
 	</listitem>
 	<listitem>
@@ -475,7 +476,21 @@ There are, however, some features which are not available:
  	</listitem>
       </orderedlist>
     </para>
-  </sect1>
+      <tip id="autopick">
+	<title>Using Autopick to Adjust Meeting Times</title>
+	<para>
+         If meeting attendees are not available during the times you
+         have scheduled a meeting, you can "nudge" the meeting forward
+         or backward to the nearest available time.  To do so, just
+         click the arrows to the left or right of the
+         <guilabel>Autopick</guilabel> button. The autopick tool will
+         move the meeting to the nearest time during which all
+         attendees are available.  If you aren't satisfied with those
+         results, you can drag the edges of the meeting time to the
+         hours that you want to select.
+      </para>
+      </tip>
+    </sect1>
 </chapter>