Updated from users-guide.

1999-08-06  Kjartan Maraas  <kmaraas@online.no>

		* gnomecal.sgml: Updated from users-guide.

svn path=/trunk/; revision=1086

1 files changed, 118 insertions, 125 deletions

diff --git a/calendar/doc/C/gnomecal.sgml b/calendar/doc/C/gnomecal.sgml
index a286798600..fd5b98c581 100644
--- a/calendar/doc/C/gnomecal.sgml
+++ b/calendar/doc/C/gnomecal.sgml
@@ -177,12 +177,13 @@
      Calendar
     </primary>
    </indexterm>
-    The GNOME Calendar is a  simple calendar applications which can be
-    quite useful  in your  daily work. The  Calendar, like the  rest of
-    GNOME, is in its infancy and while it is a very useful application,
-    there will  be some very  impressive functionality that  will come
-    like network  shared calendar  usage, and syncing  capability with
-    Palm Pilots and other hand held PDAs.
+    The GNOME Calendar is a  simple calendar applications which can be quite 
+    useful in your daily work. The Calendar, like much of GNOME, is in its
+    infancy and while it is a very useful application, there is some very
+    impressive functionality still to come like network shared calendar usage, 
+    and syncing capability with Palm Pilots and other hand held PDAs. The
+    Calendar can be launched from the <guimenu>Applications</guimenu> submenu of
+    the Main Menu.
    </para>
    <para>
     The Calendar is  broken up into four main  tabs: Day, Week, Month,
@@ -201,12 +202,12 @@
   </sect1>
   <sect1 id="calsetup" <title>Setting Up the GNOME Calendar</title>
    <para>
-     The GNOME Calendar  can be used in the state  which it is shipped
-     but there are  some tools available to make sure  it is setup the
-     way you would like it to be. The first place you should go is the
-     GNOME Calendar  Preferences. You can find  the Preferences dialog
-     by selecting the <guimenuitem>Preferences</guimenuitem> menu item
-     from the <guimenu> File</guimenu> menu.
+     The GNOME Calendar can be used in the state which it is shipped but there 
+     are tools available to make sure it is setup the way you would like it to 
+     be. The first place you should go is the GNOME Calendar Preferences. You 
+     can find the Preferences dialog by selecting the 
+     <guimenuitem>Preferences</guimenuitem> menu item from the <guimenu> 
+     Settings</guimenu> menu.
    <figure>
     <title>The GNOME Calendar Preferences</title>
    <screenshot>
@@ -217,61 +218,62 @@
    </figure>
    </para>
    <para>
-    The Calendar Preferences  dialog is broken up into  two tabs, Time
-    display and Colors.
-   </para> 
+    The Calendar Preferences dialog is broken up into three tabs, Time
+    display and Colors, and Todo list
+   </para>
+   <para>
+   Time - This tab is broken up into three main sections: Time format, Weeks
+   start on, and Time range.  </para>
    <para>
-   Time - This tab is broken up into three main sections: Time format,
-   Weeks start on, and Day range.
-   </para>  
+      Time format - This allows you to choose between a 12 or 24 hour format 
+      clock.
+   </para>
    <para>
-      Time format - This allows you  to choose between a 12 or 24 hour
-      format clock.
+      Weeks start on - This allows you to define what day your week will start 
+      on, Sunday or Monday. This will affect how the calendar is laid out in the 
+      Day and Week views.
    </para>
    <para>
-      Weeks start  on - This allows  you to define what  day your week
-      will  start on,  Sunday  or  Monday. This  will  affect how  the
-      calendar is laid out in the Day and Week views.
+      Day range - This  section lets you choose what time your days will start 
+      and end. Any hours outside the range selected will be shaded on your Day
+      view.
    </para>
    <para>
-      Day range  - This  section lets you  choose what time  your days
-      will start  and end. Any  hours outside the range  selected will
-      not be displayed on your Day view.
+    Colors - This tab allows you to change the default colors used in the
+    Calendar. There are seven color choices you can customize: Outline,
+    Headings, Empty days, Appointments, Highlighted day, Day numbers, and
+    Current day's number. Each choice has a small color selector box next to
+    it. When you press this box you will be given a color selector dialog in 
+    which you can choose the color you want. Once you have selected a color the
+    small sample calendar on the right side of the tab will preview your choice.
    </para>
    <para>
