Category stuff improved.

	* C/usage-contact.sgml: Category stuff improved.


	* C/usage-calendar.sgml: Now covers how to add an event properly.

svn path=/trunk/; revision=3571

1 files changed, 210 insertions, 134 deletions

diff --git a/help/C/usage-calendar.sgml b/help/C/usage-calendar.sgml
index cf655d42fc..dbfbe7d8df 100644
--- a/help/C/usage-calendar.sgml
+++ b/help/C/usage-calendar.sgml
@@ -1,142 +1,218 @@
+<!DOCTYPE Chapter PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.1//EN">
+
+<chapter id="usage-calendar">
+  <title>The Evolution Calendar: Time-Tamer Extraordinaire</title>
+  <para>
+    To begin using the calendar, select
+    <guibutton>Calendar</guibutton> from the <interface>shortcut
+    bar</interface>.  By default, the calendar starts with a display
+    of one day on a yellow ruled background.  There's a month calendar
+    in the upper right and a To-do list in the lower right. The
+    calendar's daily view is shown in <xref
+    linkend="usage-calendar-fig">.
+
+   <!-- ============== Figure ============================= -->
+    <figure id="usage-calendar-fig">
+      <title>Evolution Calendar View</title>
+      <screenshot>
+	<screeninfo>Evolution Contact Manager Window</screeninfo>
+	<graphic fileref="fig/calendar" format="png" srccredit="Aaron Weber">
+	</graphic>
+      </screenshot>
+    </figure>
+  <!-- ============== End of Figure ============================= --> 
+
+  </para>
+    <sect1 id ="usage-calendar-view"> 
+    <title>Ways of Looking at your Calendar</title>
+    <para>
+       You can view your calendar by the day, by the week, by the
+       month, or by the year.  To do so, use the calendar-shaped
+       buttons on the right side of the toolbar.
+    </para>
+    <para>
+       Describe the less-obvious differences among the views of time
+       here.
+    </para>
+
+    <para>
+       In addition, <application>Evolution</application> supports
+       Hebrew, Muslim, and other calendar formats.  To switch to a
+       different calendar format, choose
+       <guimenuitem>GUIMENUITEM</guimenuitem> from the
+       <guimenu>GUIMENU</guimenu>.
+    </para>
+    <para>
+       Describe the ways that different calendars can work here, and
+       how the different calendars work together.
+    </para>
+  </sect1>
+  <sect1 id="usage-calendar-apts">
+    <title>Scheduling With the Evolution Calendar</title>
+    <para>
+       The <application>Evolution</application> calendar allows you to
+       schedule events for yourself or a group of people.  It can
+       handle events that repeat, event lengths from ten minutes to
+       multiple days, and events that have a date but no specific
+       time.  You can set overlapping events, although
+       <application>Evolution</application> will warn you about trying
+       to do two things at once.  You can also set event reminders so
+       that you don't forget about everything you've just put into
+       your calendar. Basically, it can handle almost any schedule you
+       throw at it.
+    </para>
+    <sect2 id="usage-calendar-apts-basic">
+      <title>Creating events</title>
+      <para>
+	To create a new calendar event, select
+	<guisubmenu>New</guisubmenu> and then <guimenuitem>
+	Appointment</guimenuitem> from the <guimenu>MENU</guimenu>, or
+	click the <guibutton>New</guibutton> button on the left end of
+	the toolbar. The <interface>New Appointment</interface> dialog
+	will pop up with the usual menu bar, tool bar, and window full
+	of choices for you. I'm going to skip the the more
+	self-explanatory items, like the <guilabel>Summary</guilabel>
+	and <guilabel>Owner</guilabel> of the event (which is probably
+	you), and cut right to the more intersting ones.
+      </para>
+      <para>
+        Your event must have a starting and ending date &mdash; by
+        default, it's today &mdash; but you can choose whether to give
+        it starting and ending times or to mark it as an <guilabel>All
+        day event</guilabel>.  For the purposes of the calendar, an
+        <guilabel>All day event</guilabel> begins at ten in the
+        morning, runs until eleven at night, and is displayed at the
+        top of a day's event list rather than inside it.  This allows
+        you to include events of shorter duration within it.  A
+        conference might be an all day event, and the various lectures
+        might be timed events that happen during the all day event.
+      </para>
+      <para>
+         You can have as many as four different
+         <guilabel>Alarms</guilabel>, any time prior to the event
+         you've scheduled.  You can have one alarm of each type:
+         <itemizedlist>
+          <listitem>
+	    <para>
+	  <guilabel>Display</guilabel> means a window will pop up on
+	  your screen to remind you of your event.
+            </para>
+	  </listitem>
+          <listitem>
+	    <para>
+	       Click <guilabel>Audio</guilabel> to have your deliver a
+	       sound alarm.
+            </para>
+	  </listitem>
+          <listitem>
+	    <para>
+	      Select <guilabel>Program</guilabel> if you would like
+	      some additional application to run as a reminder.  You
+	      can enter its name in the text field, or find it with
+	      the <guibutton>Browse</guibutton> button.
+            </para>
+	  </listitem>
+
+          <listitem>
+	    <para>
+	       If you select <guilabel>Mail</guilabel>, then
+	       <application>Evolution</application> will send an email
+	       reminder to the address you enter into the text field.
+            </para>
+	  </listitem>
+	</itemizedlist>
+
+      </para>
+      <para>
+         <guilabel>Classification</guilabel> is a little more
+         complicated, and only applies to calendars on a
+         network. <guilabel>Public</guilabel> is the default category,
+         and a public even tcan be viewd by anyone on the calendar
+         sharing network.  <guilabel>Private</guilabel> means
+         (SOMETHING), and <guilabel>Confidential</guilabel> means that
+         (SOMETHING ELSE).
+      </para>
+      <para>
+        The <guilabel>Recurrence</guilabel> tab lets you describe
+        repitition in events ranging from once every day up to once
+        every 100 years.  You can then choose a time when repitition
+        will stop, and, under <guilabel>Exceptions</guilabel>, pick
+        individual days when the event will <emphasis>not</emphasis>
+        recur.
+      </para>
 
