diff options
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/C/usage-calendar.sgml | 344 | ||||
| -rw-r--r-- | doc/C/usage-contact.sgml | 53 |
2 files changed, 240 insertions, 157 deletions
diff --git a/doc/C/usage-calendar.sgml b/doc/C/usage-calendar.sgml index cf655d42fc..dbfbe7d8df 100644 --- a/doc/C/usage-calendar.sgml +++ b/doc/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 — 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> - <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> diff --git a/doc/C/usage-contact.sgml b/doc/C/usage-contact.sgml index fdd988d55d..2291e28548 100644 --- a/doc/C/usage-contact.sgml +++ b/doc/C/usage-contact.sgml @@ -1,4 +1,4 @@ - +<!DOCTYPE Chapter PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.1//EN"> <chapter id="usage-contact"> <title>The Evolution Contact Manager</title> @@ -67,15 +67,15 @@ <sect1 id="usage-contact-cards"> <title>Creating, Deleting, and Adding Cards</title> <para> - You can create a new card by pressing the <guibutton>New - Card</guibutton> button, or by pressing - <keysym>KEYSYM</keysym>. The <interface>Contact - Editor</interface> window will appear. It has two tabs, - <guilabel>General</guilabel>, for basic contact information, - and <guilabel>Details</guilabel>, for a more specific - description of the person. In addition, it contains a full - menu bar with all the items from the main window (IS THIS TRUE? - DESCRIBE MENUBAR AGAIN?) + You can create a new card by pressing the <guibutton>New + Card</guibutton> button, or by pressing + <keysym>KEYSYM</keysym>. The <interface>Contact + Editor</interface> window will appear. It has two tabs, + <guilabel>General</guilabel>, for basic contact information, and + <guilabel>Details</guilabel>, for a more specific description of + the person. In addition, it contains a full menu bar with all + the items from the main window (IS THIS TRUE? DESCRIBE MENUBAR + AGAIN?) </para> <para> The <guilabel>General</guilabel> tab contains no less than seven @@ -123,8 +123,7 @@ </screenshot> </figure> - -!-- +<!-- <variablelist> <listitem> <term> @@ -150,6 +149,7 @@ </para> --> + <para> You can choose which fields an address card has, and create new fields for cards. For example, @@ -211,11 +211,10 @@ <title>Groups of contacts</title> <para> <application>Evolution</application> lets you put cards into - folders, mark them as members of different groups, and search - through them in a variety of ways. This section will - describe how to organize and find contact information using - <application>Evolution</application>. CHANGE THIS paragraph: - it needs a great deal of work. + folders and mark them as members of different categories. + Although the contact manager does not support vFolders, + categories should provide as much flexibility as you need in + grouping your address cards. </para> <sect3 id="usage-contact-organize-group-folder"> @@ -226,13 +225,17 @@ <guilabel>Contacts</guilabel> folder. You can create more folders inside that one, or create other address book folders as well. Each card must be in one and only one - folder. + folder. If you've read <xref linkend="usage-mainwindow"> + then you already know that you can create a new folder by + selecting <guisubmenu>New</guisubmenu> and then + <guimenuitem>Folder</guimenuitem> from the + <guimenu>File</guimenu> menu. </para> <para> - To create a new folder, do this: - </para> - <para> - To put a card into a folder, do this: + To put a card into a folder, just drag it there from the + folder view, or (SOMETHING ELSE). Remember that address + cards can only go in contact folders, just like mail can + only go in mail folders, and calendars in calendar folders. </para> </sect3> @@ -251,7 +254,11 @@ and can never remember his phone number. </para> <para> - To mark a card as belonging to a category, do this: + To mark a card as belonging to a category, click the + <guibutton>Categories</guibutton> button at the lower + right. A dialog box will pop up with check-boxes for + different categories in it. You can select as many or as + few categories as you like. </para> <para> Then, you can refer to all the cards in that category by: |