-    Colors - This tab allows you  to change the default colors used in
-    the  Calendar. There are  seven color  choices you  can customize:
-    Outline, Headings, Empty  days, Appointments, Highlighted day, Day
-    numbers, and Current  day's number. Each choice has  a small color
-    selector box next to it. When you press this box you will be given
-    a  color selector dialog  in which  you can  choose the  color you
-    want. Once you have selected  a color the small sample calendar on
-    the right side of the tab will preview your choice.
+    Todo List - This tab allows you to define which columns will be shown in the
+    Todo List in the Day View. You can set the Summary, Due Date, and Priority
+    columns.
    </para>
    <para>
-    Once you have made the changes to the Calendar Preferences you may
-    press the <guibutton>Apply</guibutton> button to apply them.
+    Once you have made the changes to the Calendar Preferences you may press the
+    <guibutton>Apply</guibutton> button to apply them.
    </para>
   </sect1>
   <sect1 id="caluse">
    <title>Using the GNOME Calendar</title>
    <para>
-    Using the  GNOME Calendar  is quite simple  and most tasks  can be
-    performed  from  any of  the  major  views,  Day, Week,  Month  or
-    Year. Probably one  of the most important features  to remember is
-    that at any time you may right mouse click on a particular day and
-    add a new appointment. There are many other features which will be
-    described below in each of the major views.
+    Using the GNOME Calendar is quite simple and most tasks can be performed
+    from any of the major views, Day, Week, Month or Year. Probably one of the
+    most important features to remember is that at any time you may right mouse
+    click on a particular day and add a new appointment. There are many other 
+    features which will be described below in each of the major views.
    </para>
      <sect2 id="calday">
     <title>The Day View</title>
     <para>
-     The  Day  tab is  probably  the most  useful  view  in the  GNOME
-     Calendar as it acts just as a day timer would. On the left of the
-     tab  is the  hour listing  for the  current day.  The  light grey
-     coloring  in the  hour list  separates  the work  hours from  the
-     non-work hours. If  you  would  like  to change  the  work  hours
-     displayed   in   light   grey    you   can   do   so   in   <xref
+     The  Day tab is probably the most useful view in the GNOME Calendar as it
+     acts just as a day timer would. On the left of the tab  is the  hour listing
+     for the current day. The light grey coloring in the hour list separates 
+     the work hours from the non-work hours. If you would like to change the 
+     work hours displayed in light grey you can do so in <xref
      LinkEnd="calsetup">.
     </para>
     <figure>
@@ -294,37 +296,35 @@
      </para>
     </tip> 
     <para>
-     Next to  the hours listing  in the right  hand corner is  a small
-     full  month calendar. You  may change  the month  or year  of the
-     small month calendar by  pressing the forward and backward arrows
-     on the top. You may use  the small month calendar to navigate the
-     days  as well.  Double clicking  on any  day in  the  small month
-     calendar will move the current day view to that particular day.
+     Next to the hours listing in the top right hand corner is a small full
+     month calendar. You may change the month or year of the small month
+     calendar by pressing the forward and backward arrows on the top. You may
+     use the small month calendar to navigate the days as well. Double clicking
+     on any day in the small month calendar will move the current day view to
+     that particular day.
     </para>
     <para>
-     Below the small month calendar is your To-do list. The To-do list
-     is a  simple list where you can  keep all your tasks  on hand. To
-     add    an     item    to    the    To-do     list    press    the
-     <guibutton>Add</guibutton>  button.  This  will  launch  a  small
-     editing box where you can type in the item. Once you have entered
-     an    item   in    the    To-do   list    you    may   use    the
-     <guibutton>Edit</guibutton>  and <guibutton>Delete</guibutton> to
-     manage you items.  The To-do items are available  no matter which
-     days are displayed  in the Day View and can  only be deleted with
-     the <guibutton>Delete</guibutton> button.
+     Below the small month calendar is your Todo list. The Todo list is a
+     simple list where you can keep all your tasks on hand. To add an item to
+     the Todo list press the <guibutton>Add</guibutton> button. This will
+     launch a small editing box where you can type in the item. Once you have
+     entered an item in the Todo list you may use the
+     <guibutton>Edit</guibutton> and <guibutton>Delete</guibutton> to manage your
+     items. The To-do items are available no matter which days are displayed in
+     the Day View and can only be deleted with the <guibutton>Delete</guibutton>
+     button.
     </para>
    </sect2>
    <sect2 id="calweek">
     <title>The Week View</title>
     <para>