-    <chapter id="usage-calendar">
-      <title>The Evolution Calendar: Time-Tamer Extraordinaire</title>
       <para>
-        To begin using the calendar, select
-        <guibutton>Calendar</guibutton> from the <interface>shortcut
-        bar</interface>.  By default, the calendar starts in daily view mode 
-        The calendar's daily view is shown in 
-        <xref linkend="usage-calendar-fig">:
+	Once you're done with all those settings, click on the disk
+	icon in the toolbar.  That will save the event and close the
+	event editor window. If you want, you can alter an event
+	summary in the calendar view by clicking on it and typing. You
+	can change other settings by clicking once on the event in the
+	<interface>calendar view</interface> to select it, and then
+	choosing <guimenuitem>Event Properties</guimenuitem> from the
+	<guimenu>Settings</guimenu> menu.
+      </para>
+    </sect2>
 
-       <!-- ============== Figure ============================= -->
-	<figure id="usage-calendar-fig">
-	  <title>Evolution Calendar View</title>
-	  <screenshot>
-	    <screeninfo>Evolution Contact Manager Window</screeninfo>
-	    <graphic fileref="fig/calendar" format="png" srccredit="Aaron Weber">
-	    </graphic>
-	  </screenshot>
-	</figure>
-      <!-- ============== End of Figure ============================= --> 
+    <sect2 id="usage-calendar-apts-group">
+      <title>Appointments for Groups</title>
+      <para>
+	If you have your calendar set up to work with other
+	calendars over a network, you can see when others are
+	available to meet with you.  To browse other people's
+	calendars over your local network, do this: 
+      </para>
+      <para>
+	In addition, you can use
+	<application>Evolution</application> to mark a meeting
+	request on another person's calendar.  To do so, first
+	select <guimenuitem>New Appointment</guimenuitem> from the
+	<guimenu>MENU</guimenu>, or press <keysym>KEYSYM</keysym>
+	to bring up the <interface>new event</interface> window.
+	Then describe the event as you would any other.  Before
+	you click <guibutton>OK</guibutton>, (INSERT DESCRIPTION
+	HERE...).  <application>Evolution</application> will
+	automatically send email to each person on the request
+	list, notifying of the time and date of the meeting you
+	have requested with them.  In addition, it will mark the
+	event on your calendar and on theirs as tentative, rather than 
+	a confirmed, event.
+      </para>
+      <para>
+	To mark a tentative event as confirmed, click once on the
+	event in the <interface>calendar view</interface> to
+	select it, and then choose <guimenuitem>Event
+	Properties</guimenuitem> from the
+	<guimenu>Settings</guimenu> menu.  In the <interface>Event
+	Properties</interface> dialog window, click the
+	"tentative" button to un-mark the event. (NOTE THAT this
+	feature may not at all exist!)
+      </para>
+    </sect2>
 
+    <sect2 id="usage-calendar-apts-privs">
+      <title>Scheduling privileges</title>
+      <para>
+	There are several levels of scheduling privileges.  You
+	can set whether people can see your calendar, whether they
+	can request meetings or appointments, and whether they can
+	create appointments.  This section may have to be deleted,
+	because I don't know if we are going to support privileges
+	at all.
       </para>
-      <sect1 id ="usage-calendar-view"> 
-	<title>Ways of Looking at your Calendar</title>
-	<para>
-           You can view your calendar by the day, by the week, by the
-           month, or by the year.  To do so, click the buttons at the top
-           of <application>Evolution</application> with the numbers 1, 5,
-           7, 31 respectivly.
-        </para>
-	<para>
-           Describe the less-obvious differences among the views of
-           time here.
-        </para>
+    </sect2>
+  </sect1>
 
