From 5d5c636e5a8a3264a6a860c7f8ace9ebdf137ff5 Mon Sep 17 00:00:00 2001 From: Aaron Weber Date: Thu, 5 Oct 2000 08:35:01 +0000 Subject: Described Search features. 2000-10-05 Aaron Weber * C/usage-contact.sgml: Described Search features. * C/menuref.sgml: Contact Manager menus fixed. 2000-10-04 Aaron Weber * C/usage-contact.sgml: Fixed glossterms. * C/usage-mail.sgml: Fixed glossterms, filenames, spellchecked. * C/apx-gloss.sgml: Added "Inline," "VCard". * C/usage-mainwindow.sgml: Fixed glossterms, filenames. Spellchecked. * C/usage-mail.sgml: Fixed glossterms, filenames. Spellchecked. * C/evolution-guide.sgml: New Legalnotice. Removed FDL and GPL, which are now included as part of the gnome-help package. * C/usage-contact.sgml: Spellcheck. Fixed some wording, and responded to clahey's suggestions-- notably, commented out the "add to master list" category feature. (Not sure if this one is posted twice, because I keep overlapping days. svn path=/trunk/; revision=5744 --- doc/C/apx-bugs.sgml | 8 +- doc/C/apx-gloss.sgml | 63 ++++++++++++---- doc/C/evolution-guide.sgml | 67 +++++++---------- doc/C/menuref.sgml | 70 +++++++++++++++-- doc/C/preface.sgml | 45 ++++++----- doc/C/usage-contact.sgml | 173 +++++++++++++++++++++++++++++++------------ doc/C/usage-mail.sgml | 63 ++++++++-------- doc/C/usage-mainwindow.sgml | 37 ++++----- doc/ChangeLog | 64 ++++++++++++++++ help/C/apx-bugs.sgml | 8 +- help/C/apx-gloss.sgml | 63 ++++++++++++---- help/C/evolution-guide.sgml | 67 +++++++---------- help/C/menuref.sgml | 70 +++++++++++++++-- help/C/preface.sgml | 45 ++++++----- help/C/usage-contact.sgml | 173 +++++++++++++++++++++++++++++++------------ help/C/usage-mail.sgml | 63 ++++++++-------- help/C/usage-mainwindow.sgml | 37 ++++----- help/ChangeLog | 64 ++++++++++++++++ 18 files changed, 820 insertions(+), 360 deletions(-) diff --git a/doc/C/apx-bugs.sgml b/doc/C/apx-bugs.sgml index e7a501acba..e4a96a8155 100644 --- a/doc/C/apx-bugs.sgml +++ b/doc/C/apx-bugs.sgml @@ -12,8 +12,12 @@ - The bugs are many, but the application is young, and this is to - be expected. + Evolution is still beta software, so the bug tracking is best + left to the bugzilla system and to the programmers. However, + there are a number of limitations that will not be addressed + before version 1.0. The most notable are: Import of Microsoft + Outlook .pst files, and compatibility with the Microsoft + Exchange protocol. diff --git a/doc/C/apx-gloss.sgml b/doc/C/apx-gloss.sgml index 7aa5e494dc..24203f64a6 100644 --- a/doc/C/apx-gloss.sgml +++ b/doc/C/apx-gloss.sgml @@ -46,19 +46,17 @@ - + Emoticon @@ -95,6 +93,23 @@ + + + File Tree + + + A way of describing a group of files on a computer. With the + perversity typical of computer (and especially Unix and Linux) + nomenclature, the top of the tree is called the root directory, + and denoted by /. + The rest of the "branches" spread downwards from the root. Don't + confuse the root directory with the root + account, or root's home directory, + /home/root. + + + + Filter @@ -186,6 +201,18 @@ + + + + Inline + + + Displayed as part of a message or other document, rather than + attached as a separate file. Contrast with Attachment. + + + LDAP @@ -285,12 +312,9 @@ Script - A program, which is written in an interpreted (rather than - compiled) language. Scripts are more likely to work on multiple - platforms, but they require an additional layer of software (the - interpreter) which mediates between them and the operating system. - Because of this, they typically suffer from relatively sluggish - performance, and are limited to smaller tasks. + A program written in an interpreted (rather than compiled) + language. Often used as a synonym for "macro," to denote a series + of pre-recorded commands or actions within an application. @@ -354,8 +378,7 @@ newsletters." - < -/glossentry> + Virus @@ -369,6 +392,18 @@ + + vCard + + + A file format for the exchange of contact information. When you + get an address card attached to an email, it's probably in vCard + format. Not to be confused with vFolder. + + + + vFolder diff --git a/doc/C/evolution-guide.sgml b/doc/C/evolution-guide.sgml index 8ec98271cc..310eea5711 100644 --- a/doc/C/evolution-guide.sgml +++ b/doc/C/evolution-guide.sgml @@ -1,4 +1,4 @@ - @@ -13,8 +13,6 @@ - - ]> @@ -34,44 +32,38 @@ implemented. --> 2000 - Helix Code, Inc., - Kevin Breit + Helix Code, Inc., + Kevin Breit - - - Permission is granted to copy, distribute and/or modify this - document under the terms of the GNU Free - Documentation License, (FDL) Version 1.1 or any later - version published by the Free Software Foundation with no - Invariant Sections, no Front-Cover Texts, and no Back-Cover - Texts. - - - The software described by this document falls under the - GNU General Public License, or GPL. - - - These 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 - by writing to: Free Software Foundation, Inc., 59 Temple Place - - Suite 330, Boston, MA 02111-1307, USA. - - - Many of the names used by companies to distinguish their - products and services are claimed as trademarks. Where those - names appear in any GNOME documentation, and those trademarks - are made aware to the members of the GNOME Documentation - Project, the names have been printed in caps or initial caps. - - + + + + Permission is granted to copy, distribute and/or modify this + document under the terms of the GNU Free Documentation + License, Version 1.1 or any later version + published by the Free Software Foundation with no Invariant + Sections, no Front-Cover Texts, and no Back-Cover Texts. You + may obtain a copy of the GNU Free Documentation + License from the Free Software Foundation by + visiting their + Web site or by writing to: Free Software Foundation, + Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, + USA. + + + Many of the names used by companies to distinguish their + products and services are claimed as trademarks. Where those + names appear in any GNOME documentation, and those trademarks + are made aware to the members of the GNOME Documentation + Project, the names have been printed in caps or initial caps. + - This is version 0.4 of the Evolution manual, describing version - 0.3.1 of Evolution. + This is version 0.6 of the Evolution manual, describing version + 0.6 of Evolution. @@ -136,9 +128,6 @@ implemented. --> &APX-GLOSS; &APX-BUGS; &APX-AUTHORS; - &APX-FDL; - &APX-GPL; - diff --git a/doc/C/menuref.sgml b/doc/C/menuref.sgml index a3ba7e7b34..28e2da4ff7 100644 --- a/doc/C/menuref.sgml +++ b/doc/C/menuref.sgml @@ -1122,7 +1122,10 @@ Contact Manager Menus - Insert Content Here (FIXME). + The contact manager has six menus: File, + Edit, View, + Settings, Tools, and + Help. @@ -1171,7 +1174,17 @@ Contact Manager Tools Menu - This menu is empty. + This menu contains one item: + + + + Search for + Contacts Brings up + the in-depth search window. describes how to use this + feature. + + @@ -1188,11 +1201,56 @@ The Contact Editor Menus - Most, if not all, of the menu items for this section are still - inoperable, but there are vast numbers of them, especially in - the Actions menu. When available, I will - describe them. + This window has only one menu: the file menu. + + + Contact Editor File Menu + + This menu contains five items: + + + + Save + + + + + + + Save As + + Allows you to save the contact as an external + file in the VCard format. + + + + + Print + + Prints the current contact. + + + + + + Delete + + Deletes the current contact. + + + + + + Close + + Closes the Contact Editor without saving. + + + + + + diff --git a/doc/C/preface.sgml b/doc/C/preface.sgml index 5e74a2ce0e..d760d5b00a 100644 --- a/doc/C/preface.sgml +++ b/doc/C/preface.sgml @@ -15,7 +15,7 @@ Evolution's goal is to make the tasks of storing, organizing, and retrieving information easier, so you can work and communicate with others. That is, - it's a more evolved groupware program, + it's a more evolved groupware program, an integral part of the Internet-connected desktop. On the inside, it's a powerful database; on the outside, it's a tool to help you get your work done. @@ -24,10 +24,13 @@ Because it's part of the GNOME project, 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). For more - information about the GPL and the FDL, visit the Free Software - Foundation's website at GNU + Public License (GPL), and the + documentation falls 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. @@ -71,20 +74,21 @@ Evolution must meet and exceed the standards set by other groupware products. - It must include support for most major network protocols - so that it can integrate seamlessly with existing - hardware and network environments. + It must include support for most major network + protocols so + that it can integrate seamlessly with existing hardware + and network environments. - The project must support open standards and protocols - to turn Evolution into an - advanced development platform. From the simplest - scripting to the most complex network and component - programming, Evolution must - to offer developers an environment for cutting-edge - application development. + The project must support open standards and be open to + expansion, so that it can become a development platform + as well as an application. From the simplest scripting + to the most complex network and component programming, + Evolution must offer + developers an environment for cutting-edge application + development. @@ -163,11 +167,12 @@ Menu Item - Buttons you can click - Anything you type in - Text output from a computer - Words that are defined - in . + Buttons you can + click Anything you type + in Text + output from a computer + Words + that are defined in . diff --git a/doc/C/usage-contact.sgml b/doc/C/usage-contact.sgml index e983a2367d..f4d7e50ebc 100644 --- a/doc/C/usage-contact.sgml +++ b/doc/C/usage-contact.sgml @@ -13,7 +13,7 @@ actual paper book. Evolution also allows easy synchronization with hand-held and remote devices. Since Evolution supports most major - network protocols, including LDAP, it can + network protocols, including LDAP, it can fit into almost any existing network. @@ -41,14 +41,15 @@ To open up your address book, click on - Contacts in the shortcut bar. The - contact manager is illustrated in . By default, the contact manager - shows all your cards in alphabetical order, in a - minicard format. You can select other - views from the View menu, and adjust the - width of the columns by clicking and dragging the grey column - dividers. + Contacts in the shortcut bar, or select + one of your contacts folders from the folder bar. shows the Contact Manager in all + its organizational glory. By default, the contact manager + shows all your cards in alphabetical order, in a minicard format. You can select + other views from the View menu, and adjust + the width of the columns by clicking and dragging the grey + column dividers. @@ -79,39 +80,94 @@ Delete deletes a selected card. - - Show All Shows all cards. - - - - Stop Stop loading card data from the network. - + View All Displays all + the address information in the folder. Use this button to + refresh the display for a network folder, or to switch from + viewing the results of a search and see the whole contents. + + Stop Stop loading + contact data from the network. This button is only + relevant if you are looking at contact information on a + network. - - The last feature is Quick Search; to use - it, just type in the name of the person you're looking for and - hit Enter. - Evolution will search through all - the cards to find one that matches. - - - If there are no matches, the card display will be blank. When - you'd like to see all the cards again, press Show - All. - + The rest of the contact manager is taken up by the display of - your cards. You can view that display as a table or as a list - of cards— switch views in the View - menu — and move through them alphabetically with the - buttons and the scrollbar at the right of the window. + your contact information. You can view that display as a table + or as a list of cards— switch views in the + View menu — and move through them + alphabetically with the buttons and the scrollbar at the right + of the window. Of course, if you have more than a few people + listed, you'll want some way of finding them more quickly, + which is why there's a search feature. + + + Searching for Contacts + + Between Delete and View + All is Quick Search. To use + it, just type in one or more words you're looking for and + hit Enter. + Evolution will search through + the contents of every displayed card to find one that + matches. That means that you can refine searches by doing several in + succession. + + + If there are no matches, the card display will be blank. When + you'd like to see all the cards again, press Show + All. + + + Refining a Quick Search + + Tom comes back from lunch and finds a note on his keyboard: + "Curtis in sales called for you, but he didn't leave a number, + and I forgot to write down the name of the company he works + for. He said it was important, though." Tom is not at all + annoyed. + + + He opens his contacts folder, and runs a quick search for + "Curtis;" there are eighteen different people with that name + in the file. He then enters "Sales," and + Evolution narrows it down to the + right Curtis. He only becomes annoyed when he discovers that + the call was not actually important. + + + + + If you prefer to perform a more complex search, press + Find or choose + ToolsSearch for + Contact. This will open the in-depth search window, which + lets you use multiple search criteria in the same way that + email filters and vFolders do.. + + + Click Add Criterion to increase the + number of criteria you'd like to use in the search, and + Remove Criterion to remove one from the + bottom of the list. Your criteria may be a searchs within the + Name or Email + fields; alternately you can choose to search through all the + fields with a regular expression. Then, you can select all + the familiar requirements like Begins + With and Does Not Contain, + decide whether to match All or + Any of your criteria, and press + Search to set it all off. + + + + - Destroy, Create, or Change Cards - + Destroy, Create, and Change: The Contact Editor To delete a card, click on it once to select it, then press the Delete Card button. If you have @@ -136,8 +192,13 @@ The contact editor window has two tabs, General, for basic contact information, and Details, for a more specific - description of the person. In addition, it contains a full - menu bar, covered in . + description of the person. In addition, it contains a + File menu, covered in , and a toolbar with three + items: Save and Close, + Print, and Delete. + After that, however, it gets slightly more complicated, as you + can see in .
@@ -152,19 +213,14 @@ The General tab contains no less than seven sections, each with an icon: a face, for name and company; a telephone for phone numbers; an envelope for email - address; a house for postal address; a file folder for - contacts, and a briefcase for categories. You can guess what - sort of information belongs in fields like Job - Title and Web page address, - but there are several parts of the window that are a little - more interesting. + address; a globe for web page address; a house for postal + address; a file folder for contacts, and a briefcase for + categories. You can guess what sort of information belongs in + fields like Job Title and Web + page address, but there are several parts of the + window that are a little more interesting. - For more information about the Categories - organization tool, have a look at . The rest of the features in - the window are here: - Full Name @@ -264,6 +320,27 @@ + + The last item in the General tab is the + Categories organization tool. That's + really its own topic; for information on that, read . + + + The Details tab is, fortunately, much more + simple: three sections, all of which are more or less obvious: + the briefcase next to the details about the contact's + professional life; the face next to the details about their + personal life; the globe next to a big blank space you can use + for anything and everything else you'd like to note about them. + If you ever wanted to have that uncanny knack for remembering + obscure details like the date of someone's anniversary (perhaps + your own) this is the answer. + + + + + - It supports multiple mail sources, including IMAP, POP3, - local mbox files, and even NNTP data - (newsgroups), which isn't technically email. + It supports multiple mail sources, including IMAP, POP3, local + mbox and + mh files, and + even NNTP data (newsgroups), which isn't technically email. @@ -123,7 +126,7 @@ implemented with a stable UI yet, and are described wrong --> Expunge Clicking the Delete button marks - messages for deleteion. Expunge + messages for deletion. Expunge wipes them off the face of the earth. @@ -183,13 +186,14 @@ implemented with a stable UI yet, and are described wrong --> Before you get it, though, you should decide where you want to keep it. Your options will vary a little depending on your network setup, but they come down to storing the mail on your - hard disk (using POP), or storing it on - the network (using IMAP). If you store - your mail on your local hard disk, you can read it whether - you're online or not, but you can only read it from one - computer. If you store it on the network, you can only read - it when you're online, but you can access it from almost any - computer with a network connection, even if it doesn't have + hard disk (using POP), or + storing it on the network (using IMAP). If you store your mail on + your local hard disk, you can read it whether you're online or + not, but you can only read it from one computer. If you store + it on the network, you can only read it when you're online, + but you can access it from almost any computer with a network + connection, even if it doesn't have Evolution. @@ -210,11 +214,11 @@ implemented with a stable UI yet, and are described wrong --> needs to check your mail (see for more information). If you're checking mail over a network (instead of from local - mbox files), you'll need to enter your - email password. Type it in, click OK - and Evolution will download your - mail. New mail will appear in your - Inbox. + mbox files), + you'll need to enter your email password. Type it in, click + OK and + Evolution will download your mail. + New mail will appear in your Inbox. Once you've entered your password, @@ -278,16 +282,6 @@ implemented with a stable UI yet, and are described wrong --> turn it off if you prefer. - - @@ -567,7 +561,8 @@ with quoted materials and the relevant replies interspersed--> Find Regex - Perform a search for a regular + Perform a search for a regular expression, or "regex." @@ -607,7 +602,7 @@ with quoted materials and the relevant replies interspersed--> You can't normally use text treatments or pictures in emails, which is why you've probably seen people use far too many exclamation points for emphasis or use - emoticons to convey their feelings. + emoticons to convey their feelings. However, most of the newer email programs can include and display images and text treatments as well as basic alignment and paragraph formatting. @@ -704,7 +699,7 @@ with quoted materials and the relevant replies interspersed--> At the far right is the color section tool. You can - choose from several colors by clickin on the arrow, + choose from several colors by clicking on the arrow, or create your own custom color by clicking on the color box itself. If you have text selected, the color will apply to the selected text. If you do @@ -798,7 +793,7 @@ possibly never will be due to security evil. --> have received a message and you think someone else would like to see it. You can forward a message as an attachment to a new message (this is the default) or - you can send it inline as a quoted + you can send it inline as a quoted portion of the message you are sending. Attachment forwarding is best if you want to send the full, unaltered message on to someone else. Inline forwarding is best if @@ -813,7 +808,7 @@ possibly never will be due to security evil. --> Forward on the toolbar, or select Message Forward . If you - prefer to forward the message inline + prefer to forward the message inline instead of attached, select Message Forward Inline from the menu. Choose an @@ -828,7 +823,7 @@ possibly never will be due to security evil. --> Seven Tips for Email Usage I started with ten, but four were "Don't send - spam." + spam." @@ -1140,7 +1135,7 @@ possibly never will be due to security evil. --> Expression - Enter a regular expression, and + Enter a regular expression, and Evolution will match it for you. @@ -1339,7 +1334,7 @@ possibly never will be due to security evil. --> - To create a vFolder, select VFolder + To create a vFolder, select vFolder Editor from the Tools menu in the main window. This will bring up a dialog box that looks suspiciously like diff --git a/doc/C/usage-mainwindow.sgml b/doc/C/usage-mainwindow.sgml index 394c634c27..900f8a8866 100644 --- a/doc/C/usage-mainwindow.sgml +++ b/doc/C/usage-mainwindow.sgml @@ -150,24 +150,26 @@ ---> + Notes: The note pad is your catch-all tool: use it to take messages from phone conversations, keep small things - organized, write haiku, or whatever + organized, write haiku, or whatever you like. This feature is not yet implemented, but will be soon. See for more information. +--> + If you don't like the shortcut bar, you can use the menu bar, or - keyboard shortcuts, also called hot keys. + keyboard shortcuts, also called 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 @@ -187,14 +189,14 @@ Shortcut . To change the way the shortcut bar looks, right-click in an - empoy space on the shortcut bar. From the menu that appears, + empty 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 + particular folder. 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 @@ -210,16 +212,17 @@ way to view the information you've stored with Evolution. It displays all your appointments, address cards, and email in a tree that's a lot - like a file tree— it starts small - 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 - . 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 + like a file + tree— it starts small at the top, and branches + downwards. On most computers, there will be three folders at the + base. At the top are your vFolders, or + virtual folders, discussed in . 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, @@ -266,7 +269,7 @@ Contacts for storing contacts. - + Folders Have Limits You can always place a folder inside other folders, @@ -308,7 +311,7 @@ To delete a folder, right-click it and select Delete from the menu that pops up. To change the order of folders, or put one inside another, use - drag-and-drop. To move individual + drag-and-drop. To move individual messages, appointments, and address cards between folders, you can do the same thing: drag them where you want them, and they'll go. diff --git a/doc/ChangeLog b/doc/ChangeLog index 501a85e914..40bb14634b 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,67 @@ +2000-10-05 Aaron Weber + + * C/usage-contact.sgml: Described Search features. + + * C/menuref.sgml: Contact Manager menus fixed. + +2000-10-04 Aaron Weber + + * C/usage-contact.sgml: Fixed glossterms. + + * C/usage-mail.sgml: Fixed glossterms, filenames, spellchecked. + + * C/apx-gloss.sgml: Added "Inline," "VCard". + + * C/usage-mainwindow.sgml: Fixed glossterms, filenames. Spellchecked. + + * C/usage-mail.sgml: Fixed glossterms, filenames. Spellchecked. + + * C/evolution-guide.sgml: New Legalnotice. Removed FDL and GPL, + which are now included as part of the gnome-help package. + + * C/usage-contact.sgml: Spellcheck. Fixed some wording, and + responded to clahey's suggestions-- notably, commented out the + "add to master list" category feature. + + * C/usage-calendar.sgml: Spellcheck. Fixed wording, event overlap + description. + + * C/evolution-guide.sgml: Spellcheck. Commented out Notes + entities. + + * C/usage-notes.sgml: Spellchecked, then decided to comment out + this file/chapter and all references to it, since it's unlikely to + be implemented any time soon. + + * C/config-setupassist.sgml: Spellcheck. Other minor updates. May + need more work in the near future. + + * C/usage-sync.sgml: Now it's really short. And spelled correctly. + +2000-10-03 Aaron Weber + + * C/config-prefs.sgml: Mostly spelling. Still needs major + alteration. + + * C/menuref.sgml: s/Appintment/Appointment, fixed small errors, + ran spellcheck. Still needs lots of work, since many menus have + changed. + + * C/apx-gloss.sgml: Added Virus, Protocol, fixed vFolder, + spellchecked. + +2000-09-26 Aaron Weber + + * C/apx-gloss.sgml: Added sendmail and SMTP. + +2000-09-22 Aaron Weber + + * C/menuref.sgml: Changed to reflect new menu layout. + + * C/usage-mainwindow.sgml: Changed to reflect new menu layout. Again. + + * C/usage-contact.sgml: Stop and Display All features. + 2000-09-21 Aaron Weber * C/evolution-guide.sgml: Switched to the "official" FSF markup. diff --git a/help/C/apx-bugs.sgml b/help/C/apx-bugs.sgml index e7a501acba..e4a96a8155 100644 --- a/help/C/apx-bugs.sgml +++ b/help/C/apx-bugs.sgml @@ -12,8 +12,12 @@ - The bugs are many, but the application is young, and this is to - be expected. + Evolution is still beta software, so the bug tracking is best + left to the bugzilla system and to the programmers. However, + there are a number of limitations that will not be addressed + before version 1.0. The most notable are: Import of Microsoft + Outlook .pst files, and compatibility with the Microsoft + Exchange protocol. diff --git a/help/C/apx-gloss.sgml b/help/C/apx-gloss.sgml index 7aa5e494dc..24203f64a6 100644 --- a/help/C/apx-gloss.sgml +++ b/help/C/apx-gloss.sgml @@ -46,19 +46,17 @@ - + Emoticon @@ -95,6 +93,23 @@ + + + File Tree + + + A way of describing a group of files on a computer. With the + perversity typical of computer (and especially Unix and Linux) + nomenclature, the top of the tree is called the root directory, + and denoted by /. + The rest of the "branches" spread downwards from the root. Don't + confuse the root directory with the root + account, or root's home directory, + /home/root. + + + + Filter @@ -186,6 +201,18 @@ + + + + Inline + + + Displayed as part of a message or other document, rather than + attached as a separate file. Contrast with Attachment. + + + LDAP @@ -285,12 +312,9 @@ Script - A program, which is written in an interpreted (rather than - compiled) language. Scripts are more likely to work on multiple - platforms, but they require an additional layer of software (the - interpreter) which mediates between them and the operating system. - Because of this, they typically suffer from relatively sluggish - performance, and are limited to smaller tasks. + A program written in an interpreted (rather than compiled) + language. Often used as a synonym for "macro," to denote a series + of pre-recorded commands or actions within an application. @@ -354,8 +378,7 @@ newsletters." - < -/glossentry> + Virus @@ -369,6 +392,18 @@ + + vCard + + + A file format for the exchange of contact information. When you + get an address card attached to an email, it's probably in vCard + format. Not to be confused with vFolder. + + + + vFolder diff --git a/help/C/evolution-guide.sgml b/help/C/evolution-guide.sgml index 8ec98271cc..310eea5711 100644 --- a/help/C/evolution-guide.sgml +++ b/help/C/evolution-guide.sgml @@ -1,4 +1,4 @@ - @@ -13,8 +13,6 @@ - - ]> @@ -34,44 +32,38 @@ implemented. --> 2000 - Helix Code, Inc., - Kevin Breit + Helix Code, Inc., + Kevin Breit - - - Permission is granted to copy, distribute and/or modify this - document under the terms of the GNU Free - Documentation License, (FDL) Version 1.1 or any later - version published by the Free Software Foundation with no - Invariant Sections, no Front-Cover Texts, and no Back-Cover - Texts. - - - The software described by this document falls under the - GNU General Public License, or GPL. - - - These 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 - by writing to: Free Software Foundation, Inc., 59 Temple Place - - Suite 330, Boston, MA 02111-1307, USA. - - - Many of the names used by companies to distinguish their - products and services are claimed as trademarks. Where those - names appear in any GNOME documentation, and those trademarks - are made aware to the members of the GNOME Documentation - Project, the names have been printed in caps or initial caps. - - + + + + Permission is granted to copy, distribute and/or modify this + document under the terms of the GNU Free Documentation + License, Version 1.1 or any later version + published by the Free Software Foundation with no Invariant + Sections, no Front-Cover Texts, and no Back-Cover Texts. You + may obtain a copy of the GNU Free Documentation + License from the Free Software Foundation by + visiting their + Web site or by writing to: Free Software Foundation, + Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, + USA. + + + Many of the names used by companies to distinguish their + products and services are claimed as trademarks. Where those + names appear in any GNOME documentation, and those trademarks + are made aware to the members of the GNOME Documentation + Project, the names have been printed in caps or initial caps. + - This is version 0.4 of the Evolution manual, describing version - 0.3.1 of Evolution. + This is version 0.6 of the Evolution manual, describing version + 0.6 of Evolution. @@ -136,9 +128,6 @@ implemented. --> &APX-GLOSS; &APX-BUGS; &APX-AUTHORS; - &APX-FDL; - &APX-GPL; - diff --git a/help/C/menuref.sgml b/help/C/menuref.sgml index a3ba7e7b34..28e2da4ff7 100644 --- a/help/C/menuref.sgml +++ b/help/C/menuref.sgml @@ -1122,7 +1122,10 @@ Contact Manager Menus - Insert Content Here (FIXME). + The contact manager has six menus: File, + Edit, View, + Settings, Tools, and + Help. @@ -1171,7 +1174,17 @@ Contact Manager Tools Menu - This menu is empty. + This menu contains one item: + + + + Search for + Contacts Brings up + the in-depth search window. describes how to use this + feature. + + @@ -1188,11 +1201,56 @@ The Contact Editor Menus - Most, if not all, of the menu items for this section are still - inoperable, but there are vast numbers of them, especially in - the Actions menu. When available, I will - describe them. + This window has only one menu: the file menu. + + + Contact Editor File Menu + + This menu contains five items: + + + + Save + + + + + + + Save As + + Allows you to save the contact as an external + file in the VCard format. + + + + + Print + + Prints the current contact. + + + + + + Delete + + Deletes the current contact. + + + + + + Close + + Closes the Contact Editor without saving. + + + + + + diff --git a/help/C/preface.sgml b/help/C/preface.sgml index 5e74a2ce0e..d760d5b00a 100644 --- a/help/C/preface.sgml +++ b/help/C/preface.sgml @@ -15,7 +15,7 @@ Evolution's goal is to make the tasks of storing, organizing, and retrieving information easier, so you can work and communicate with others. That is, - it's a more evolved groupware program, + it's a more evolved groupware program, an integral part of the Internet-connected desktop. On the inside, it's a powerful database; on the outside, it's a tool to help you get your work done. @@ -24,10 +24,13 @@ Because it's part of the GNOME project, 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). For more - information about the GPL and the FDL, visit the Free Software - Foundation's website at GNU + Public License (GPL), and the + documentation falls 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. @@ -71,20 +74,21 @@ Evolution must meet and exceed the standards set by other groupware products. - It must include support for most major network protocols - so that it can integrate seamlessly with existing - hardware and network environments. + It must include support for most major network + protocols so + that it can integrate seamlessly with existing hardware + and network environments. - The project must support open standards and protocols - to turn Evolution into an - advanced development platform. From the simplest - scripting to the most complex network and component - programming, Evolution must - to offer developers an environment for cutting-edge - application development. + The project must support open standards and be open to + expansion, so that it can become a development platform + as well as an application. From the simplest scripting + to the most complex network and component programming, + Evolution must offer + developers an environment for cutting-edge application + development. @@ -163,11 +167,12 @@ Menu Item - Buttons you can click - Anything you type in - Text output from a computer - Words that are defined - in . + Buttons you can + click Anything you type + in Text + output from a computer + Words + that are defined in . diff --git a/help/C/usage-contact.sgml b/help/C/usage-contact.sgml index e983a2367d..f4d7e50ebc 100644 --- a/help/C/usage-contact.sgml +++ b/help/C/usage-contact.sgml @@ -13,7 +13,7 @@ actual paper book. Evolution also allows easy synchronization with hand-held and remote devices. Since Evolution supports most major - network protocols, including LDAP, it can + network protocols, including LDAP, it can fit into almost any existing network. @@ -41,14 +41,15 @@ To open up your address book, click on - Contacts in the shortcut bar. The - contact manager is illustrated in . By default, the contact manager - shows all your cards in alphabetical order, in a - minicard format. You can select other - views from the View menu, and adjust the - width of the columns by clicking and dragging the grey column - dividers. + Contacts in the shortcut bar, or select + one of your contacts folders from the folder bar. shows the Contact Manager in all + its organizational glory. By default, the contact manager + shows all your cards in alphabetical order, in a minicard format. You can select + other views from the View menu, and adjust + the width of the columns by clicking and dragging the grey + column dividers. @@ -79,39 +80,94 @@ Delete deletes a selected card. - - Show All Shows all cards. - - - - Stop Stop loading card data from the network. - + View All Displays all + the address information in the folder. Use this button to + refresh the display for a network folder, or to switch from + viewing the results of a search and see the whole contents. + + Stop Stop loading + contact data from the network. This button is only + relevant if you are looking at contact information on a + network. - - The last feature is Quick Search; to use - it, just type in the name of the person you're looking for and - hit Enter. - Evolution will search through all - the cards to find one that matches. - - - If there are no matches, the card display will be blank. When - you'd like to see all the cards again, press Show - All. - + The rest of the contact manager is taken up by the display of - your cards. You can view that display as a table or as a list - of cards— switch views in the View - menu — and move through them alphabetically with the - buttons and the scrollbar at the right of the window. + your contact information. You can view that display as a table + or as a list of cards— switch views in the + View menu — and move through them + alphabetically with the buttons and the scrollbar at the right + of the window. Of course, if you have more than a few people + listed, you'll want some way of finding them more quickly, + which is why there's a search feature. + + + Searching for Contacts + + Between Delete and View + All is Quick Search. To use + it, just type in one or more words you're looking for and + hit Enter. + Evolution will search through + the contents of every displayed card to find one that + matches. That means that you can refine searches by doing several in + succession. + + + If there are no matches, the card display will be blank. When + you'd like to see all the cards again, press Show + All. + + + Refining a Quick Search + + Tom comes back from lunch and finds a note on his keyboard: + "Curtis in sales called for you, but he didn't leave a number, + and I forgot to write down the name of the company he works + for. He said it was important, though." Tom is not at all + annoyed. + + + He opens his contacts folder, and runs a quick search for + "Curtis;" there are eighteen different people with that name + in the file. He then enters "Sales," and + Evolution narrows it down to the + right Curtis. He only becomes annoyed when he discovers that + the call was not actually important. + + + + + If you prefer to perform a more complex search, press + Find or choose + ToolsSearch for + Contact. This will open the in-depth search window, which + lets you use multiple search criteria in the same way that + email filters and vFolders do.. + + + Click Add Criterion to increase the + number of criteria you'd like to use in the search, and + Remove Criterion to remove one from the + bottom of the list. Your criteria may be a searchs within the + Name or Email + fields; alternately you can choose to search through all the + fields with a regular expression. Then, you can select all + the familiar requirements like Begins + With and Does Not Contain, + decide whether to match All or + Any of your criteria, and press + Search to set it all off. + + + + - Destroy, Create, or Change Cards - + Destroy, Create, and Change: The Contact Editor To delete a card, click on it once to select it, then press the Delete Card button. If you have @@ -136,8 +192,13 @@ The contact editor window has two tabs, General, for basic contact information, and Details, for a more specific - description of the person. In addition, it contains a full - menu bar, covered in . + description of the person. In addition, it contains a + File menu, covered in , and a toolbar with three + items: Save and Close, + Print, and Delete. + After that, however, it gets slightly more complicated, as you + can see in .
@@ -152,19 +213,14 @@ The General tab contains no less than seven sections, each with an icon: a face, for name and company; a telephone for phone numbers; an envelope for email - address; a house for postal address; a file folder for - contacts, and a briefcase for categories. You can guess what - sort of information belongs in fields like Job - Title and Web page address, - but there are several parts of the window that are a little - more interesting. + address; a globe for web page address; a house for postal + address; a file folder for contacts, and a briefcase for + categories. You can guess what sort of information belongs in + fields like Job Title and Web + page address, but there are several parts of the + window that are a little more interesting. - For more information about the Categories - organization tool, have a look at . The rest of the features in - the window are here: - Full Name @@ -264,6 +320,27 @@ + + The last item in the General tab is the + Categories organization tool. That's + really its own topic; for information on that, read . + + + The Details tab is, fortunately, much more + simple: three sections, all of which are more or less obvious: + the briefcase next to the details about the contact's + professional life; the face next to the details about their + personal life; the globe next to a big blank space you can use + for anything and everything else you'd like to note about them. + If you ever wanted to have that uncanny knack for remembering + obscure details like the date of someone's anniversary (perhaps + your own) this is the answer. + + + + + - It supports multiple mail sources, including IMAP, POP3, - local mbox files, and even NNTP data - (newsgroups), which isn't technically email. + It supports multiple mail sources, including IMAP, POP3, local + mbox and + mh files, and + even NNTP data (newsgroups), which isn't technically email. @@ -123,7 +126,7 @@ implemented with a stable UI yet, and are described wrong --> Expunge Clicking the Delete button marks - messages for deleteion. Expunge + messages for deletion. Expunge wipes them off the face of the earth. @@ -183,13 +186,14 @@ implemented with a stable UI yet, and are described wrong --> Before you get it, though, you should decide where you want to keep it. Your options will vary a little depending on your network setup, but they come down to storing the mail on your - hard disk (using POP), or storing it on - the network (using IMAP). If you store - your mail on your local hard disk, you can read it whether - you're online or not, but you can only read it from one - computer. If you store it on the network, you can only read - it when you're online, but you can access it from almost any - computer with a network connection, even if it doesn't have + hard disk (using POP), or + storing it on the network (using IMAP). If you store your mail on + your local hard disk, you can read it whether you're online or + not, but you can only read it from one computer. If you store + it on the network, you can only read it when you're online, + but you can access it from almost any computer with a network + connection, even if it doesn't have Evolution. @@ -210,11 +214,11 @@ implemented with a stable UI yet, and are described wrong --> needs to check your mail (see for more information). If you're checking mail over a network (instead of from local - mbox files), you'll need to enter your - email password. Type it in, click OK - and Evolution will download your - mail. New mail will appear in your - Inbox. + mbox files), + you'll need to enter your email password. Type it in, click + OK and + Evolution will download your mail. + New mail will appear in your Inbox. Once you've entered your password, @@ -278,16 +282,6 @@ implemented with a stable UI yet, and are described wrong --> turn it off if you prefer. - - @@ -567,7 +561,8 @@ with quoted materials and the relevant replies interspersed--> Find Regex - Perform a search for a regular + Perform a search for a regular expression, or "regex." @@ -607,7 +602,7 @@ with quoted materials and the relevant replies interspersed--> You can't normally use text treatments or pictures in emails, which is why you've probably seen people use far too many exclamation points for emphasis or use - emoticons to convey their feelings. + emoticons to convey their feelings. However, most of the newer email programs can include and display images and text treatments as well as basic alignment and paragraph formatting. @@ -704,7 +699,7 @@ with quoted materials and the relevant replies interspersed--> At the far right is the color section tool. You can - choose from several colors by clickin on the arrow, + choose from several colors by clicking on the arrow, or create your own custom color by clicking on the color box itself. If you have text selected, the color will apply to the selected text. If you do @@ -798,7 +793,7 @@ possibly never will be due to security evil. --> have received a message and you think someone else would like to see it. You can forward a message as an attachment to a new message (this is the default) or - you can send it inline as a quoted + you can send it inline as a quoted portion of the message you are sending. Attachment forwarding is best if you want to send the full, unaltered message on to someone else. Inline forwarding is best if @@ -813,7 +808,7 @@ possibly never will be due to security evil. --> Forward on the toolbar, or select Message Forward . If you - prefer to forward the message inline + prefer to forward the message inline instead of attached, select Message Forward Inline from the menu. Choose an @@ -828,7 +823,7 @@ possibly never will be due to security evil. --> Seven Tips for Email Usage I started with ten, but four were "Don't send - spam." + spam." @@ -1140,7 +1135,7 @@ possibly never will be due to security evil. --> Expression - Enter a regular expression, and + Enter a regular expression, and Evolution will match it for you. @@ -1339,7 +1334,7 @@ possibly never will be due to security evil. --> - To create a vFolder, select VFolder + To create a vFolder, select vFolder Editor from the Tools menu in the main window. This will bring up a dialog box that looks suspiciously like diff --git a/help/C/usage-mainwindow.sgml b/help/C/usage-mainwindow.sgml index 394c634c27..900f8a8866 100644 --- a/help/C/usage-mainwindow.sgml +++ b/help/C/usage-mainwindow.sgml @@ -150,24 +150,26 @@ ---> + Notes: The note pad is your catch-all tool: use it to take messages from phone conversations, keep small things - organized, write haiku, or whatever + organized, write haiku, or whatever you like. This feature is not yet implemented, but will be soon. See for more information. +--> + If you don't like the shortcut bar, you can use the menu bar, or - keyboard shortcuts, also called hot keys. + keyboard shortcuts, also called 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 @@ -187,14 +189,14 @@ Shortcut . To change the way the shortcut bar looks, right-click in an - empoy space on the shortcut bar. From the menu that appears, + empty 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 + particular folder. 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 @@ -210,16 +212,17 @@ way to view the information you've stored with Evolution. It displays all your appointments, address cards, and email in a tree that's a lot - like a file tree— it starts small - 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 - . 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 + like a file + tree— it starts small at the top, and branches + downwards. On most computers, there will be three folders at the + base. At the top are your vFolders, or + virtual folders, discussed in . 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, @@ -266,7 +269,7 @@ Contacts for storing contacts. - + Folders Have Limits You can always place a folder inside other folders, @@ -308,7 +311,7 @@ To delete a folder, right-click it and select Delete from the menu that pops up. To change the order of folders, or put one inside another, use - drag-and-drop. To move individual + drag-and-drop. To move individual messages, appointments, and address cards between folders, you can do the same thing: drag them where you want them, and they'll go. diff --git a/help/ChangeLog b/help/ChangeLog index 501a85e914..40bb14634b 100644 --- a/help/ChangeLog +++ b/help/ChangeLog @@ -1,3 +1,67 @@ +2000-10-05 Aaron Weber + + * C/usage-contact.sgml: Described Search features. + + * C/menuref.sgml: Contact Manager menus fixed. + +2000-10-04 Aaron Weber + + * C/usage-contact.sgml: Fixed glossterms. + + * C/usage-mail.sgml: Fixed glossterms, filenames, spellchecked. + + * C/apx-gloss.sgml: Added "Inline," "VCard". + + * C/usage-mainwindow.sgml: Fixed glossterms, filenames. Spellchecked. + + * C/usage-mail.sgml: Fixed glossterms, filenames. Spellchecked. + + * C/evolution-guide.sgml: New Legalnotice. Removed FDL and GPL, + which are now included as part of the gnome-help package. + + * C/usage-contact.sgml: Spellcheck. Fixed some wording, and + responded to clahey's suggestions-- notably, commented out the + "add to master list" category feature. + + * C/usage-calendar.sgml: Spellcheck. Fixed wording, event overlap + description. + + * C/evolution-guide.sgml: Spellcheck. Commented out Notes + entities. + + * C/usage-notes.sgml: Spellchecked, then decided to comment out + this file/chapter and all references to it, since it's unlikely to + be implemented any time soon. + + * C/config-setupassist.sgml: Spellcheck. Other minor updates. May + need more work in the near future. + + * C/usage-sync.sgml: Now it's really short. And spelled correctly. + +2000-10-03 Aaron Weber + + * C/config-prefs.sgml: Mostly spelling. Still needs major + alteration. + + * C/menuref.sgml: s/Appintment/Appointment, fixed small errors, + ran spellcheck. Still needs lots of work, since many menus have + changed. + + * C/apx-gloss.sgml: Added Virus, Protocol, fixed vFolder, + spellchecked. + +2000-09-26 Aaron Weber + + * C/apx-gloss.sgml: Added sendmail and SMTP. + +2000-09-22 Aaron Weber + + * C/menuref.sgml: Changed to reflect new menu layout. + + * C/usage-mainwindow.sgml: Changed to reflect new menu layout. Again. + + * C/usage-contact.sgml: Stop and Display All features. + 2000-09-21 Aaron Weber * C/evolution-guide.sgml: Switched to the "official" FSF markup. -- cgit v1.2.3