-     The Week View shows the current week with detailed descriptions of
-     your appointments. If you would like to add an appointment any of
-     the days  in the week view you  may right mouse click  on the day
-     and  select the  <guimenuitem>New  appointment</guimenuitem> menu
-     item from  the <guimenu>pop-up</guimenu>  menu. You may  also use
-     the  week  view  to  navigate  to  particular  days  in  the  Day
-     View. Double-click on any day in the Week View and you will go to
-     that day in the Day View.
+     The Week View shows the current week with detailed descriptions of your
+     appointments. If you would like to add an appointment for any of the days
+     in the week view, you may right mouse click on the day and select the
+     <guimenuitem>New appointment</guimenuitem> menu item from the
+     <guimenu>pop-up</guimenu> menu. You may also use the week view to navigate
+     to particular days in the Day View. Double-click on any day in the Week
+     View and you will go to that day in the Day View.
     </para>
     <figure>
      <title>The Week View</title>
@@ -346,21 +346,19 @@
    <sect2 id="calmonth">
     <title>The Month View</title>
     <para>
-     The  Month  View  shows  the  entire month  with  brief  detailed
-     descriptions of  your appointments. The  Month View makes  use of
-     the  customized colors available  in the  Calendar. You  may read
-     about    how    to    set    these   colors    in     <xref
-     Linkend="calsetup">. For  any day with  a brief description  of an
-     appointment  you may  click  on  the day  to  display a  detailed
-     description of the  appointment in a pop-up window.  If you would
-     like to  add an appointment  to a day  in the Month View  you may
-     right  mouse click  on any  day and  select  the <guimenuitem>New
-     Appointment   in    this   day</guimenuitem>   item    from   the
-     <guimenu>pop-up</guimenu>  menu. You  may  use the  items in  the
-     <guimenu>pop-up</guimenu> menu to navigate  in the Day, Week, and
-     Year  views   by  selecting  either   <guimenuitem>Jump  to  this
-     day</guimenuitem>, <guimenuitem>Jump  to this week</guimenuitem>,
-     or <guimenuitem>Jump to this Year</guimenuitem>.
+     The Month View shows the entire month with brief detailed descriptions of
+     your appointments. The Month View makes use of the customized colors
+     available in the Calendar. You may read about how to set these colors in
+     <xref Linkend="calsetup">. For any day with a brief description of an
+     appointment you may click on the day to display a detailed description of
+     the appointment in a pop-up window. If you would like to add an
+     appointment to a day in the Month View you may right mouse click on any day
+     and select the <guimenuitem>New Appointment in this day</guimenuitem> item
+     from the <guimenu>pop-up</guimenu> menu. You may use the items in the
+     <guimenu>pop-up</guimenu> menu to navigate in the Day, Week, and Year views
+     by selecting either <guimenuitem>Jump to this day</guimenuitem>,
+     <guimenuitem>Jump to this week</guimenuitem>, or <guimenuitem>Jump to this
+     Year</guimenuitem>.
     </para>
     <figure>
      <title>The Month View</title>
@@ -402,19 +400,17 @@
   <sect1 id="calappoint">
     <title>Making a New Appointment</title>
     <para>
-     There are many methods for  making a new appointment in the GNOME
-     Calendar, the easiest  by pressing the <guibutton>New</guibutton>
-     button on the button bar. Whenever you make a new appointment you
-     will launch the Create New  Appointment dialog that allows you to
-     set  the   properties  of   that  appointment.  The   Create  New
-     Appointment dialog is broken into two different tabs, the General
-     and the Recurrence tabs.
+     There are many methods for making a new appointment in the GNOME Calendar,
+     the easiest by pressing the <guibutton>New</guibutton> button on the
+     button bar. Whenever you make a new appointment you will launch the Create
+     New Appointment dialog that allows you to set the properties of that
+     appointment. The Create New Appointment dialog is broken into two
+     different tabs, the General and the Recurrence tabs.
     </para>
     <para>
