<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>
<!-- ############### 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>
-->
<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 — by
default, it's today — 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>
<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 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>
