path: root/doc/C/usage-calendar.sgml

<!-- <!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; press the calendar-shaped buttons on the
       right side of the toolbar to switch between views.
    </para>


<!-- ############### FIXME FIXME FIXME ############
Feature not yet implemented, and may not be implemented due to
lack of time, resources, and interest.
    <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>
################  END FIXME AREA   ##################   -->

  </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:
         <variablelist>
           <varlistentry>
        <term><guilabel>Display</guilabel></term>
        <listitem>
          <para>
            A window will pop up on your screen to remind you of
            your event.
              </para>
        </listitem>
      </varlistentry>
      <varlistentry> 
        <term><guilabel>Audio</guilabel></term>
        <listitem>
          <para>
            Choose this to have your deliver a sound alarm.
              </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term><guilabel>Program</guilabel></term>
        <listitem>
          <para>
            Select this 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>
      </varlistentry>
      <varlistentry>
        <term><guilabel>Mail</guilabel></term>
        <listitem>
          <para>
             <application>Evolution</application> will send an
             email reminder to the address you enter into the text
             field.
              </para>
        </listitem>
      </varlistentry>
    </variablelist>
        
      </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>

      <para>
    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>

    <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 it, 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-todo">
   <title>The To-Do List</title>
    <para>
       The to-do list, located in the lower right corner of the
       calendar, lets you keep a list of tasks seperate from your
       calendar events.  Tasks are colored by priority and due-date
       (see <xref linkend="config-prefs">), and are included with
       calendar data during synchronization with a hand-held device.
    </para>
    <para>
       To record a new task, click the <guibutton>Add</guibutton>
       button below the list.  <application>Evolution</application>
       will pop up a small window with five items in it:
     
        <variablelist>
      <varlistentry>
      <term> <guilabel>Summary:</guilabel></term>
      <listitem>
            <para>
              The description you enter here will appear in the To Do
              list itself.
          </para>
      </listitem>
      </varlistentry>
    
    <varlistentry>
      <term> <guilabel>Due Date:</guilabel></term>
      <listitem>
        <para>
            Decide when this item is
            due.  You can either type in a date and time, or select one from
            the <guibutton>Calendar</guibutton> and time drop-down menus.
          </para>
      </listitem>
    </varlistentry>
    <varlistentry>
      <term><guilabel>Priority:</guilabel></term>
      <listitem>
        <para>
             Select a level of importance from 1 (most important) to 9
              (least important).
            </para>
      </listitem> 
    </varlistentry>
    <varlistentry>
      <term> <guilabel>Item Comments:</guilabel></term>
      <listitem>
        <para>
              If you wish, you can keep a more detailed description of
              the item here.
            </para>
      </listitem>
    </varlistentry>
      </variablelist>
    </para>
    <para>
       Once you've added a task to your to-do list, its summary
       appears in the <guilabel>Summary</guilabel> section of the
       calendar window.  To edit an item, double-click on it, or
       select it and click <guibutton>Edit</guibutton>.  You can
       delete items by selecting them and clicking on the
       <guibutton>Delete</guibutton> button.
    </para>
  </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>