-     General -  The General tab is  the area in which  you define when
-     the appointment is and set reminders for yourself. There are four
-     different areas  on the General  tab: Summary, Time,  Alarms, and
-     Classification.
+     General - The General tab is the area in which you specify the time of the
+     appointment and set reminders for yourself. There are four different areas
+     on the General tab: Summary, Time, Alarms, and Classification.
      <ITEMIZEDLIST MARK="bullet">
       <listitem>
        <para>
@@ -425,28 +421,26 @@
       </listitem>
       <listitem>
        <para>
-        Time - The Time area allows  you to set the time range for the
-        appointment by selecting the date and hours. Beside each start
-        and   end  days  there   is  a   small  selection   box  named
-        Calendar.   This  will   bring  up   a  small   Calendar  when
-        pressed. You  may select the start  and end date  in the small
-        calendar.  Beside the  start and  end hours  there is  a small
-        button  which   will  display  the  hours  of   the  day  when
-        pressed. Each hour in the list will have a sub menu displaying
-        each quarter hour so you may select them.
+        Time - The Time area allows you to set the time range for the
+	appointment by selecting the date and hours. To the right of the start
+        and end days there is a small selection box named Calendar. This will
+	bring up a small Calendar when pressed. You may select the start and end
+	date in the small calendar. To the right of the start and end hours
+	there is a small button which will display the hours of the day when
+	pressed. Each hour in the list will have a sub menu displaying each
+	quarter hour so you may select them. The hours are restricted to those
+	included in the Day Range.
        </para>
       </listitem>
       <listitem>
        <para>
-        Alarms -  The Alarms  area allows  you to set  up an  alarm to
-        remind you  of an appointment. There are  four different types
-        of  alarms you  may use  to remind  yourself  of appointments:
-        Display,  Audio, Program,  and  Mail. The  Display alarm  will
-        display a message on your screen in the time you set. The Audio
-        alarm will play an audio file in the time you set. The Program
-        alarm will run a program you  specify in the time you set. The
-        Mail alarm will  send email to the user  specified in the time
-        you set.
+        Alarms - The Alarms area allows you to set up an alarm to remind you of
+	an appointment. There are four different types of alarms you may use to
+	remind yourself of appointments: Display, Audio, Program, and Mail. The
+	Display alarm will display a message on your screen at the time you
+	set. The Audio alarm will play an audio file at the time you set. The
+	Program alarm will run a program you specify at the time you set. The
+        Mail alarm will send email to the user specified at the time you set.
        </para>
       </listitem>
      <!-- <listitem>
@@ -457,15 +451,14 @@
      </itemizedlist>
     </para>
     <para>
-     Recurrence - The  Recurrence tab allows you to  specify how often
-     an appointment  should recur, if  at all. The first  property you
-     should set if you want  a recurring appointment is the Recurrence
-     rule.  You may  choose among  None, Daily,  Weekly,  Monthly, and
-     Yearly.  For  each  selection   you  may  adjust  the  recurrence
-     properties for  your selection. In  the Ending date area  you may
-     set a rule which will  stop the recurrence of your appointment or
-     allow it to  repeat forever. In the Exceptions  area you may make
-     exceptions to  the recurring appointment by selecting  the date a
+     Recurrence - The Recurrence tab allows you to specify how often an
+     appointment should recur, if at all. The first property you should set if
+     you want a recurring appointment is the Recurrence rule. You may choose
+     among None, Daily, Weekly, Monthly, and Yearly. For each selection you may
+     adjust the recurrence properties for your selection. In the Ending date
+     area you may set a rule which will stop the recurrence of your appointment
+     or allow it to repeat forever. In the Exceptions area you may make
+     exceptions to the recurring appointment by double-clicking the date and
      pressing the <guibutton>Add</guibutton> button.
     </para>
    </sect1>