-	<para>
-           In addition, <application>Evolution</application> supports
-           Hebrew, Muslim, and other calendar formats.  To switch to a
-           different calendar format, choose
-           <guimenuitem>GUIMENUITEM</guimenuitem> from the
-           <guimenu>GUIMENU</guimenu>.
-        </para>
-	<para>
-           Describe the ways that different calendars can work here,
-           and how the different calendars work together.
-        </para>
-      </sect1>
-      <sect1 id="usage-calendar-apts">
-	<title>Scheduling With the Evolution Calendar</title>
-	<para>
-	   The <application>Evolution</application> calendar allows
-           you to schedule events for yourself or a group of people.
-           It can handle events that repeat, event lengths from ten
-           minutes to multiple days, and events that have a date but
-           no specific time.  You can set overlapping events, although
-           <application>Evolution</application> will warn you about
-           trying to do two things at once.  You can also set event
-           reminders so that you don't forget about everything you've
-           just put into your calendar. Basically, it can handle almost
-           any schedule you throw at it.
-        </para>
-	<sect2 id="usage-calendar-apts-basic">
-	  <title>Creating events</title>
-	  <para>
-            While looking at the calendar, select <guimenuitem>New
-            Appointment</guimenuitem> from the
-            <guimenu>MENU</guimenu>, or press
-            <keysym>KEYSYM</keysym>. The <interface>New
-            Appointment</interface> dialog will appear. (INSERT
-            DESCRIPTION OF INTERFACE HERE: Date, Time, Recurrence,
-            Reminders, and Tentative/Confirmed)
-          </para>
-	  <para>
-            You can alter those settings later by clicking once on the
-            event in the <interface>calendar view</interface> to
-            select it, and then choosing <guimenuitem>Event
-            Properties</guimenuitem> from the
-            <guimenu>Settings</guimenu> menu.
-          </para>
-	</sect2>
+  <sect1 id="usage-calendar-organize">
+    <title>Organizing your Appointments</title>
+    <para>
+       Until I have <application>Evolution</application> running properly,
+       I have no idea how this sort of organization will actually work.
+    </para>
+    <para>
+       But this section will have at least two paragraphs, and
+       probably a screenshot.
+    </para>
+  </sect1>
+</chapter>
 
-	<sect2 id="usage-calendar-apts-group">
-	  <title>Appointments for Groups</title>
-	  <para>
-            If you have your calendar set up to work with other
-            calendars over a network, you can see when others are
-            available to meet with you.  To browse other people's
-            calendars over your local network, do this: 
-          </para>
-	  <para>
-            In addition, you can use
-            <application>Evolution</application> to mark a meeting
-            request on another person's calendar.  To do so, first
-            select <guimenuitem>New Appointment</guimenuitem> from the
-            <guimenu>MENU</guimenu>, or press <keysym>KEYSYM</keysym>
-            to bring up the <interface>new event</interface> window.
-            Then describe the event as you would any other.  Before
-            you click <guibutton>OK</guibutton>, (INSERT DESCRIPTION
-            HERE...).  <application>Evolution</application> will
-            automatically send email to each person on the request
-            list, notifying of the time and date of the meeting you
-            have requested with them.  In addition, it will mark the
-            event on your calendar and on theirs as tentative, rather than 
-            a confirmed, event.
-          </para>
-	  <para>
-            To mark a tentative event as confirmed, click once on the
-            event in the <interface>calendar view</interface> to
-            select it, and then choose <guimenuitem>Event
-            Properties</guimenuitem> from the
-            <guimenu>Settings</guimenu> menu.  In the <interface>Event
-            Properties</interface> dialog window, click the
-            "tentative" button to un-mark the event. (NOTE THAT this
-            feature may not at all exist!)
-          </para>
-	</sect2>
-	
-	<sect2 id="usage-calendar-apts-privs">
-	 <title>Scheduling privileges</title>
-	  <para>
-            There are several levels of scheduling privileges.  You
-            can set whether people can see your calendar, whether they
-            can request meetings or appointments, and whether they can
-            create appointments.  This section may have to be deleted,
-            because I don't know if we are going to support privileges
-            at all.
-          </para>
-	</sect2>
-      </sect1>
 
-      <sect1 id="usage-calendar-organize">
-	<title>Organizing your Appointments</title>
-	<para>
-           Until I have <application>Evolution</application> running properly,
-           I have no idea how this sort of organization will actually work.
-        </para>
-	<para>
-           But this section will have at least two paragraphs, and
-           probably a screenshot.
-        </para>
-      </sect1>
-    </chapter>