diff options
Diffstat (limited to 'doc/C')
| -rw-r--r-- | doc/C/apx-authors.sgml | 48 | ||||
| -rw-r--r-- | doc/C/config-setupassist.sgml | 113 | ||||
| -rw-r--r-- | doc/C/evolution-guide.sgml | 12 | ||||
| -rw-r--r-- | doc/C/usage-mail.sgml | 71 | ||||
| -rw-r--r-- | doc/C/usage-mainwindow.sgml | 87 | ||||
| -rw-r--r-- | doc/C/usage-setup.sgml | 126 |
6 files changed, 251 insertions, 206 deletions
diff --git a/doc/C/apx-authors.sgml b/doc/C/apx-authors.sgml index f68b395c9f..7039f6c9c9 100644 --- a/doc/C/apx-authors.sgml +++ b/doc/C/apx-authors.sgml @@ -3,30 +3,30 @@ <title>Authors</title> <para> <application>Evolution</application> was written by: - - Seth Alves: <email>alves@helixcode.com</email> - Anders Carlsson<email>andersca@helixcode.com</email> - Damon Chaplin:<email>damon@helixcode.com</email> - Clifford R. Conover <email>rusty@zootweb.com</email> - Miguel De Icaza: <email>miguel@helixcode.com</email> - Arturo Espinoza <email>arturo@nucleu.unam.mx</email> - Larry Ewing: <email>lewing@helixcode.com</email> - Bertrand Guiheneuf: <email>bertrand@helixcode.com</email> - Tuomas Kuosmanen: <email>tigert@gimp.org</email> - Christopher J. Lahey: <email>clahey@helixcode.com</email> - Matthew Loper: <email>matt@helixcode.com</email> - Dave Mason <email>dcm@redhat.com</email> - Federico Mena: <email>federico@helixcode.com</email> - Eskil Heyn Olsen<email>deity@eski.dk</email> - Nat Friedman: <email>nat@helixcode.com</email> - Ettore Perazzoli:<email>ettore@helixcode.com</email> - Russell Steinthal: <email>rms39@columbia.edu</email> - Peter Teichman: <email>peter@helixcode.com</email> - Chris Toshok: <email>toshok@helixcode.com</email> - Radek Doulik: <email>rodo@helixcode.com</email> - Dan Winship: <email>winship@helixcode.com</email> - Michael Zucchi: <email>notzed@helixcode.com</email> - +<simplelist> + <member>Seth Alves: <email>alves@helixcode.com</email></member> + <member>Anders Carlsson<email>andersca@gnu.org</email></member> + <member>Damon Chaplin:<email>damon@helixcode.com</email></member> + <member>Clifford R. Conover <email>rusty@zootweb.com</email></member> + <member>Miguel De Icaza: <email>miguel@helixcode.com</email></member> + <member>Arturo Espinoza <email>arturo@nucleu.unam.mx</email></member> + <member>Larry Ewing: <email>lewing@helixcode.com</email></member> + <member>Bertrand Guiheneuf: <email>bertrand@helixcode.com</email></member> + <member>Tuomas Kuosmanen: <email>tigert@gimp.org</email></member> + <member>Christopher J. Lahey: <email>clahey@helixcode.com</email></member> + <member>Matthew Loper: <email>matt@helixcode.com</email></member> + <member>Dave Mason <email>dcm@redhat.com</email></member> + <member> Federico Mena: <email>federico@helixcode.com</email></member> + <member>Eskil Heyn Olsen<email>deity@eski.dk</email></member> + <member> Nat Friedman: <email>nat@helixcode.com</email></member> + <member>Ettore Perazzoli:<email>ettore@helixcode.com</email></member> + <member>Russell Steinthal: <email>rms39@columbia.edu</email></member> + <member> Peter Teichman: <email>peter@helixcode.com</email></member> + <member> Chris Toshok: <email>toshok@helixcode.com</email></member> + <member> Radek Doulik: <email>rodo@helixcode.com</email></member> + <member> Dan Winship: <email>winship@helixcode.com</email></member> + <member> Michael Zucchi: <email>notzed@helixcode.com</email></member> +</simplelist> and other dedicated GNOME programmers. </para> <para> diff --git a/doc/C/config-setupassist.sgml b/doc/C/config-setupassist.sgml index f33cc81de2..ea78865037 100644 --- a/doc/C/config-setupassist.sgml +++ b/doc/C/config-setupassist.sgml @@ -4,15 +4,122 @@ <para> The setup assistant can gather most of the information necessary for <application>Evolution</application>'s daily - operation. If you chose not to use it the first time you ran - <application>Evolution</application>, you can run it again by - doing SOMETHING HERE. + operation. If you prefer more detailed or advanced + configuration, see <xref linkend="config-prefs"> </para> <para> This paragraph will describe all information required by the setup assistant. It will include a long itemized list, and a screenshot or two. </para> + <sect1 id="config-setupassist-mail"> + <title>Mail Setup</title> + <para> + The first time you try to send or receive mail with + <application>Evolution</application>, the <interface>mail + setup druid</interface> will pop up to help you + set up your email preferences. If you don't plan to use + email, or if you'd rather configure your email preferences + later, click <guibutton>Cancel</guibutton>. + </para> + <para> + The setup <glossterm>druid</glossterm> + will guide you through the network configuration process. It + will ask you for some basic information; your system + administrator or ISP should have the answers you'll need. + The mail setup druid is pictured in <xref + linkend="usage-setup-fig">. + +<!-- ==============Figure=================================== --> + + <figure id="usage-setup-fig"> + <title>Mail Setup Druid</title> + <screenshot> + <screeninfo>Evolution Main Window</screeninfo> + <graphic fileref="fig/mail-druid-pic" format="png" srccredit="Aaron Weber"> + </graphic> + </screenshot> + </figure> +<!-- ==============End of Figure=================================== --> + + + + The druid will ask you for the following information: + <itemizedlist> + <listitem> <para> <guilabel>Name— </guilabel> Your + full name: eg. Eva Lucianne Tester </para></listitem> + + <listitem><para> <guilabel>Email address&mdash</guilabel>; + Your email address: eg. eltester@helixcode.com + </para></listitem> + + <listitem> + <para> + <guilabel> Organization—</guilabel> Any + organization you represent. Leave this blank if you + wish. + </para> + </listitem> + + <listitem><para> <guilabel>Signature File—</guilabel> A text + file appended to any email you send, typically your name + and email address, or a quotation you like. It should be + under three lines of text.</para></listitem> + + <listitem> + <para> + <guilabel>Mail source type—</guilabel> + <application>Evolution</application> supports two mail + sources: POP servers, the most common email server type, + and UNIX-style MBOX files. Ask your system + administrator which one you use. + </para> + </listitem> + + <listitem> + <para> + <guilabel>Server—</guilabel> This should be the + name of your mail server, eg. + mailserver.organization.org + </para> + </listitem> + + <listitem> + <para> + <guilabel> Username— </guilabel>Usually, this is + the part of your email address before the @ character, + and <application>Evolution</application> has selected + that value as the default. If you have a different + username, you can enter it here. + </para> + </listitem> + + <listitem> + <para> + <guilabel>Authentication—</guilabel> Select the + type of authentication you will use. You can click + <guibutton>Detect supported types</guibutton> to find + out which authentication protocols your network allows. + </para> + </listitem> + + + <listitem> + <para> + <guilabel>Mail Transport—</guilabel> This is the + mail sending protocol you will want to use. Sendmail is + the default. + </para> + </listitem> + </itemizedlist> + </para> + <para> + To learn how to configure <application>Evolution</application> + in greater detail, or to change preferences once you have set + them, see <xref linkend="config-prefs">. + </para> + </sect1> + </chapter> diff --git a/doc/C/evolution-guide.sgml b/doc/C/evolution-guide.sgml index 9df4a2a170..1e76a74a7d 100644 --- a/doc/C/evolution-guide.sgml +++ b/doc/C/evolution-guide.sgml @@ -1,7 +1,6 @@ <!DOCTYPE Book PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.1//EN"[ <!ENTITY PREFACE SYSTEM "preface.sgml"> -<!ENTITY USAGE-SETUP SYSTEM "usage-setup.sgml"> <!ENTITY USAGE-MAINWINDOW SYSTEM "usage-mainwindow.sgml"> <!ENTITY USAGE-MAIL SYSTEM "usage-mail.sgml"> <!ENTITY USAGE-CONTACT SYSTEM "usage-contact.sgml"> @@ -25,8 +24,15 @@ <book id="index"> <bookinfo> <title>A User's Guide to Evolution</title> - <author><firstname>Aaron</firstname><surname>Weber</surname></author> - <copyright><year>2000</year><holder>Helix Code, Inc.</holder></copyright> + <authorgroup> + <author><firstname>Aaron</firstname><surname>Weber</surname></author> + <author><firstname>Kevin</firstname><surname>Breit</surname></author> + + </authorgroup> + <copyright> + <year>2000</year><holder>Helix Code, Inc.</holder> + <holder>Kevin Breit</holder> + </copyright> <legalnotice> <para> diff --git a/doc/C/usage-mail.sgml b/doc/C/usage-mail.sgml index 88e92756fe..2dd289e4c3 100644 --- a/doc/C/usage-mail.sgml +++ b/doc/C/usage-mail.sgml @@ -47,7 +47,9 @@ You can start reading email by clicking <guibutton>Inbox</guibutton> in the shortcut bar. By default, the <interface>Inbox</interface> is open when you - start <application>Evolution</application>. + start <application>Evolution</application>, and the first + time you see your inbox, there's a message in it from Helix + Code welcoming you to the application. </para> </abstract> @@ -92,29 +94,34 @@ </graphic> </screenshot> </figure> - <!-- ==============End of Figure=================================== --> + <!-- ==============End of Figure=================================== + --> </para> </sect2> - &USAGE-SETUP; + <sect2 id="usage-mail-getnsend-get"> <title>Getting Mail</title> <para> To check your email, just click <guibutton>Send and - Receive</guibutton> in the toolbar. - <application>Evolution</application> will download your - mail for you and send any mail you've marked ready to - send. New mail will appear in your + Receive</guibutton> in the toolbar. If this is the first + time you've done so, the <interface>mail druid</interface> + will ask you for the information it needs to check your + mail (see <xref linkend="config-setupassist"> for more + information). Then, <application>Evolution</application> + will download your mail for you and send any mail you've + marked ready to send. New mail will appear in your <interface>Inbox</interface> and also in the <interface>Today View</interface>. </para> <para> - If you get an error message, you probably need to change - your network preferences. To learn how to do that, have a - look at <xref linkend="config-prefs-network">, or ask your - system administrator. + If you get an error message instead of mail, you probably + need to change your network preferences. To learn how to + do that, have a look at <xref + linkend="config-prefs-network">, or ask your system + administrator. </para> <sect3 id="usage-mail-getnsend-get-attach"> @@ -125,7 +132,8 @@ want to put it. Once you've downloaded a file, you can open, move, copy, or execute it just like any other, using <application>Nautilus</application> or your - favorite shell or file manager. + favorite shell or file manager. (This text will change + to fit app behavior, once features are implemented.) </para> <para> @@ -541,20 +549,24 @@ <sect2 id="usage-mail-organize-folders"> <title>Getting Organized with Folders</title> <para> - You can create new folders by selecting - <guimenuitem>ITEM</guimenuitem> from the - <guimenu>MENU</guimenu>, or by pressing + Mail, as well as address cards and calendars, is kept in + folders. If you like, you can create new folders by + selecting <guisubmenu>New</guisubmenu> and then + <guimenuitem>Folder</guimenuitem> from the + <guimenu>File</guimenu> menu, or by pressing <keysym>COMBO</keysym>. (Will there be a dialog box to determine name and location? Must wait for feature to - describe) The new folders will appear in the + describe.) The new folders will appear in the <interface>tree view</interface>, and you can drag them wherever you want to relocate them. You can move messages - into them by dragging, or by selecting them and choosing - <guimenuitem>ITEM</guimenuitem> from the - <guimenu>MENU</guimenu>. An email message can be in only - one folder at a time, just like real mail in real folders. - This is also the case for folders of address cards and calendar - information. + into the folders by dragging and dropping, or by selecting + them and choosing <guimenuitem>ITEM</guimenuitem> from the + <guimenu>MENU</guimenu>. If you create filters with the + <interface>filter druid</interface>, you can have mail + moved to a folder automatically. An email message can be in + only one folder at a time, just like real mail in real + folders. This is also the case for folders of address + cards and calendar information. </para> </sect2> @@ -718,17 +730,18 @@ <itemizedlist> <listitem> <para> - <guilabel>When mail arrives:</guilabel> new mail - arrives in the Inbox, and you can filter it from - here. + <guilabel>When mail arrives:</guilabel> Select + this option to have messages filtered as they + arrive. </para> </listitem> <listitem> <para> - <guilabel> When mail is sent:</guilabel> When you - send mail, you can perform additional actions on - it— perhaps you keep your Outbox sorted into - subfolders. + <guilabel>When mail is sent:</guilabel> Select + this option to filter your outgoing mail. You + can use this feature to keep your + <interface>Outbox</interface> as organized as + your <interface>Inbox</interface>. </para> </listitem> </itemizedlist> diff --git a/doc/C/usage-mainwindow.sgml b/doc/C/usage-mainwindow.sgml index 3dc91e5a97..a917f3a71f 100644 --- a/doc/C/usage-mainwindow.sgml +++ b/doc/C/usage-mainwindow.sgml @@ -144,14 +144,47 @@ forth. Can these things be labelled with little arrows & stuff? data like a <glossterm>file tree</glossterm>— it starts small at the top, and branches downwards. There are a few folders you will always see, because they're at the top. - On my computer, they are: (ch. to itemizedlist w/descriptions?) - <simplelist> - <member>Local Mail</member> - <member>Remote Mail</member> - <member>Address Book</member> - <member>Calendar</member> - <member>Trash</member> - </simplelist>. + On my computer, I have only one: <guilabel>Local</guilabel>. + When I click on the plus sign next to the label, I see the + contents: + <itemizedlist> + <listitem> + <para> + <guilabel>Calendar</guilabel>, where you'll find the + appointments and event listings. + </para> + </listitem> + <listitem> + <para> + <guilabel>Contacts</guilabel>, where your address + cards are stored. + </para> + </listitem> + <listitem> + <para> + <guilabel>Directories</guilabel>, for directories, which + have not been implemented yet. + </para> + </listitem> + <listitem> + <para> + <guilabel>Inbox</guilabel>, for your incoming mail. + This is where you will make the most subfolders. + </para> + </listitem> + <listitem> + <para> + <guilabel>Outbox</guilabel>, where you can store + copies of mail you have sent, or unsent drafts. + </para> + </listitem> + <listitem> + <para> + <guilabel>Trash</guilabel>, where you can throw things away. + </para> + </listitem> + </itemizedlist> + </para> <para> @@ -179,10 +212,11 @@ forth. Can these things be labelled with little arrows & stuff? <para> If a folder has other folders in it, there will be a plus - sign next to it. Click on the plus sign, and you will see - the other folders inside. This may change in the future to - something more attractive, like triangles that drop down as - you click on them to display the rest of the tree. + sign next to it. Click on the plus sign, and the folder will + open to let you see the other folders inside. This may + change in the future to something more attractive, like + triangles that drop down as you click on them to display the + rest of the tree. </para> <para> @@ -194,14 +228,19 @@ forth. Can these things be labelled with little arrows & stuff? </para> <para> - You can drag the folders inside the tree view to change - their order or put one folder inside another. To delete a - folder, you can drag it into the trash folder. The same - goes for individual messages, appointments, and address - cards, whether they're in the <interface>tree + Moving and deleting folders and other items works in one of + two ways: using <glossterm>drag-and-drop</glossterm> or by + right-clicking and selecting an item from the + <interface>right-click menu</interface>. You can drag the + folders inside the tree view to change their order or put + one folder inside another. To delete a folder, drag it into + the trash folder or right-click it and select + <guimenuitem>Delete</guimenuitem> from the menu that pops + up. The same goes for individual messages, appointments, + and address cards, whether they're in the <interface>tree view</interface> or not: drag them where you want them, and - they will go there. -<!-- ****This paragraph could use some work**** --> + they will go there. <!-- ****This paragraph could use some + work**** --> </para> <para> You can also use the <guimenu>right-click menu</guimenu> to @@ -212,8 +251,14 @@ forth. Can these things be labelled with little arrows & stuff? <para> Once you've familiarized yourself with the <interface>main window</interface> you can start doing things with it. - We'll start with email: you've got a letter waiting for you - already. + We'll start with your email inbox: you've got a letter + waiting for you already. </para> </sect1> </chapter> + + + + + + diff --git a/doc/C/usage-setup.sgml b/doc/C/usage-setup.sgml deleted file mode 100644 index 3e793fdbcd..0000000000 --- a/doc/C/usage-setup.sgml +++ /dev/null @@ -1,126 +0,0 @@ - <sect2 id="usage-setup"> - <title>Mail Setup</title> - <para> - The first time you try to send or receive mail with - <application>Evolution</application>, the <interface>mail - setup druid</interface> will pop up to help you - set up your email preferences. If you don't plan to use - email, or if you'd rather configure your email preferences - later, click <guibutton>Cancel</guibutton>. - </para> - <para> - The setup <glossterm>druid</glossterm> - will guide you through the network configuration process. It - will ask you for some basic information; your system - administrator or ISP should have the answers you'll need. - The mail setup druid is pictured in <xref - linkend="usage-setup-fig">. - -<!-- ==============Figure=================================== --> - - <figure id="usage-setup-fig"> - <title>Mail Setup Druid</title> - <screenshot> - <screeninfo>Evolution Main Window</screeninfo> - <graphic fileref="fig/mail-druid-pic" format="png" srccredit="Aaron Weber"> - </graphic> - </screenshot> - </figure> -<!-- ==============End of Figure=================================== --> - - - - The druid will ask you for the following information: - <itemizedlist> - <listitem> <para> <guilabel>Name— </guilabel> Your - full name: eg. Eva Lucianne Tester </para></listitem> - - <listitem><para> <guilabel>Email address&mdash</guilabel>; - Your email address: eg. eltester@helixcode.com - </para></listitem> - - <listitem> - <para> - <guilabel> Organization—</guilabel> Any - organization you represent. Leave this blank if you - wish. - </para> - </listitem> - - <listitem><para> <guilabel>Signature File—</guilabel> A text - file appended to any email you send, typically your name - and email address, or a quotation you like. It should be - under three lines of text.</para></listitem> - - <listitem> - <para> - <guilabel>Mail source type—</guilabel> - <application>Evolution</application> supports two mail - sources: POP servers, the most common email server type, - and UNIX-style MBOX files. Ask your system - administrator which one you use. - </para> - </listitem> - - <listitem> - <para> - <guilabel>Server—</guilabel> This should be the - name of your mail server, eg. - mailserver.organization.org - </para> - </listitem> - - <listitem> - <para> - <guilabel> Username— </guilabel>Usually, this is - the part of your email address before the @ character, - and <application>Evolution</application> has selected - that value as the default. If you have a different - username, you can enter it here. - </para> - </listitem> - - <listitem> - <para> - <guilabel>Authentication—</guilabel> Select the - type of authentication you will use. You can click - <guibutton>Detect supported types</guibutton> to find - out which authentication protocols your network allows. - </para> - </listitem> - - - <listitem> - <para> - <guilabel>Mail Transport—</guilabel> This is the - mail sending protocol you will want to use. Sendmail is - the default. - </para> - </listitem> - </itemizedlist> - </para> - <para> - To learn how to configure <application>Evolution</application> - in greater detail, or to change preferences once you have set - them, see <xref linkend="config-prefs">. - </para> - </sect2> - - - - - - - - - - - - - - - - - - - |