From 04865e57d321a7d35e5165e8ec6de8f505ab54de Mon Sep 17 00:00:00 2001 From: Aaron Weber Date: Thu, 31 Aug 2000 06:02:03 +0000 Subject: Added "quickref and pointers" sections. Props to O'Reilly for the copy of 2000-08-31 Aaron Weber * C/preface.sgml: Added "quickref and pointers" sections. Props to O'Reilly for the copy of Outlook in a Nutshell which gave me the idea. 2000-08-30 Aaron Weber * C/usage-mainwindow.sgml: Minor fixes. * C/preface.sgml: Corrected grammar, added glossterms, described menuref. svn path=/trunk/; revision=5136 --- doc/C/.cvsignore | 5 + doc/C/evolution-guide.sgml | 12 +- doc/C/preface.sgml | 285 +++++++++++++++++++++++++++++++++++++++---- doc/C/usage-mainwindow.sgml | 69 +++++++---- doc/ChangeLog | 13 ++ help/C/.cvsignore | 5 + help/C/evolution-guide.sgml | 12 +- help/C/preface.sgml | 285 +++++++++++++++++++++++++++++++++++++++---- help/C/usage-mainwindow.sgml | 69 +++++++---- help/ChangeLog | 13 ++ 10 files changed, 652 insertions(+), 116 deletions(-) diff --git a/doc/C/.cvsignore b/doc/C/.cvsignore index cba1534920..2f4c48adbf 100644 --- a/doc/C/.cvsignore +++ b/doc/C/.cvsignore @@ -2,3 +2,8 @@ Makefile Makefile.in evolution-guide evolution-guide.junk +evolution-guide.log +evolution-guide.ps +evolution-guide.dvi +evolution-guide.tex +fig/*.eps \ No newline at end of file diff --git a/doc/C/evolution-guide.sgml b/doc/C/evolution-guide.sgml index b9b5f72adb..f7a7a87ab2 100644 --- a/doc/C/evolution-guide.sgml +++ b/doc/C/evolution-guide.sgml @@ -48,7 +48,7 @@ GNU General Public License, or GPL. - The licenses are included with this document in , and ; you may also obtain a copy from the Free Software Foundation by visiting their Web site or @@ -102,11 +102,11 @@ Evolution is highly configurable. Usually, when developers say that, they mean that they didn't test it out thoroughly and have left it to other hackers to - "configure" themselves a working system. When we say - configurable, we mean that although - Evolution will work perfectly well - with minimal setup hassle, you can alter its behavior to fit - your needs with just a little more work. + "configure" themselves a working system. But in the case of + Evolution, you can expect that it + will work perfectly well with minimal setup hassle, and that + you can alter its behavior to fit your needs with just a + little more work. diff --git a/doc/C/preface.sgml b/doc/C/preface.sgml index bb6cb4d948..c7f6c2824d 100644 --- a/doc/C/preface.sgml +++ b/doc/C/preface.sgml @@ -1,10 +1,13 @@ - + + Introduction -
- What is Evolution, and What Can It Do for Me? + + What is Evolution, and What Can It Do for Me? The word "evolution" means "a process of improvement and development." The GNOME application @@ -17,8 +20,7 @@ Evolution is free software. The program and its source code are released under the terms of the GNU Public License (GPL), and the documentation falls - under the Free Documentation License (FDL), which is included - with this document (). For more + under the Free Documentation License (FDL). For more information about the GPL and the FDL, visit the Free Software Foundation's website at http://www.fsf.org. @@ -75,18 +77,17 @@ to turn Evolution into an advanced development platform. From the simplest scripting to the most complex network and component - programming, Evolution - needed to offer developers an environment for - cutting-edge application development. + programming, Evolution must + to offer developers an environment for cutting-edge + application development. Data must be safe: Evolution - must not lose mail or corrupt mailbox files. It will - not execute scripts, automatically forward a virus to - your entire contacts list, or delete files from your - hard disk. + must not not lose mail, corrupt mailbox files or other + data, execute arbitrary scripts, or delete files from + your hard disk. @@ -105,9 +106,9 @@ folders. -
+ -
+ About This Book @@ -119,21 +120,26 @@ guide to aaron@helixcode.com. If you would like to work on the guide please contact me or see the GNOME Documentation project web site. This - paragraph will be removed in later versions of the manual. + url="http://developer.gnome.org/projects/gdp">web + site. This paragraph will be removed in later + versions of the manual. - This book is divided into two sections. The first section is a - guided tour— it will - explain how to use Evolution. If - you are new to Evolution or to - groupware in general, this is the section for you. The second - section, covering configuration, - is targeted at more advanced users, but anyone who wants to + This book is divided into two parts, with several + appendicies. The first part is a guided + tour— it will explain how to use + Evolution. If you are new to + Evolution or to groupware in + general, this is the section for you. The second section, + covering configuration, is + targeted at more advanced users, but anyone who wants to change the way Evolution looks or - acts can benefit from reading it. + acts can benefit from reading it. In addition, there is a + comprehensive menu + reference which describes nearly every capability that + Evolution has to offer. Typographical conventions @@ -154,11 +160,238 @@ Buttons you can click Anything you type in Text output from a computer - + Words that are defined + in . -
+ + + A Quick Reference to Common Tasks + + You might want to copy the next few pages and tape them to the + wall next to your computer: They contain a very short run-down + of most of the things you'll want to do with + Evolution, and pointers to the + sections of the book where you'll find more in-depth + description of those tasks. + + + Opening or Creating Anything + + Here are the keyboard shortcuts and menu items you're most + likely to use: (Please note that the shortcuts listed are + probably wrong at this point). + + + + + Create a new folder + + + FileNew + Folder or + + Ctrl + Shift + F + + + + + + + Create a new Shortcut in the Evolution Bar + + + File + New + Evolution Bar Shortcut or + + Ctrl + Shift + S + + + + + + + Create a new email message: + + + Use + FileNewMail + Message or + + Ctrl + Shift + M + + + + + + + Create a new Appointment + + + File + New + Appointment or + + Ctrl + Shift + A + + + + + + + Create a new Task + + + File + New + Task or + + Ctrl + Shift + T + + + + + + + + Enter a new Contact + + + File + New + Contact or + + Ctrl + Shift + C + + + + + + + + + + + Mail Tasks + + Here are the most frequent email tasks: + + + Check Mail + + + Click Get Mail in the toolbar, or press + + FIXME + FIXME + FIXME + + + + + + + Reply to Message + + + Select the message to which you want to reply, and + click Click Reply in the + toolbar, or press + + FIXME + FIXME + FIXME + + + + + + + Forward Message + + + Select the message you want to forward, and + click Click Forward in the + toolbar, or press + + FIXME + FIXME + FIXME + + + + + + + Create Filters and vFolders + + + You can create filters and vFolders based on specific + message attributes by right-clicking on a message or + by selecting Tools + Mail Filters + or Tools + vFolder Editor + . Filters are discussed in , and vFolders + in . + + + + + + + + + Calendar + + + + + + + + + + + + + + + + + Contact Manager + + + + + + + + + + + + + + + + + diff --git a/doc/C/usage-mainwindow.sgml b/doc/C/usage-mainwindow.sgml index 8a71f2d4f2..370403415d 100644 --- a/doc/C/usage-mainwindow.sgml +++ b/doc/C/usage-mainwindow.sgml @@ -6,13 +6,14 @@ The Main Window: Evolution Basics Start Evolution by selecting - Evolution from the - Applications of the Main Panel - Menu, or by typing evolution at the - command-line. The first time you run the program, it will create - a directory called evolution in your home - directory, where it will keep all your - Evolution-related files. + Main Panel Menu + Applications + Evolution or by typing + evolution at the command line. The first time + you run the program, it will create a directory called + evolution in your home directory, where it + will keep all your Evolution-related + files. After Evolution starts @@ -88,7 +89,7 @@ Take a look at the Evolution Shortcuts - again. They are: + again. The shortcut buttons in that category are: @@ -165,27 +166,40 @@ - If you prefer to use a keyboard shortcut, or hot - key, you can use those instead. They're shown next - to their equivalent menu items in the menu bar. You can also set - your own hot keys for functions that don't have any; this is - covered in . If you're using the + If you don't like the shortcut bar, you can use keyboard + shortcuts, or hot keys. They're shown + next to their equivalent menu items in the menu bar. You can + also set your own hot keys for functions that don't have any; + this is covered in . If you're using the keyboard shortcuts you may also want to hide the - shortcut bar by selecting - View Show Shortcut + shortcut bar by selecting + View Show Shortcut Bar . - Two Shortcut Bar Tricks + Shortcut Bar Tricks To remove a shortcut from the shortcut bar, right-click on it - and select Remove. + and select Remove. To add one, + select File + New Evolution Bar + Shortcut . To change the way the shortcut bar looks, right-click in an empoy space on the shortcut bar. From the menu that appears, you can select icon sizes. + + You don't need the folder bar to move between folders. You + can use File Go + to Folder... to move to a + particular foder. It's faster, however, to click on the + Inbox label just below the toolbar, to + the right of the shortcut bar, and select a folder from + there. The Inbox label will change to + reflect your location in the folder tree. + @@ -200,18 +214,21 @@ at the top, and branches downwards. On most computers, there will be three folders at the base. The first one is VFolders, for virtual folders (discussed in - . The next one is - External Directories, for contact - directories stored on a network. The most important one is - probably Local, which you can use to access - all the data that's stored on your computer. If you click on - the plus sign plus sign next to the Local - folder, you'll see the contents: + . After that come + any IMAP mail folders you might have + available to you over your network. The next folder is called + External Directories, and holds + LDAP contact directories stored on a + network. The most important one is probably + Local, which you can use to access all the + data that's stored on your computer. If you click on the plus + sign plus sign next to the Local folder, + you'll see the contents: - Calendar, for appointments and - event listings. + Calendar, for appointments and + event listings. diff --git a/doc/ChangeLog b/doc/ChangeLog index fc9cdc0cf1..de7d5b808e 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,16 @@ +2000-08-31 Aaron Weber + + * C/preface.sgml: Added "quickref and pointers" sections. Props to + O'Reilly for the copy of Outlook in a Nutshell which gave me the + idea. + +2000-08-30 Aaron Weber + + * C/usage-mainwindow.sgml: Minor fixes. + + * C/preface.sgml: Corrected grammar, added glossterms, described + menuref. + 2000-08-25 Aaron Weber * C/usage-mail.sgml: Redid filter and vFolder assistant diff --git a/help/C/.cvsignore b/help/C/.cvsignore index cba1534920..2f4c48adbf 100644 --- a/help/C/.cvsignore +++ b/help/C/.cvsignore @@ -2,3 +2,8 @@ Makefile Makefile.in evolution-guide evolution-guide.junk +evolution-guide.log +evolution-guide.ps +evolution-guide.dvi +evolution-guide.tex +fig/*.eps \ No newline at end of file diff --git a/help/C/evolution-guide.sgml b/help/C/evolution-guide.sgml index b9b5f72adb..f7a7a87ab2 100644 --- a/help/C/evolution-guide.sgml +++ b/help/C/evolution-guide.sgml @@ -48,7 +48,7 @@ GNU General Public License, or GPL. - The licenses are included with this document in , and ; you may also obtain a copy from the Free Software Foundation by visiting their Web site or @@ -102,11 +102,11 @@ Evolution is highly configurable. Usually, when developers say that, they mean that they didn't test it out thoroughly and have left it to other hackers to - "configure" themselves a working system. When we say - configurable, we mean that although - Evolution will work perfectly well - with minimal setup hassle, you can alter its behavior to fit - your needs with just a little more work. + "configure" themselves a working system. But in the case of + Evolution, you can expect that it + will work perfectly well with minimal setup hassle, and that + you can alter its behavior to fit your needs with just a + little more work. diff --git a/help/C/preface.sgml b/help/C/preface.sgml index bb6cb4d948..c7f6c2824d 100644 --- a/help/C/preface.sgml +++ b/help/C/preface.sgml @@ -1,10 +1,13 @@ - + + Introduction -
- What is Evolution, and What Can It Do for Me? + + What is Evolution, and What Can It Do for Me? The word "evolution" means "a process of improvement and development." The GNOME application @@ -17,8 +20,7 @@ Evolution is free software. The program and its source code are released under the terms of the GNU Public License (GPL), and the documentation falls - under the Free Documentation License (FDL), which is included - with this document (). For more + under the Free Documentation License (FDL). For more information about the GPL and the FDL, visit the Free Software Foundation's website at http://www.fsf.org. @@ -75,18 +77,17 @@ to turn Evolution into an advanced development platform. From the simplest scripting to the most complex network and component - programming, Evolution - needed to offer developers an environment for - cutting-edge application development. + programming, Evolution must + to offer developers an environment for cutting-edge + application development. Data must be safe: Evolution - must not lose mail or corrupt mailbox files. It will - not execute scripts, automatically forward a virus to - your entire contacts list, or delete files from your - hard disk. + must not not lose mail, corrupt mailbox files or other + data, execute arbitrary scripts, or delete files from + your hard disk. @@ -105,9 +106,9 @@ folders. -
+ -
+ About This Book @@ -119,21 +120,26 @@ guide to aaron@helixcode.com. If you would like to work on the guide please contact me or see the GNOME Documentation project web site. This - paragraph will be removed in later versions of the manual. + url="http://developer.gnome.org/projects/gdp">web + site. This paragraph will be removed in later + versions of the manual. - This book is divided into two sections. The first section is a - guided tour— it will - explain how to use Evolution. If - you are new to Evolution or to - groupware in general, this is the section for you. The second - section, covering configuration, - is targeted at more advanced users, but anyone who wants to + This book is divided into two parts, with several + appendicies. The first part is a guided + tour— it will explain how to use + Evolution. If you are new to + Evolution or to groupware in + general, this is the section for you. The second section, + covering configuration, is + targeted at more advanced users, but anyone who wants to change the way Evolution looks or - acts can benefit from reading it. + acts can benefit from reading it. In addition, there is a + comprehensive menu + reference which describes nearly every capability that + Evolution has to offer. Typographical conventions @@ -154,11 +160,238 @@ Buttons you can click Anything you type in Text output from a computer - + Words that are defined + in . -
+ + + A Quick Reference to Common Tasks + + You might want to copy the next few pages and tape them to the + wall next to your computer: They contain a very short run-down + of most of the things you'll want to do with + Evolution, and pointers to the + sections of the book where you'll find more in-depth + description of those tasks. + + + Opening or Creating Anything + + Here are the keyboard shortcuts and menu items you're most + likely to use: (Please note that the shortcuts listed are + probably wrong at this point). + + + + + Create a new folder + + + FileNew + Folder or + + Ctrl + Shift + F + + + + + + + Create a new Shortcut in the Evolution Bar + + + File + New + Evolution Bar Shortcut or + + Ctrl + Shift + S + + + + + + + Create a new email message: + + + Use + FileNewMail + Message or + + Ctrl + Shift + M + + + + + + + Create a new Appointment + + + File + New + Appointment or + + Ctrl + Shift + A + + + + + + + Create a new Task + + + File + New + Task or + + Ctrl + Shift + T + + + + + + + + Enter a new Contact + + + File + New + Contact or + + Ctrl + Shift + C + + + + + + + + + + + Mail Tasks + + Here are the most frequent email tasks: + + + Check Mail + + + Click Get Mail in the toolbar, or press + + FIXME + FIXME + FIXME + + + + + + + Reply to Message + + + Select the message to which you want to reply, and + click Click Reply in the + toolbar, or press + + FIXME + FIXME + FIXME + + + + + + + Forward Message + + + Select the message you want to forward, and + click Click Forward in the + toolbar, or press + + FIXME + FIXME + FIXME + + + + + + + Create Filters and vFolders + + + You can create filters and vFolders based on specific + message attributes by right-clicking on a message or + by selecting Tools + Mail Filters + or Tools + vFolder Editor + . Filters are discussed in , and vFolders + in . + + + + + + + + + Calendar + + + + + + + + + + + + + + + + + Contact Manager + + + + + + + + + + + + + + + + + diff --git a/help/C/usage-mainwindow.sgml b/help/C/usage-mainwindow.sgml index 8a71f2d4f2..370403415d 100644 --- a/help/C/usage-mainwindow.sgml +++ b/help/C/usage-mainwindow.sgml @@ -6,13 +6,14 @@ The Main Window: Evolution Basics Start Evolution by selecting - Evolution from the - Applications of the Main Panel - Menu, or by typing evolution at the - command-line. The first time you run the program, it will create - a directory called evolution in your home - directory, where it will keep all your - Evolution-related files. + Main Panel Menu + Applications + Evolution or by typing + evolution at the command line. The first time + you run the program, it will create a directory called + evolution in your home directory, where it + will keep all your Evolution-related + files. After Evolution starts @@ -88,7 +89,7 @@ Take a look at the Evolution Shortcuts - again. They are: + again. The shortcut buttons in that category are: @@ -165,27 +166,40 @@ - If you prefer to use a keyboard shortcut, or hot - key, you can use those instead. They're shown next - to their equivalent menu items in the menu bar. You can also set - your own hot keys for functions that don't have any; this is - covered in . If you're using the + If you don't like the shortcut bar, you can use keyboard + shortcuts, or hot keys. They're shown + next to their equivalent menu items in the menu bar. You can + also set your own hot keys for functions that don't have any; + this is covered in . If you're using the keyboard shortcuts you may also want to hide the - shortcut bar by selecting - View Show Shortcut + shortcut bar by selecting + View Show Shortcut Bar . - Two Shortcut Bar Tricks + Shortcut Bar Tricks To remove a shortcut from the shortcut bar, right-click on it - and select Remove. + and select Remove. To add one, + select File + New Evolution Bar + Shortcut . To change the way the shortcut bar looks, right-click in an empoy space on the shortcut bar. From the menu that appears, you can select icon sizes. + + You don't need the folder bar to move between folders. You + can use File Go + to Folder... to move to a + particular foder. It's faster, however, to click on the + Inbox label just below the toolbar, to + the right of the shortcut bar, and select a folder from + there. The Inbox label will change to + reflect your location in the folder tree. + @@ -200,18 +214,21 @@ at the top, and branches downwards. On most computers, there will be three folders at the base. The first one is VFolders, for virtual folders (discussed in - . The next one is - External Directories, for contact - directories stored on a network. The most important one is - probably Local, which you can use to access - all the data that's stored on your computer. If you click on - the plus sign plus sign next to the Local - folder, you'll see the contents: + . After that come + any IMAP mail folders you might have + available to you over your network. The next folder is called + External Directories, and holds + LDAP contact directories stored on a + network. The most important one is probably + Local, which you can use to access all the + data that's stored on your computer. If you click on the plus + sign plus sign next to the Local folder, + you'll see the contents: - Calendar, for appointments and - event listings. + Calendar, for appointments and + event listings. diff --git a/help/ChangeLog b/help/ChangeLog index fc9cdc0cf1..de7d5b808e 100644 --- a/help/ChangeLog +++ b/help/ChangeLog @@ -1,3 +1,16 @@ +2000-08-31 Aaron Weber + + * C/preface.sgml: Added "quickref and pointers" sections. Props to + O'Reilly for the copy of Outlook in a Nutshell which gave me the + idea. + +2000-08-30 Aaron Weber + + * C/usage-mainwindow.sgml: Minor fixes. + + * C/preface.sgml: Corrected grammar, added glossterms, described + menuref. + 2000-08-25 Aaron Weber * C/usage-mail.sgml: Redid filter and vFolder assistant -- cgit