From 788351db0a44bbbb19c2bc4b3962e5abfd001c69 Mon Sep 17 00:00:00 2001 From: Aaron Weber Date: Fri, 19 Jan 2001 07:25:16 +0000 Subject: More of Megan's revisions, and Field Chooser functions in the Sort 2001-01-19 Aaron Weber * C/usage-mail.sgml: More of Megan's revisions, and Field Chooser functions in the Sort section. * C/apx-gloss.sgml: added "ToolTip" 2001-01-18 Aaron Weber * C/preface.sgml: s/Helix Code/Ximian, and Megan's comments. * C/usage-mainwindow.sgml: s/Helix Code/Ximian/, and Megan's comments. * C/evolution-guide.sgml: s/Helix Code/Ximian/ svn path=/trunk/; revision=7638 --- doc/C/apx-gloss.sgml | 21 ++- doc/C/evolution-guide.sgml | 2 +- doc/C/preface.sgml | 93 ++++++------ doc/C/usage-mail.sgml | 353 +++++++++++++++++++++++--------------------- doc/C/usage-mainwindow.sgml | 47 +++--- doc/ChangeLog | 16 ++ 6 files changed, 290 insertions(+), 242 deletions(-) (limited to 'doc') diff --git a/doc/C/apx-gloss.sgml b/doc/C/apx-gloss.sgml index 365e64b60d..6124998862 100644 --- a/doc/C/apx-gloss.sgml +++ b/doc/C/apx-gloss.sgml @@ -372,14 +372,29 @@ Spam - Useless, unwanted e-mail. Spam normally comes in forms of - chain-letters and advertisements for unscrupulous web sites or - services. Messages that are merely useless are called "opt-in + Useless, unsolicited e-mail. Spam normally comes in forms of + chain letters and advertisements for unscrupulous or clueless + companies. Messages that are merely useless are called "opt-in newsletters." + + + Tool-Tip + + + A small box of explanatory text which appears when the mouse + pointer is held motionless over a button or other interface + element. + + + + + + + Virus diff --git a/doc/C/evolution-guide.sgml b/doc/C/evolution-guide.sgml index 5adc131eeb..dc2f5046aa 100644 --- a/doc/C/evolution-guide.sgml +++ b/doc/C/evolution-guide.sgml @@ -33,7 +33,7 @@ implemented. --> 2000 - Helix Code, Inc., + Ximian, Inc., Kevin Breit diff --git a/doc/C/preface.sgml b/doc/C/preface.sgml index 541f2d4d77..be18abd3d3 100644 --- a/doc/C/preface.sgml +++ b/doc/C/preface.sgml @@ -50,7 +50,7 @@ Evolution can help you work in a - group, by handling email, address and other contact + group by handling email, address and other contact information, and one or more calendars. It can do that on one or several computers, connected directly or over a network, for one person or for large groups. @@ -63,9 +63,10 @@ The application must be both powerful and easy - to use. That means a familiar and intuitive - interface that users can customize to their liking, and - the development of shortcuts for complex tasks. + to use. In other words, it needs a familiar + and intuitive interface that users can customize to their + liking, and users should have access to shortcuts for + complex tasks. @@ -125,7 +126,7 @@ chunks of information, and many of the features it describes are unimplemented. All the content is subject to change, especially if you help. Please send comments on the guide to - aaron@helixcode.com. If you would like to work + aaron@ximian.com. If you would like to work on the guide please contact me or see the GNOME Documentation project web @@ -140,14 +141,14 @@ 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. In addition, there is a - comprehensive menu - reference which describes nearly every capability that - Evolution has to offer. + general, this section is 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. In addition, there is a comprehensive menu reference which describes nearly + every capability that Evolution has + to offer. Typographical conventions @@ -178,7 +179,7 @@ Quick Reference for Common Tasks - You might want to get a copy of this section and tape it to + You might want to copy this section and tape it to the wall next to your computer: it's a very short summary of most of the things you'll want to do with Evolution, and pointers to the @@ -189,8 +190,7 @@ 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). + likely to use: @@ -257,37 +257,40 @@ + - Create a new Task + Enter a new Contact File New - Task or + Contact or Ctrl Shift - T + C + - Enter a new Contact + Create a new Task File New - Contact or + Task or Ctrl Shift - C + T + @@ -300,12 +303,10 @@ Check Mail - Click Get Mail in the toolbar, or press - - FIXME - FIXME - FIXME - + Click Get Mail in the + toolbar. There is no keyboard shortcut for this task, + but you can ask Evolution + to check for new mail periodically. To do so, FIXME. @@ -318,14 +319,19 @@ click Reply in the toolbar, or press - FIXME - FIXME - FIXME + Ctrl + R To reply to the sender and all the other visible - recipients of the message, click: + recipients of the message, click Reply to + All or select the message and press + + Shift + Ctrl + R + @@ -338,9 +344,8 @@ and click Forward in the toolbar, or press - FIXME - FIXME - FIXME + Ctrl + J @@ -361,18 +366,20 @@ - Create Filters and vFolders + Create Filters and Virtual Folders - You can create filters and vFolders based on specific - message attributes by right-clicking on a message or - by selecting Tools + You can create filters and Virtual Folders based on + specific message attributes from the message's + right-click menu. Alternately, select a message, and + then choose Settings Mail Filters - or Tools - vFolder Editor + or Settings + Virtual Folder Editor . Filters are discussed in , and vFolders - in . + linkend="usage-mail-organize-filters">, and Virtual + Folders in . diff --git a/doc/C/usage-mail.sgml b/doc/C/usage-mail.sgml index 304b60481c..70fdc76d66 100644 --- a/doc/C/usage-mail.sgml +++ b/doc/C/usage-mail.sgml @@ -19,7 +19,7 @@ It can send and receive mail in HTML or as plain text, and - supports file attachments. + permits multiple file attachments. @@ -43,11 +43,11 @@ linkend="usage-mail-organize-search">searching functions were built for speed and efficiency on gargantuan volumes of mail. There's also the Evolution - vFolder, an - advanced organizational feature not found in other mail clients. - If you get a lot of mail, or if you keep every message you get - in case you need to refer to it later, you'll find that feature - especially useful. + Virtual + Folder, an advanced organizational feature not found in + other mail clients. If you get a lot of mail, or if you keep + every message you get in case you need to refer to it later, + you'll find this feature especially useful. @@ -61,19 +61,20 @@ Inbox in the shortcut bar. The first time you use Evolution, it will start with the Inbox open and show you a - message from Helix Code welcoming you to the application. + message from Ximian welcoming you to the application. - The Evolution - Inbox, should look like the one in , which has a message from - Helix Code. The message summary appears at the top, in the - message list. The message itself is - displayed below that, in the view pane. - If you find the view pane too small, - you can resize the pane, enlarge the whole window, or double-click - on the message in the message list to - have it open in a new window. Just like with folders, you can + Your Evolution + Inbox will look something like the one in + . Just below the toolbar + is the message list, showing message + header information like Subject and + Date. The message itself appears below + that, in the view pane. If you find + the view pane too small, you can resize + the pane, enlarge the whole window, or double-click on the + message in the message list to have it + open in a new window. Just like with folders, you can right-click on messages in the message list and get a menu of possible actions. @@ -111,21 +112,26 @@ you choose the way you work is the way it lets you sort your message lists. To sort by sender, subject, or date, click on the bars with those labels at the top of the message - list. If you click twice, you'll sort them in reverse - order. You can also right-click on the message header bars - to get a set of sorting options, and add or remove columns - from the message list. You can find detailed instructions - on how to customize your message display columns in . + list. The direction of the arrow next to the label indicates + the direction of the sort, and if you click again, you'll + sort them in reverse order. For example, click once on + Date to sort messages by date from + oldest to newest. Click again, and + Evolution sorts the list from + newest to oldest. You can also right-click on the message + header bars to get a set of sorting options, and add or + remove columns from the message list. You can find detailed + instructions on how to customize your message display + columns in . You can also choose a threaded message view. Select View Threaded to turn - the threaded view on or off. If the option selected, - Evolution will group the replies - to a message with the original, so you can follow the thread - of a conversation from one message to the next. + the threaded view on or off. When you select this option, + Evolution groups the replies to a + message with the original, so you can follow the thread of a + conversation from one message to the next. @@ -135,16 +141,19 @@ it. To mark a message for deletion, select it in the the message list by clicking on it once. Then click on the Delete button in - the tool bar. The message now has a line through it, - because you've marked it for deletion. + the tool bar. Or, right-click on a message and choose + Delete from the right-click + menu. The message will appear with a line through it, to + show that you've marked it for deletion. - If you really want to get rid of it, choose + If you change your mind and decide you want to keep it, + select Message + Undelete. If you + really want to get rid of it, choose Expunge from the Folder menu. That will delete it - permanently. If you change your mind and decide you want to - keep it, select Message - Undelete. + permanently. @@ -163,9 +172,9 @@ Then, you need to enter your email password. Evolution will remember - the password until you quit the application or until you - select Settings - Forget Passwords . + your password until until you select + Settings Forget + Passwords . Once it's validated the password, @@ -188,9 +197,9 @@ Using Evolution for News - Newsgroups are so similar to email there's no reason not to - read them side by side. If you want to do that, add a news - source to your configuration (see ). The news server will appear as a remote server, and will look quite similar to an IMAP folder. When you click Get Mail, @@ -208,20 +217,14 @@ at the bottom of the message to which it's attached. Text, HTML, and most images will be displayed within the message itself. For other files, - Evolution will provide a link and - icon at the end of the message. Click on that, and - Evolution will ask you where you - want to put the file. Once you've chosen a location and - saved the file, you can open, move, copy, or execute it just - like any other, using Nautilus or - your favorite shell or file manager. + Evolution will show an icon at + the end of the message. Right-click on the icon to get a + list of options which will vary depending on the type of + attachment. You will have the option to display most files + as part of the message, export them to a different + application (images to Eye of GNOME, spreadsheets to + Gnumeric, and so forth), or save them to disk. - - As usual, there's a shortcut here: right-click on the link, - and choose an application for the file: you can send an - image straight to the GIMP, or a - spredsheet straight to Gnumeric. - Evolution can also display @@ -238,7 +241,7 @@ You can start writing a new email message by selecting File New - Mail, or by pressing the + Mail Message, or by pressing the Compose button in the Inbox toolbar. When you do so, the New Message window will open, as shown in To: field, a subject in the Subject: and a message in the big empty box at the bottom of the window, and press - Send. That's easy, although it can - get a little more complicated if you want. + Send. @@ -272,14 +274,14 @@ Evolution will send mail immediately unless you tell it to do otherwise by selecting File Send - Later. That will add messages - to the Outbox queue. Then, when you - press Send in another message, or - Get Mail in the main mail window, - all your unsent messages will go out at once. I like to - use "Send Later" because it gives me a chance to change my - mind about a message before it goes out. That way, I don't - send anything I'll regret the next day. + Later. This will add your + messages to the Outbox queue. Then, + when you press Send in another + message, or Get Mail in the main + mail window, all your unsent messages will go out at once. + I like to use "Send Later" because it gives me a chance to + change my mind about a message before it goes out. That + way, I don't send anything I'll regret the next day. To learn more about how you can specify message queue and @@ -322,7 +324,7 @@ labelled Attach. If you click the Attach button, Evolution will open a file - selection dialog box, to ask you which file you want to + selection dialog box to ask you which file you want to send. Select the file and click OK. @@ -341,18 +343,16 @@ Types of Recipients - Evolution, like all email - programs (at least, all the ones in current use) - recognizes three types of addressee: primary recipients, - secondary recipients, and hidden ("blind") recipients. + Evolution, like most email + programs recognizes three types of addressee: primary + recipients, secondary recipients, and hidden ("blind") + recipients. The simplest way to direct a message is to put the email address or addresses in the To: - field, which denotes primary recipients. However, it's - considered bad form to have more than a few email - addresses in this section. If you are sending mail to - more than one or two people, consider the + field, which denotes primary recipients. To send mail to + more than one or two people, you can use the the Cc: field. @@ -377,11 +377,13 @@ to send mail to several people without sharing the recipient list, you should use Bcc:. "Bcc" stands for "Blind Carbon - Copy", and means that people you put in the - Bcc: field get the message, but - nobody else sees their email address. They will still see - the list of addresses from the To: - and Cc: fields, though. + Copy", and it sends messages discreetly. In other words, + the people in the Bcc: field get the + message, but nobody sees that they got it. Note that the + contents of the To: and + Cc: fields are visible to all + recipients, even to people on the + Bcc: list. Using the Bcc: field @@ -395,7 +397,8 @@ category into the To: or Cc: fields, he'll make the company's entire client list - public. Don't assume it won't happen to you! + public. It seems like a small difference, but it can + make a huge difference in some situations. @@ -440,7 +443,7 @@ To reply to a message, press the Reply button while it is selected, or choose Reply to Sender from - the message's right-click menu. That will open + the message's right-click menu. That will open the message composer. The To: and Subject fields will already be filled, although you can alter them @@ -452,7 +455,7 @@ with the quoted material as shown in . -
@@ -472,18 +475,21 @@ with quoted materials and the relevant replies interspersed--> Reply. If there are large numbers of people in the Cc: or To: fields, this can save substantial - amounts of time. But be careful, and always make sure you - know who is getting a message: one address could be a - mailing list with thousands of subscribers. + amounts of time. Be careful: always make sure you know who + is getting a message: one address could be a mailing list + with thousands of subscribers. Using the Reply to All feature - Susan sends an email to a client, and sends copies to - Tim and to an internal company mailing list of - co-workers. If Tim wants to make a comment to all of - them, he uses Reply to All, but - if he just wants to tell Susan that he agrees with her, - he uses Reply. + Susan sends an email to a client and sends copies to Tim + and to an internal company mailing list of co-workers. + If Tim wants to make a comment for all of them to read, + he uses Reply to All, but if he + just wants to tell Susan that he agrees with her, he + uses Reply. Note that his reply + will not reach anyone that Susan put on her + Bcc list, since nobody else knows + that they got that message. @@ -512,9 +518,9 @@ with quoted materials and the relevant replies interspersed--> Find Regex - Perform a search for a regular - expression, or "regex." + Find a regex, also called a + regular + expression, in your composer window. @@ -537,28 +543,27 @@ with quoted materials and the relevant replies interspersed--> - For all of these items, you have two additional choices. - First, you can choose whether to Search - Backwards, which will perform the search - starting wherever your cursor is, and moving back towards - the beginning of the document (normally, it goes the other - way). Then, you can decide whether to have your search be - Case Sensitive, meaning should it pay - attention to the case of letters when locating a match. + For all of these menu items, you can choose whether or not + to Search Backwards in the document + from the point where your cursor is. For all but the + regular expression search (which doesn't need it), you are + offered a check box to determine whether the search is to + be Case Sensitive when it determines + a match. Embellish your email with HTML - You can't normally set text styles or insert pictures in + Normally, you can't set text styles or insert 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. However, most of the newer email programs can - include and display images and text styles as well as - basic alignment and paragraph formatting. They do this - with HTML, just like - web sites do. + too many exclamation points for emphasis, or use + emoticons to + convey their feelings. However, most newer email programs + can display images and text styles as well as basic + alignment and paragraph formatting. They do this with + HTML, just like web + pages do. HTML Mail is not a Default Setting @@ -579,28 +584,30 @@ with quoted materials and the relevant replies interspersed--> - HTML formatting tools are located just above the - composition frame, and in the Insert and - Format menus. Your message text will - appear formatted in the composer window, and the message - will be sent as HTML. + HTML formatting tools are located in the toolbar just above + the space where you'll actually compose the message, and + they also appear in the Insert and + Format menus. - The icons in the toolbar are explained in tool-tips, which - appear when you hold your mouse over the buttons. The - buttons fall into four categories: + The icons in the toolbar are explained in tool-tips, which appear when + you hold your mouse over the buttons. The buttons fall + into four categories: Headers and lists - Choose Normal for a default - text style, or Header 1 through + At the left edge of the toolbar, you can choose + Normal for a default text style + or Header 1 through Header 6 for varying sizes of - header from large (1) to tiny (6). You can also - select pre for preformatted - text blocks, and three types of List - Item. + header from large (1) to tiny (6). Other styles + include pre, to use the HTML + tag for preformatted blocks of text, and three types + of List Item for the highly + organized. @@ -626,12 +633,12 @@ with quoted materials and the relevant replies interspersed--> Alignment - Located next to the text style buttons, - these three paragraph icons should be familiar to - users of most word processing software. The - leftmost button will make your text left-justified, - the center button, centered, and the right hand - button, right-justified. + Located next to the text style buttons, these three + paragraph icons should be familiar to users of most + word processing software. The leftmost button will + make your text aligned to the left, the center + button, centered, and the right hand button, + aligned on the right side. @@ -651,13 +658,13 @@ with quoted materials and the relevant replies interspersed--> Color Selection - At the far right is the color section tool. You can - 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 - not have text selected, the color will apply to - whatever you type next. + At the far right is the color section tool. The + colored box displays the current text color; to + choose a new one, click the arrow button just to the + right. If you have text selected, the color will + apply to the selected text. If you do not have text + selected, the color will apply to whatever you type + next. @@ -689,10 +696,9 @@ with quoted materials and the relevant replies interspersed--> Insert Image: - Insert Image: Select this - item to embed an image into your email, as was done in - the welcome message. Images will appear at the - location of the cursor. This is different from + Select this item to embed an image into your email, as + was done in the welcome message. Images will appear at + the location of the cursor. This is different from attaching them to a message, but not very different. @@ -777,7 +783,7 @@ possibly never will be due to security evil. --> - Seven Tips for Email Usage + Seven Tips for Email Courtesy I started with ten, but four were "Don't send spam." @@ -789,15 +795,15 @@ possibly never will be due to security evil. --> watch out for hoaxes and urban legends, and make sure the message doesn't have multiple layers of greater-than signs, (>) indicating multiple layers - of careless inline forwarding. + of careless in-line forwarding. - Always begin and close with a salutation. Say - "please" and "thank you", just like you do in real - life. You can keep your pleasantries short, but be pleasant! + Always begin and close with a salutation. Say "please" + and "thank you," just like you do in real life. You + can keep your pleasantries short, but be pleasant! @@ -856,12 +862,16 @@ possibly never will be due to security evil. --> Sorting Mail with Column Headers - By default, the columns in a mail message list are an - envelope icon indicating whether a message has been read - (closed for unread, open for read), an exclamation point - indicating priority, and the From, + By default, the columns in a mail message list are: an + envelope icon indicating whether you have read or replied to + a message (closed for unread, open for read, and open with an + arrow on it to indicate you've sent a reply), an exclamation + point indicating priority, and the From, Subject, and Date - fields. However, you can change that if you want. + fields. You can change their order and remove them by + dragging and dropping them. You can add new ones with the + Field Chooser item in the right + click menu for the column headings. Right-click on one of the column headers to get a list of @@ -869,29 +879,37 @@ possibly never will be due to security evil. --> - - - + Sort Ascending, + Sort Descending, and + Unsort + Which should be pretty obvious. You + can also set these sorts by just clicking on the + column headers. - + Group By this Field + Groups messages instead of sorting them. (FIXME: Explain further) - - - + Remove this + Column Remove + this column from the display. You can also remove + columns by dragging the header off the list and + letting it drop. - - - + Field + Chooser A list + of column headers; just drag and drop them into + place between two existing headers. A red arrow will + appear to show you where you're about to put the + column. - @@ -1189,13 +1207,14 @@ possibly never will be due to security evil. --> Regex Match - - If you know your way around a regular - expression, or regex, put your knowledge to - use here. You can match your expression in the message - headers or in its body. - + + + If you know your way around a regex , or + regular expression, put your knowledge to use + here. + + diff --git a/doc/C/usage-mainwindow.sgml b/doc/C/usage-mainwindow.sgml index 94c65acfd8..54607c8c01 100644 --- a/doc/C/usage-mainwindow.sgml +++ b/doc/C/usage-mainwindow.sgml @@ -28,7 +28,7 @@ part of the main window is taken up by the actual Inbox, where messages are listed and displayed. If you're running the program for the first time, - you'll have just one message: a welcome from Helix Code. + you'll have just one message: a welcome from Ximian. @@ -81,8 +81,8 @@ Directories, it will slide up and you'll see buttons for the Bigfoot and Netcenter directories, as well as any - others you or your system administrator might have added. You - can add more groups by right-clicking on the background of the + others you or your system administrator may have added. You can + add more groups by right-clicking on the background of the shortcut bar and selecting Menu Group. Internet directories behave a lot like the local contact manager, which is covered in If you don't like the shortcut bar, you can use the folder bar - or the menu bar to navigate. Press + or the menu bar to navigate the main window. Press Ctrl O @@ -208,18 +208,17 @@ 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. First, and probably most important, is the - Local folder, which holds all the - Evolution data that's stored on your - computer. After that come vFolders, or - virtual folders, discussed in , followed by any - IMAP mail folders you - might have available to you over your network. Lastly, there - are External Directories, Local + folder, which holds all the Evolution + data that's stored on your computer. After that come + Virtual Folders, or virtual folders, discussed in + , followed by any + IMAP mail folders you may + have available to you over your network. Lastly, there are + External Directories, LDAP contact directories stored on a - network. + network. @@ -266,7 +265,6 @@ - @@ -294,13 +292,8 @@ Folders Have Limits - No matter where they exist, calendars must go in - calendar folders, mail in mail folders, and contacts in - contact folders. Network folders follow the same type - restriction, because the network servers are only set up - to handle one kind of information. Within your local - system, though you can folders inside each other, - regardless of type. + Calendars must go in calendar folders, mail in mail + folders, and contacts in contact folders. @@ -310,8 +303,7 @@ exception. If you right-click on a folder, you'll have a menu with the following options: - View, to view a message. - Something else, for another purpose. + FIXME, for another purpose. Something else, for another purpose. . @@ -371,8 +363,7 @@ Edit Menu - Although it doesn't contain anything at first, - the Edit menu fills up with + The Edit menu holds useful tools that help you edit text and move it around. @@ -392,7 +383,7 @@ Tools for configuring, changing, and setting up go here. For mail, that means things like Mail Configuration and the - vFolder Editor. For the + Virtual Folder Editor. For the Calendar and the Contact Manager, it's color, network, and layout configuration. diff --git a/doc/ChangeLog b/doc/ChangeLog index 02c0ed3501..51d8d6eb7c 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,19 @@ +2001-01-19 Aaron Weber + + * C/usage-mail.sgml: More of Megan's revisions, and Field Chooser + functions in the Sort section. + + * C/apx-gloss.sgml: added "ToolTip" + +2001-01-18 Aaron Weber + + * C/preface.sgml: s/Helix Code/Ximian, and Megan's comments. + + * C/usage-mainwindow.sgml: s/Helix Code/Ximian/, and Megan's + comments. + + * C/evolution-guide.sgml: s/Helix Code/Ximian/ + 2000-12-13 Aaron Weber * C/usage-mail.sgml: Revisions as suggested by Dan. Especially to -- cgit