From 95c68912699be41ba05576c180e37613bf72c25e Mon Sep 17 00:00:00 2001 From: Aaron Weber Date: Thu, 31 Aug 2000 14:53:41 +0000 Subject: Added regular expressions to glossary. Explanation should be removed from 2000-08-31 Aaron Weber * C/apx-gloss.sgml: Added regular expressions to glossary. Explanation should be removed from other portions of the book now. * C/usage-mainwindow.sgml: Revisions, minor. * C/apx-menuref.sgml: Now named menuref.sgml, to reflect its new status as a part. * C/evolution-guide.sgml: Structural alterations: Menuref is now a part, not an appendix. * C/apx-menuref.sgml: Added contextual menus for mail. svn path=/trunk/; revision=5140 --- doc/C/apx-gloss.sgml | 30 ++ doc/C/apx-menuref.sgml | 1062 ------------------------------------- doc/C/evolution-guide.sgml | 18 +- doc/C/menuref.sgml | 1196 ++++++++++++++++++++++++++++++++++++++++++ doc/C/preface.sgml | 13 +- doc/C/usage-mail.sgml | 232 ++------ doc/C/usage-mainwindow.sgml | 52 +- help/C/apx-gloss.sgml | 30 ++ help/C/apx-menuref.sgml | 1062 ------------------------------------- help/C/evolution-guide.sgml | 18 +- help/C/menuref.sgml | 1196 ++++++++++++++++++++++++++++++++++++++++++ help/C/preface.sgml | 13 +- help/C/usage-mail.sgml | 232 ++------ help/C/usage-mainwindow.sgml | 52 +- 14 files changed, 2642 insertions(+), 2564 deletions(-) delete mode 100644 doc/C/apx-menuref.sgml create mode 100644 doc/C/menuref.sgml delete mode 100644 help/C/apx-menuref.sgml create mode 100644 help/C/menuref.sgml diff --git a/doc/C/apx-gloss.sgml b/doc/C/apx-gloss.sgml index 0f1b73ff09..5693ecda1c 100644 --- a/doc/C/apx-gloss.sgml +++ b/doc/C/apx-gloss.sgml @@ -227,6 +227,22 @@ + + Regular Expression + + + A regular expression, or "regex", is a way of describing a + string of text using metacharacters or wildcard symbols. For + example, the statement fly*so[a|u]p means + "any phrase beginning with 'fly' and ending in 'soup' or + 'soap'". If you searched for that expression, you'd find both + "fly in my soup" and "fly in my soap." There's not room here to + go into depth, but if you want, have a look at the documentation + for the grep command. + + + + Script @@ -282,3 +298,17 @@ + + + + + + + + + + + + + + diff --git a/doc/C/apx-menuref.sgml b/doc/C/apx-menuref.sgml deleted file mode 100644 index f47a921e31..0000000000 --- a/doc/C/apx-menuref.sgml +++ /dev/null @@ -1,1062 +0,0 @@ - - - - Menu Reference - - This section will serve as a reference for every capability that - Evolution has. When menu items are - repeated in Evolution, they're repeated - here too. - - - From left to right, the menus available to you when you are - reading mail are: File, - Edit, View, - Tools, Actions, and - Help. The last of these doesn't change, but - the rest of them have contents that will change depending on - whether you're looking at mail, contacts, or calendar information. - In addition, the editor tools for messages, appointments, and - contacts all have menu bars. - - - - Menus that are the same everywhere - - The File and Help menus in - the main Evolution window do not - change, because they refer to universal items. Other menus have - contents that change depending on context. - - - - File Menu - - - - - New... Submenu - - - - Folder — - Create a new folder. See - for more information about folders. - - - Shortcut — - Create a new Shortcut in the Shortcut Bar. - - - Mail Message — - Compose a new mail message. Covered in - . - - - Appointment — - Enter a new appointment in your calendar. See for more information. - - - Task — - Enter a new to-do item in your taskpad. Covered in - . - - - - - - - Go to Folder - - View the items in a particular folder. - - - - - Create New Folder - - This item doesn't belong here any more. - - - - - Print Message - - Print the current message. - - - - - Exit - - Quit using Evolution. - - - - - - - - The Help Menu - - - - Help Index - - Displays the table of contents for this document. - - - - Getting Started - - A quick look around, and a summary of the things - Evolution can do for you. - - - - Using the Mailer - - An in-depth tour of Evolution Mail. - - - - Using the Calendar - - A step-by-step guide to using the Calendar. - - - - Using the Contact Manager - - Find your way around the Contact Manager. - - - - Submit Bug Report - - If you don't report them, they can't fix them. Select this item to let the - developers know what's wrong. - - - - About Evolution - - Displays a window with information about the application and its authors. - This has the same information as . - - - - - - - - - - Mail Menus - - All the menus for mail. FIXME: this paragraph needs content. - - - - The Edit Menu - - This menu is currently empty. - - - - - The View Menu - - This menu lets you control the way - Evolution displays your information - for you. - - - Show Shortcut Bar - - Toggle the shortcut bar on and off with this item. - - - - - Show Folder Bar - - Toggle the folder bar on and off with this item. - See for - more information about the folder bar. - - - - - Threaded Message List - - This item controls whether your message list is displayed by thread - or by other criteria. The default order is by date; see - for information about the - order of the message list. - - - - - - - - The Tools Menu - - - - Mail Filters - - Edit your mail filters here. - See - for more information about mail filtering. - - - - - vFolder Editor - - Create, edit, and delete vFolders with this tool. - To learn about using vFolders with mail, see - . - - - - - Mail Configuration - - This is a poorly named tool. You can set your identity, - and everything else related to your mail account, here. - - - - - Forget Passwords - - Although it's really an Action (FIXME), this item will cause - Evolution to forget what your - password is. - - - - - Configure Folder - - Another FIXME item, this allows you to set the file format - in which Evolution stores mail. - - - - - - - - The Actions Menu - - When you select one of the actions from this menu, - Evolution will do your bidding, - usually to the item you have selected. - - - The actions you can perform are: - - - Edit Message - - Select a message in the drafts folder before you select this - item. You can only edit a message you have written. FIXME: POOR - description of BROKEN behavior. - - - - - View Message - - Displays the selected message in a new window. - - - - - Mark all Messages Read - - Evolution keeps track of which messages - you've seen; When you don't need to read all those messages, select this item. - You can mark a single message as read by right-clicking it in the message bar. - - - - - Expunge - - Emtpies the trash folder, erasing messages permanently. - Once you've done this, don't come crying to me if you - want a message back. - - - - - - - - - The Message Composer Menus - - The message composition window has its own set of menus: - File, which controls operations on files and - data, Edit, for text editing, - Format, which controls the file format of - messages you send, View, to set how you view - the message, and Insert, which holds tools - for embedding files and other items in messages. Here's what's in them: - - - The Message Composer's File Menu - - - - Open - - Open a text file or a draft mail message. - - - - - Save - - Save a mail message as a text file. - - - - - Save As - - Choose a file name and location for - a message you want to save as a text file. - - - - - Save in Folder - - Save a message as a draft, rather than - as a seperate text file. (FIXME: should be removed, and - functionality subsumed under "Save As"). - - - - - Insert Text File - - Open a text file and insert it into - the current message. (FIXME: belongs under "Insert"). - - - - - Send - - Sends the message immediately. - - - - - Close - - Closes the message composer. If you have not done so, - Evolution - will ask you if you want to save your message. - - - - - - - The Message Composer's Edit Menu - - The Edit menu in the message composer - contains the following items. Keyboard shortcuts are listed - next to the items in the menus themselves. - - - - - Undo - - Undoes the last action you performed. - - - - - Redo - - If you change your mind about Undoing something, - you can always use this item. - - - - - Cut - - Removes the selected text from the text entry window and - retains it in the system "clipboard" memory, ready for pasting. - - - - - Copy - - Copies selected text to the system clipboard without deleting it. - The text can then be inserted elsewhere with the - Paste command. - - - - - Paste - - Inserts the contents of the system clipboard at the - location of the cursor. - - - - - Find - - Enter a phrase and find your match in your message body. - As with Find Regex, - Find Again, and - Replace, Evolution - will offer you the option to search forwards or backwards, and. - - - - - - Find Regex - - If you are familiar with regular expressions, often called - "regexes," you can search for something more complicated, - using wildcards and boolean logic. If you're not familiar with - them, there are numerous resources for you on the web. - - - - - Find Again - - Repeats your last search. - - - - - Replace - - Enter a word or phrase and the word or phrase with which you'd like - to replace it. - - - - - Properties - - This item brings up the Message Composer Properties Capplet, - a portion of the GNOME Control Center that determines the - key bindings for the message composer. Help for this capplet is - available directly from the Control Center. - (FIXME: Write that help doc too) (FIXME: this is in the wrong place!) - - - - - - - - The Message Composer's Format Menu - - The Format menu has only one item: - - - HTML - - Toggles HTML mode for the message composer. When selected, - the message is displayed and sent in HTML. If you have written a - message in HTML and turn HTML off, most formatting will be lost. - Evolution will attempt to preserve spacing - and to remove formatting gracefully, however. - - - - - - - The Message Composer's View Menu - - The View menu controls the way messages are - displayed, and how much of the message, its headers, and - attachments appear. It contains: - - - Show Attachments - - Toggles the display of attachments. When this item is selected, - Evolution will create a seperate pane - of the composition window to show what attachments you are appending - to the message. - - - - - - - The Message Composer's Insert Menu - - The Insert menu holds tools that allow you - to include images, horizontal rules, and other objects - in the body of your message. The tools are: - - - - Image - - This tool will prompt you to select an image file to - insert into your HTML message. For text messages, this - is the same as attaching an image file. - - - - - Link - - Opens the link creation window, - which lets you specify the URL and text description - for a link in your message. This only works with HTML - messages. - - - - - Rule - - Opens the horizontal rule creation dialog, which lets you - create an HTML horizontal rule. For more information, - see . - This tool only works with HTML messages. - - - - - Text File - - Open a text file and insert it into the current message. - This tool works with both plain text and HTML messages. - - - - - - - - - The Calendar Menus - - The Main window of the calendar has the same menus as the main - window of the mail client. However, their contents vary in a - number of ways. - - - The Calendar Edit Menu - - The contents of the Edit menu are currently so borked that I - refuse to document them right now. (That means FIXME). They - should be: - - - - Item - - Description - - - - Item - - Description - - - - - Item - - Description - - - - - - - The Calendar View Menu - - The Calendar's View menu contains the following items: - - - - Show Shortcut Bar - - Toggle the Shortcut Bar on and off with this item. - - - - - Show Folder Bar - - Toggle the folder bar on and off with this item. - See for - more information about the folder bar. - - - - - View By Day - - Switch to the day view for your calendar. - - - - - View Five Days - - View five calendar days at once. - - - - - View by Week - - Switch the calendar view to full week mode. - - - - - View By Month - - Look at a month at a time. - - - - - - - - The Calendar Tools Menu - - This menu is empty. - - - - - The Calendar Actions Menu - - This menu is empty. - - - - - - The Appointment Editor Menus - - FIXME: Insert Content Here. - - - - The Appintment Editor's File Menu - - This menu contains several items, including a New - that is identical to that in the - main window's file menu. - Its other contents are: - - - - Send - - Opens a mail message with the appointment attached to it. - - - - - - Save - - Save this appointment in the existing location and name. If you have not yet - chosen a location and name, this is the same as Save As. - - - - - - Save As - - Choose a location and name for this appointment, and save it. - - - - - Delete - - Deletes the appointment. - - - - - Move to Folder - - Chose a folder, and move the appointment into it. - - - - - - Copy to Folder - - Chose a folder, and put a copy of the appointment into it. - - - - - - Page Setup Submenu - - This menu contains two items: - - - Memo Style — - FIXME: What does this do? - - - - Define Print Styles — - FIXME: What does this do? - - - - - - - Print Preview - - Shows you what your appointment will look like if you print it. - - - - - - Print - - Prints the appointment without preview. - - - - - - Properties - - FIXME: What does this do? - - - - - - Close - - Close the appointment editor window. - - - - - - - - The Appintment Editor's Edit Menu - - FIXME: this menu is copied and pasted entirely from somewhere - else. - - - - - The Appintment Editor's View Menu - - This menu allows you to look at different appointments, and - set the way you look at them, without having to move back to - the Main Window. It contains: - - - - Previous - - The items in this submenu will take you to appointments - prior to the current one. (FIXME: describe). - - - - - Next - - The items in this submenu will take you to appointments - scheduled to occur after the current one. (FIXME: describe). - - - - - Calendar - - FIXME: What does this item do? - - - - - Toolbars - - The Toolbars submenu - allows you to choose which toolbars - are displayed in the - Appointment Editor. They are: - - - Standard — - Toggle the standard toolbar on and off. - - - - Formatting — - Toggle the formatting toolbar on and off. - - - - Customize — - Select the contents of the formatting and standard toolbars. - - - - - - - - - - The Appintment Editor's Insert Menu - - This menu contains: (FIXME: Insert Content Here) - - - File - - Choose a file to append to your appointment or appointment request. - - - - - - Item - - FIXME: ? - - - - - - Object - - FIXME: ? - - - - - - - - The Appintment Editor's Format Menu - - This menu contains two items, neither of which - have any functionality yet: - - - Font - - FIXME: ? - - - - - - Paragraph - - FIXME: ? - - - - - - - - The Appintment Editor's Tools Menu - - - This menu contains four items, none of which - have any functionality yet: - - - Item - - FIXME: ? - - - - - Item - - FIXME: ? - - - - - - - - The Appintment Editor's Actions Menu - - This menu contains: - - - - Invite Attendees - - Invite the listed attendees to the current event (via email). - You may be prompted to specify an invitation message. - - - - - Cancel Invitation - - Cancels the event, notifying all attendees. You may be prompted - to specify an invitation message. - - - - - Forward as vCalendar - - Opens the message composer with the current event attached. - - - - - Forward as Text - - Opens the message composer with a text description of the current - event included in the message body. - - - - - - - - The Appintment Editor's File Menu - - This menu is empty. - - - - - - - Contact Manager Menus - - Insert Content Here (FIXME). - - - - Contact Manager Edit Menu - - This menu is empty. - - - - - - Contact Manager Edit Menu - - This menu contains the following items: - - - - Show Shortcut Bar - - Toggle the Shortcut Bar on and off with this item. - - - - - Show Folder Bar - - Toggle the folder bar on and off with this item. - See for - more information about the folder bar. - - - - - As Table - - View your contacts as a table. - When in table-view mode, this menu item reads - As Minicards, and changes the view - back to the minicard format. - - - - - - - - Contact Manager Tools Menu - - This menu is empty. - - - - - - - Contact Manager Tools Menu - - This menu is broken. (FIXME). - - - - - - 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. - - - - - - - - - - - - diff --git a/doc/C/evolution-guide.sgml b/doc/C/evolution-guide.sgml index f7a7a87ab2..0eff8b99a0 100644 --- a/doc/C/evolution-guide.sgml +++ b/doc/C/evolution-guide.sgml @@ -1,4 +1,5 @@ @@ -9,18 +10,18 @@ - + - ]> + A User's Guide to Evolution @@ -115,7 +116,18 @@ &CONFIG-SYNC; - &APX-MENUREF; + + Comprehensive Menu reference + + + The following reference covers all, or nearly all, of the + menus and menu commands that + Evolution has to offer you. + + + &MENUREF; + + &APX-GLOSS; &APX-BUGS; &APX-AUTHORS; diff --git a/doc/C/menuref.sgml b/doc/C/menuref.sgml new file mode 100644 index 0000000000..b4ae8d4f83 --- /dev/null +++ b/doc/C/menuref.sgml @@ -0,0 +1,1196 @@ + + + + Menu Reference + + This section will serve as a reference for every capability that + Evolution has. When menu items are + repeated in Evolution, they're repeated + here too. + + + From left to right, the menus available to you when you are + reading mail are: File, + Edit, View, + Tools, Actions, and + Help. The last of these doesn't change, but + the rest of them have contents that will change depending on + whether you're looking at mail, contacts, or calendar information. + In addition, the editor tools for messages, appointments, and + contacts all have menu bars. + + + + Menus that are the same everywhere + + The File and Help menus in + the main Evolution window do not + change, because they refer to universal items. Other menus have + contents that change depending on context. + + + + File Menu + + + + + New... Submenu + + + + Folder — + Create a new folder. See + for more information about folders. + + + Shortcut — + Create a new Shortcut in the Shortcut Bar. + + + Mail Message — + Compose a new mail message. Covered in + . + + + Appointment — + Enter a new appointment in your calendar. See for more information. + + + Task — + Enter a new to-do item in your taskpad. Covered in + . + + + + + + + Go to Folder + + View the items in a particular folder. + + + + + Create New Folder + + This item doesn't belong here any more. + + + + + Print Message + + Print the current message. + + + + + Exit + + Quit using Evolution. + + + + + + + + The Help Menu + + + + Help Index + + Displays the table of contents for this document. + + + + Getting Started + + A quick look around, and a summary of the things + Evolution can do for you. + + + + Using the Mailer + + An in-depth tour of Evolution Mail. + + + + Using the Calendar + + A step-by-step guide to using the Calendar. + + + + Using the Contact Manager + + Find your way around the Contact Manager. + + + + Submit Bug Report + + If you don't report them, they can't fix them. Select this item to let the + developers know what's wrong. + + + + About Evolution + + Displays a window with information about the application and its authors. + This has the same information as . + + + + + + + + + + Mail Menus + + All the menus for mail. FIXME: this paragraph needs content. + + + + The Edit Menu + + This menu is currently empty. + + + + + The View Menu + + This menu lets you control the way + Evolution displays your information + for you. + + + Show Shortcut Bar + + Toggle the shortcut bar on and off with this item. + + + + + Show Folder Bar + + Toggle the folder bar on and off with this item. + See for + more information about the folder bar. + + + + + Threaded Message List + + This item controls whether your message list is displayed by thread + or by other criteria. The default order is by date; see + for information about the + order of the message list. + + + + + + + + The Tools Menu + + + + Mail Filters + + Edit your mail filters here. + See + for more information about mail filtering. + + + + + vFolder Editor + + Create, edit, and delete vFolders with this tool. + To learn about using vFolders with mail, see + . + + + + + Mail Configuration + + This is a poorly named tool. You can set your identity, + and everything else related to your mail account, here. + + + + + Forget Passwords + + Although it's really an Action (FIXME), this item will cause + Evolution to forget what your + password is. + + + + + Configure Folder + + Another FIXME item, this allows you to set the file format + in which Evolution stores mail. + + + + + + + + The Actions Menu + + When you select one of the actions from this menu, + Evolution will do your bidding, + usually to the item you have selected. + + + The actions you can perform are: + + + Edit Message + + Select a message in the drafts folder before you select this + item. You can only edit a message you have written. FIXME: POOR + description of BROKEN behavior. + + + + + View Message + + Displays the selected message in a new window. + + + + + Mark all Messages Read + + Evolution keeps track of which messages + you've seen; When you don't need to read all those messages, select this item. + You can mark a single message as read by right-clicking it in the message bar. + + + + + Expunge + + Emtpies the trash folder, erasing messages permanently. + Once you've done this, don't come crying to me if you + want a message back. + + + + + + + + + The Message Composer Menus + + The message composition window has its own set of menus: + File, which controls operations on files and + data, Edit, for text editing, + Format, which controls the file format of + messages you send, View, to set how you view + the message, and Insert, which holds tools + for embedding files and other items in messages. Here's what's in them: + + + The Message Composer's File Menu + + + + Open + + Open a text file or a draft mail message. + + + + + Save + + Save a mail message as a text file. + + + + + Save As + + Choose a file name and location for + a message you want to save as a text file. + + + + + Save in Folder + + Save a message as a draft, rather than + as a seperate text file. (FIXME: should be removed, and + functionality subsumed under "Save As"). + + + + + Insert Text File + + Open a text file and insert it into + the current message. (FIXME: belongs under "Insert"). + + + + + Send + + Sends the message immediately. + + + + + Close + + Closes the message composer. If you have not done so, + Evolution + will ask you if you want to save your message. + + + + + + + The Message Composer's Edit Menu + + The Edit menu in the message composer + contains the following items. Keyboard shortcuts are listed + next to the items in the menus themselves. + + + + + Undo + + Undoes the last action you performed. + + + + + Redo + + If you change your mind about Undoing something, + you can always use this item. + + + + + Cut + + Removes the selected text from the text entry window and + retains it in the system "clipboard" memory, ready for pasting. + + + + + Copy + + Copies selected text to the system clipboard without deleting it. + The text can then be inserted elsewhere with the + Paste command. + + + + + Paste + + Inserts the contents of the system clipboard at the + location of the cursor. + + + + + Find + + Enter a phrase and find your match in your message body. + As with Find Regex, + Find Again, and + Replace, Evolution + will offer you the option to search forwards or backwards, and. + + + + + + Find Regex + + If you are familiar with regular expressions, often called + "regexes," you can search for something more complicated, + using wildcards and boolean logic. If you're not familiar with + them, there are numerous resources for you on the web. + + + + + Find Again + + Repeats your last search. + + + + + Replace + + Enter a word or phrase and the word or phrase with which you'd like + to replace it. + + + + + Properties + + This item brings up the Message Composer Properties Capplet, + a portion of the GNOME Control Center that determines the + key bindings for the message composer. Help for this capplet is + available directly from the Control Center. + (FIXME: Write that help doc too) (FIXME: this is in the wrong place!) + + + + + + + + The Message Composer's Format Menu + + The Format menu has only one item: + + + HTML + + Toggles HTML mode for the message composer. When selected, + the message is displayed and sent in HTML. If you have written a + message in HTML and turn HTML off, most formatting will be lost. + Evolution will attempt to preserve spacing + and to remove formatting gracefully, however. + + + + + + + The Message Composer's View Menu + + The View menu controls the way messages are + displayed, and how much of the message, its headers, and + attachments appear. It contains: + + + Show Attachments + + Toggles the display of attachments. When this item is selected, + Evolution will create a seperate pane + of the composition window to show what attachments you are appending + to the message. + + + + + + + The Message Composer's Insert Menu + + The Insert menu holds tools that allow you + to include images, horizontal rules, and other objects + in the body of your message. The tools are: + + + + Image + + This tool will prompt you to select an image file to + insert into your HTML message. For text messages, this + is the same as attaching an image file. + + + + + Link + + Opens the link creation window, + which lets you specify the URL and text description + for a link in your message. This only works with HTML + messages. + + + + + Rule + + Opens the horizontal rule creation dialog, which lets you + create an HTML horizontal rule. For more information, + see . + This tool only works with HTML messages. + + + + + Text File + + Open a text file and insert it into the current message. + This tool works with both plain text and HTML messages. + + + + + + + + Contextual Menus in Evolution Mail + + The following menus appear when you right-click on something: + + + + Right-click menu for messages in the message list + + + + + Open in New Window + + Open a new window to read this message. + + + + + Edit this Message + + Available only for messages you have + written and saved to the Drafts + or Outbox folders, this opens the + message in a message composition window, so you can alter it. + + + + + Print + + Opens the Print Preview window in preparation + for printing the message. + + + + + Reply to Sender + + Opens a message composition window addressed to the + author of the message. Covered in detail in + . + + + + + Reply to All + + Opens a message composition window addressed to the + author of the message and all known recipients. + Covered in detail in . + + + + + Forward + + Appends the body of the selected message to a new message. + Covered in detail in . + + + + + Delete Message + + Marks a message for deletion. + + + + + Move Message + + Choose a folder in which to place this message. + + + + + VFolder on Subject + + This item, and the three that follow it, will create vFolders + which you may customize further or save as-is. This one will + create a vFolder which will display all messages that contain the + subject line of the selected message. + + + + + VFolder on Sender + + Creates a vFolder to hold all messages from the sender of + the selected message. + + + + + + VFolder on Recipients + + Creates a VFolder to hold all messages addressed to the + recipient of the selected message. + + + + + Filter on Subject + + This item, and the three that follow it, will create Filters + for which you must select actions. You may keep the criteria as + they are, or alter them as you wish. This one will + create a filter which will affect all messages that contain the + subject line of the selected message. + + + + + Filter on Sender + + Creates a Filter which affects all messages from the sender of + the selected message. + + + + + + Filter on Recipients + + Creates a filter which will affect all messages addressed to the + recipient of the selected message. + + + + + + + + + The Calendar Menus + + The Main window of the calendar has the same menus as the main + window of the mail client. However, their contents vary in a + number of ways. + + + The Calendar Edit Menu + + The contents of the Edit menu are currently so borked that I + refuse to document them right now. (That means FIXME). They + should be: + + + + Item + + Description + + + + Item + + Description + + + + + Item + + Description + + + + + + + The Calendar View Menu + + The Calendar's View menu contains the following items: + + + + Show Shortcut Bar + + Toggle the Shortcut Bar on and off with this item. + + + + + Show Folder Bar + + Toggle the folder bar on and off with this item. + See for + more information about the folder bar. + + + + + View By Day + + Switch to the day view for your calendar. + + + + + View Five Days + + View five calendar days at once. + + + + + View by Week + + Switch the calendar view to full week mode. + + + + + View By Month + + Look at a month at a time. + + + + + + + + The Calendar Tools Menu + + This menu is empty. + + + + + The Calendar Actions Menu + + This menu is empty. + + + + + + The Appointment Editor Menus + + FIXME: Insert Content Here. + + + + The Appintment Editor's File Menu + + This menu contains several items, including a New + that is identical to that in the + main window's file menu. + Its other contents are: + + + + Send + + Opens a mail message with the appointment attached to it. + + + + + + Save + + Save this appointment in the existing location and name. If you have not yet + chosen a location and name, this is the same as Save As. + + + + + + Save As + + Choose a location and name for this appointment, and save it. + + + + + Delete + + Deletes the appointment. + + + + + Move to Folder + + Chose a folder, and move the appointment into it. + + + + + + Copy to Folder + + Chose a folder, and put a copy of the appointment into it. + + + + + + Page Setup Submenu + + This menu contains two items: + + + Memo Style — + FIXME: What does this do? + + + + Define Print Styles — + FIXME: What does this do? + + + + + + + Print Preview + + Shows you what your appointment will look like if you print it. + + + + + + Print + + Prints the appointment without preview. + + + + + + Properties + + FIXME: What does this do? + + + + + + Close + + Close the appointment editor window. + + + + + + + + The Appintment Editor's Edit Menu + + FIXME: this menu is copied and pasted entirely from somewhere + else. + + + + + The Appintment Editor's View Menu + + This menu allows you to look at different appointments, and + set the way you look at them, without having to move back to + the Main Window. It contains: + + + + Previous + + The items in this submenu will take you to appointments + prior to the current one. (FIXME: describe). + + + + + Next + + The items in this submenu will take you to appointments + scheduled to occur after the current one. (FIXME: describe). + + + + + Calendar + + FIXME: What does this item do? + + + + + Toolbars + + The Toolbars submenu + allows you to choose which toolbars + are displayed in the + Appointment Editor. They are: + + + Standard — + Toggle the standard toolbar on and off. + + + + Formatting — + Toggle the formatting toolbar on and off. + + + + Customize — + Select the contents of the formatting and standard toolbars. + + + + + + + + + + The Appintment Editor's Insert Menu + + This menu contains: (FIXME: Insert Content Here) + + + File + + Choose a file to append to your appointment or appointment request. + + + + + + Item + + FIXME: ? + + + + + + Object + + FIXME: ? + + + + + + + + The Appintment Editor's Format Menu + + This menu contains two items, neither of which + have any functionality yet: + + + Font + + FIXME: ? + + + + + + Paragraph + + FIXME: ? + + + + + + + + The Appintment Editor's Tools Menu + + + This menu contains four items, none of which + have any functionality yet: + + + Item + + FIXME: ? + + + + + Item + + FIXME: ? + + + + + + + + The Appintment Editor's Actions Menu + + This menu contains: + + + + Invite Attendees + + Invite the listed attendees to the current event (via email). + You may be prompted to specify an invitation message. + + + + + Cancel Invitation + + Cancels the event, notifying all attendees. You may be prompted + to specify an invitation message. + + + + + Forward as vCalendar + + Opens the message composer with the current event attached. + + + + + Forward as Text + + Opens the message composer with a text description of the current + event included in the message body. + + + + + + + + The Appintment Editor's File Menu + + This menu is empty. + + + + + + + Contact Manager Menus + + Insert Content Here (FIXME). + + + + Contact Manager Edit Menu + + This menu is empty. + + + + + + Contact Manager Edit Menu + + This menu contains the following items: + + + + Show Shortcut Bar + + Toggle the Shortcut Bar on and off with this item. + + + + + Show Folder Bar + + Toggle the folder bar on and off with this item. + See for + more information about the folder bar. + + + + + As Table + + View your contacts as a table. + When in table-view mode, this menu item reads + As Minicards, and changes the view + back to the minicard format. + + + + + + + + Contact Manager Tools Menu + + This menu is empty. + + + + + + + Contact Manager Tools Menu + + This menu is broken. (FIXME). + + + + + + 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. + + + + + + + + + + + + diff --git a/doc/C/preface.sgml b/doc/C/preface.sgml index c7f6c2824d..f456be0e22 100644 --- a/doc/C/preface.sgml +++ b/doc/C/preface.sgml @@ -167,11 +167,11 @@ - A Quick Reference to Common Tasks + Quick Reference for 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 + You might want to get a copy of this section and tape it 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. @@ -305,7 +305,7 @@ - Reply to Message + Reply to a message Message Select the message to which you want to reply, and @@ -321,7 +321,7 @@ - Forward Message + Forward a Message Select the message you want to forward, and @@ -360,7 +360,6 @@ Calendar - diff --git a/doc/C/usage-mail.sgml b/doc/C/usage-mail.sgml index ed101f6884..ad7419f330 100644 --- a/doc/C/usage-mail.sgml +++ b/doc/C/usage-mail.sgml @@ -48,6 +48,7 @@ Reading, Getting and Sending Mail + Reading Mail @@ -55,161 +56,37 @@ Inbox in the shortcut bar. By default, the Inbox is open when you start Evolution, and the first - time you see your inbox, there's a message in it from Helix + time you see your Inbox, there's a message in it from Helix Code welcoming you to the application. - The first time you open your - Evolution - Inbox, you will see a window like the one - in , with a message from - Helix Code in the message list. The - message is displayed below that, in the view - pane. If you find the view - pane too small, you can double-click on the - message in the message list to have it - open in a new window. As is the case with folders, you can - right-click on messages in the message list and get a menu of - possible actions: - - - - Open in New Window - - Select this item to view the message in - a new Evolution - window. - - - - - Edit Message - - This item is available only for messages and drafts - that you have written. Select it to open the message - composer and make changes to the message. - - + 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 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. + - - Print Message - - Select this item to print a message. - - - - - Reply to Sender - - Use this item to reply only to the author of the message. - - + + +
+ Evolution Mail + + Inbox + + + +
+ - - Reply to All - - Send a reply to the author of the message - and to all others on the recipient list. See for more information. - - - - - Forward Message - - Send the message on to another person. - See for - information about how to use the Forward feature. - - - - - Delete Message - - Mark the message for deletion. Choose - ActionsExpunge - to delete marked messages permanently. - - - - Move Message - - Select this item to move the message to another folder. - This will open a dialog to let you choose the destination - from a folder tree. - - - - vFolder for Subject - - Select this item to create a pre-fabricated vFolder based on - the current message's Subject line. - - - - vFolder for Sender - - Select this item to create a pre-fabricated vFolder based on - who sent the current message. - - - - vFolder for Recipients - - Select this item to create a pre-fabricated vFolder based on - who the recipients are. - - - - Filter for Subject - - Select this item to create a pre-fabricated filter based on - the current message's Subject line. - - - - Filter for Sender - - Select this item to create a pre-fabricated filter based on - who sent the current message. - - - - Filter for Recipients - - Select this item to create a pre-fabricated filter based on - who the recipients are. - - - - - - - The Order of the Message List - - You can also select the order in which messages appear in - that list. 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. - - - Aside from sorting the messages, you can opt to have the - messages threaded. Select - View Threaded Message - List to turn the threaded view - on or off. If the option selected, - Evolution will attempt to - associate related messages by using the - References, - In-Reply-To, and - Subject message headers. Messages - which are related are then placed next to each other, so - that it's easier to follow the thread of a conversation from - message to message. - - Other actions you can perform are listed, appropriately, in the Actions menu in the menu bar: @@ -249,6 +126,35 @@ + + Sorting the message list + + You can also select the order in which messages appear in + that list. 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. + + + Aside from sorting the messages, you can opt to have the + messages threaded. Select + View Threaded Message + List to turn the threaded view + on or off. If the option selected, + Evolution will attempt to + associate related messages by using the + References, + In-Reply-To, and + Subject message headers. Messages + which are related are then placed next to each other, so + that it's easier to follow the thread of a conversation from + message to message. + + + + + + Checking Mail + Now that you've had a look around the Inbox, select the welcome message in @@ -263,22 +169,8 @@ marked as deleted. At some point in the future, this feature will change to something a little less counter-intuitive. - - -
- Evolution Mail - - Inbox - - - -
- - - - Checking Mail To check your email, just click Get mail in the toolbar. If this is the first time @@ -620,18 +512,10 @@ with quoted materials and the relevant replies interspersed--> Find Regex - Regular expressions, often called "regex" for short, - are a powerful way of expressing complicated - statements using metacharacters or wildcard symbols. - For example, the statement - fly*so[a|u]p means "any - phrase beginning with 'fly' and ending in 'soup' or - 'soap'", so you'd find both "fly in my soup" and - "fly in my soap." There's not room here to go into - depth here, but if you want, have a look at the - documentation for the grep - command. - + Perform a search for a regular + expression, or "regex." + + diff --git a/doc/C/usage-mainwindow.sgml b/doc/C/usage-mainwindow.sgml index 370403415d..3dcc38db86 100644 --- a/doc/C/usage-mainwindow.sgml +++ b/doc/C/usage-mainwindow.sgml @@ -302,7 +302,7 @@ Any time new information arrives in a folder, that folder label - is displayed as bold text. + is displayed in bold text. To delete a folder, right-click it and select @@ -324,10 +324,8 @@ items will relate to mail; some will relate to other components of Evolution and some, especially those in the File Menu will relate to the - application as a whole. This section describes those items that - cover the application as a whole; items specific to mailer are - discussed in the mail chapter, calendar items in the calendar - chapter, and so forth. + application as a whole. The contents of the menu bar are + described in . @@ -335,31 +333,11 @@ File Menu - Anything related to a file falls under this - menu: - - - New... — If you - want to create a new folder, calendar, - appointment, address card, or message, this is - where you should look. - - - - Go to Folder — - Select this item, then choose which folder you'd - like to view. - - - Exit — Quits the application. - - - - Print... — Opens the printing - dialog box so you can print items from the view pane of - Evolution. - - + Anything even related to a file or to the operations + of the application generally falls under this + menu: creating things, saving them to disk, + printing them, and quitting the program itself. + @@ -368,7 +346,7 @@ Although it doesn't contain anything at first, the Edit menu fills up with - useful editing tools when you're... editing. + useful tools that help you edit text and move it around. @@ -380,7 +358,8 @@ Configuration and the vFolder Editor. For the Calendar and the Contact - Manager + Manager, it's color, network, and layout + configuration. @@ -401,16 +380,17 @@ Help Menu Select among these items to open the - Help Browser to the appropriate section. + Help Browser + and read the Evolution manual. Once you've familiarized yourself with the main - window you can start doing things with it. We'lql - start with your email inbox: you've got a letter waiting for you - already. + window you can start doing things with it. We'll + start with your email inbox, since you've got a letter waiting + for you already. diff --git a/help/C/apx-gloss.sgml b/help/C/apx-gloss.sgml index 0f1b73ff09..5693ecda1c 100644 --- a/help/C/apx-gloss.sgml +++ b/help/C/apx-gloss.sgml @@ -227,6 +227,22 @@ + + Regular Expression + + + A regular expression, or "regex", is a way of describing a + string of text using metacharacters or wildcard symbols. For + example, the statement fly*so[a|u]p means + "any phrase beginning with 'fly' and ending in 'soup' or + 'soap'". If you searched for that expression, you'd find both + "fly in my soup" and "fly in my soap." There's not room here to + go into depth, but if you want, have a look at the documentation + for the grep command. + + + + Script @@ -282,3 +298,17 @@ + + + + + + + + + + + + + + diff --git a/help/C/apx-menuref.sgml b/help/C/apx-menuref.sgml deleted file mode 100644 index f47a921e31..0000000000 --- a/help/C/apx-menuref.sgml +++ /dev/null @@ -1,1062 +0,0 @@ - - - - Menu Reference - - This section will serve as a reference for every capability that - Evolution has. When menu items are - repeated in Evolution, they're repeated - here too. - - - From left to right, the menus available to you when you are - reading mail are: File, - Edit, View, - Tools, Actions, and - Help. The last of these doesn't change, but - the rest of them have contents that will change depending on - whether you're looking at mail, contacts, or calendar information. - In addition, the editor tools for messages, appointments, and - contacts all have menu bars. - - - - Menus that are the same everywhere - - The File and Help menus in - the main Evolution window do not - change, because they refer to universal items. Other menus have - contents that change depending on context. - - - - File Menu - - - - - New... Submenu - - - - Folder — - Create a new folder. See - for more information about folders. - - - Shortcut — - Create a new Shortcut in the Shortcut Bar. - - - Mail Message — - Compose a new mail message. Covered in - . - - - Appointment — - Enter a new appointment in your calendar. See for more information. - - - Task — - Enter a new to-do item in your taskpad. Covered in - . - - - - - - - Go to Folder - - View the items in a particular folder. - - - - - Create New Folder - - This item doesn't belong here any more. - - - - - Print Message - - Print the current message. - - - - - Exit - - Quit using Evolution. - - - - - - - - The Help Menu - - - - Help Index - - Displays the table of contents for this document. - - - - Getting Started - - A quick look around, and a summary of the things - Evolution can do for you. - - - - Using the Mailer - - An in-depth tour of Evolution Mail. - - - - Using the Calendar - - A step-by-step guide to using the Calendar. - - - - Using the Contact Manager - - Find your way around the Contact Manager. - - - - Submit Bug Report - - If you don't report them, they can't fix them. Select this item to let the - developers know what's wrong. - - - - About Evolution - - Displays a window with information about the application and its authors. - This has the same information as . - - - - - - - - - - Mail Menus - - All the menus for mail. FIXME: this paragraph needs content. - - - - The Edit Menu - - This menu is currently empty. - - - - - The View Menu - - This menu lets you control the way - Evolution displays your information - for you. - - - Show Shortcut Bar - - Toggle the shortcut bar on and off with this item. - - - - - Show Folder Bar - - Toggle the folder bar on and off with this item. - See for - more information about the folder bar. - - - - - Threaded Message List - - This item controls whether your message list is displayed by thread - or by other criteria. The default order is by date; see - for information about the - order of the message list. - - - - - - - - The Tools Menu - - - - Mail Filters - - Edit your mail filters here. - See - for more information about mail filtering. - - - - - vFolder Editor - - Create, edit, and delete vFolders with this tool. - To learn about using vFolders with mail, see - . - - - - - Mail Configuration - - This is a poorly named tool. You can set your identity, - and everything else related to your mail account, here. - - - - - Forget Passwords - - Although it's really an Action (FIXME), this item will cause - Evolution to forget what your - password is. - - - - - Configure Folder - - Another FIXME item, this allows you to set the file format - in which Evolution stores mail. - - - - - - - - The Actions Menu - - When you select one of the actions from this menu, - Evolution will do your bidding, - usually to the item you have selected. - - - The actions you can perform are: - - - Edit Message - - Select a message in the drafts folder before you select this - item. You can only edit a message you have written. FIXME: POOR - description of BROKEN behavior. - - - - - View Message - - Displays the selected message in a new window. - - - - - Mark all Messages Read - - Evolution keeps track of which messages - you've seen; When you don't need to read all those messages, select this item. - You can mark a single message as read by right-clicking it in the message bar. - - - - - Expunge - - Emtpies the trash folder, erasing messages permanently. - Once you've done this, don't come crying to me if you - want a message back. - - - - - - - - - The Message Composer Menus - - The message composition window has its own set of menus: - File, which controls operations on files and - data, Edit, for text editing, - Format, which controls the file format of - messages you send, View, to set how you view - the message, and Insert, which holds tools - for embedding files and other items in messages. Here's what's in them: - - - The Message Composer's File Menu - - - - Open - - Open a text file or a draft mail message. - - - - - Save - - Save a mail message as a text file. - - - - - Save As - - Choose a file name and location for - a message you want to save as a text file. - - - - - Save in Folder - - Save a message as a draft, rather than - as a seperate text file. (FIXME: should be removed, and - functionality subsumed under "Save As"). - - - - - Insert Text File - - Open a text file and insert it into - the current message. (FIXME: belongs under "Insert"). - - - - - Send - - Sends the message immediately. - - - - - Close - - Closes the message composer. If you have not done so, - Evolution - will ask you if you want to save your message. - - - - - - - The Message Composer's Edit Menu - - The Edit menu in the message composer - contains the following items. Keyboard shortcuts are listed - next to the items in the menus themselves. - - - - - Undo - - Undoes the last action you performed. - - - - - Redo - - If you change your mind about Undoing something, - you can always use this item. - - - - - Cut - - Removes the selected text from the text entry window and - retains it in the system "clipboard" memory, ready for pasting. - - - - - Copy - - Copies selected text to the system clipboard without deleting it. - The text can then be inserted elsewhere with the - Paste command. - - - - - Paste - - Inserts the contents of the system clipboard at the - location of the cursor. - - - - - Find - - Enter a phrase and find your match in your message body. - As with Find Regex, - Find Again, and - Replace, Evolution - will offer you the option to search forwards or backwards, and. - - - - - - Find Regex - - If you are familiar with regular expressions, often called - "regexes," you can search for something more complicated, - using wildcards and boolean logic. If you're not familiar with - them, there are numerous resources for you on the web. - - - - - Find Again - - Repeats your last search. - - - - - Replace - - Enter a word or phrase and the word or phrase with which you'd like - to replace it. - - - - - Properties - - This item brings up the Message Composer Properties Capplet, - a portion of the GNOME Control Center that determines the - key bindings for the message composer. Help for this capplet is - available directly from the Control Center. - (FIXME: Write that help doc too) (FIXME: this is in the wrong place!) - - - - - - - - The Message Composer's Format Menu - - The Format menu has only one item: - - - HTML - - Toggles HTML mode for the message composer. When selected, - the message is displayed and sent in HTML. If you have written a - message in HTML and turn HTML off, most formatting will be lost. - Evolution will attempt to preserve spacing - and to remove formatting gracefully, however. - - - - - - - The Message Composer's View Menu - - The View menu controls the way messages are - displayed, and how much of the message, its headers, and - attachments appear. It contains: - - - Show Attachments - - Toggles the display of attachments. When this item is selected, - Evolution will create a seperate pane - of the composition window to show what attachments you are appending - to the message. - - - - - - - The Message Composer's Insert Menu - - The Insert menu holds tools that allow you - to include images, horizontal rules, and other objects - in the body of your message. The tools are: - - - - Image - - This tool will prompt you to select an image file to - insert into your HTML message. For text messages, this - is the same as attaching an image file. - - - - - Link - - Opens the link creation window, - which lets you specify the URL and text description - for a link in your message. This only works with HTML - messages. - - - - - Rule - - Opens the horizontal rule creation dialog, which lets you - create an HTML horizontal rule. For more information, - see . - This tool only works with HTML messages. - - - - - Text File - - Open a text file and insert it into the current message. - This tool works with both plain text and HTML messages. - - - - - - - - - The Calendar Menus - - The Main window of the calendar has the same menus as the main - window of the mail client. However, their contents vary in a - number of ways. - - - The Calendar Edit Menu - - The contents of the Edit menu are currently so borked that I - refuse to document them right now. (That means FIXME). They - should be: - - - - Item - - Description - - - - Item - - Description - - - - - Item - - Description - - - - - - - The Calendar View Menu - - The Calendar's View menu contains the following items: - - - - Show Shortcut Bar - - Toggle the Shortcut Bar on and off with this item. - - - - - Show Folder Bar - - Toggle the folder bar on and off with this item. - See for - more information about the folder bar. - - - - - View By Day - - Switch to the day view for your calendar. - - - - - View Five Days - - View five calendar days at once. - - - - - View by Week - - Switch the calendar view to full week mode. - - - - - View By Month - - Look at a month at a time. - - - - - - - - The Calendar Tools Menu - - This menu is empty. - - - - - The Calendar Actions Menu - - This menu is empty. - - - - - - The Appointment Editor Menus - - FIXME: Insert Content Here. - - - - The Appintment Editor's File Menu - - This menu contains several items, including a New - that is identical to that in the - main window's file menu. - Its other contents are: - - - - Send - - Opens a mail message with the appointment attached to it. - - - - - - Save - - Save this appointment in the existing location and name. If you have not yet - chosen a location and name, this is the same as Save As. - - - - - - Save As - - Choose a location and name for this appointment, and save it. - - - - - Delete - - Deletes the appointment. - - - - - Move to Folder - - Chose a folder, and move the appointment into it. - - - - - - Copy to Folder - - Chose a folder, and put a copy of the appointment into it. - - - - - - Page Setup Submenu - - This menu contains two items: - - - Memo Style — - FIXME: What does this do? - - - - Define Print Styles — - FIXME: What does this do? - - - - - - - Print Preview - - Shows you what your appointment will look like if you print it. - - - - - - Print - - Prints the appointment without preview. - - - - - - Properties - - FIXME: What does this do? - - - - - - Close - - Close the appointment editor window. - - - - - - - - The Appintment Editor's Edit Menu - - FIXME: this menu is copied and pasted entirely from somewhere - else. - - - - - The Appintment Editor's View Menu - - This menu allows you to look at different appointments, and - set the way you look at them, without having to move back to - the Main Window. It contains: - - - - Previous - - The items in this submenu will take you to appointments - prior to the current one. (FIXME: describe). - - - - - Next - - The items in this submenu will take you to appointments - scheduled to occur after the current one. (FIXME: describe). - - - - - Calendar - - FIXME: What does this item do? - - - - - Toolbars - - The Toolbars submenu - allows you to choose which toolbars - are displayed in the - Appointment Editor. They are: - - - Standard — - Toggle the standard toolbar on and off. - - - - Formatting — - Toggle the formatting toolbar on and off. - - - - Customize — - Select the contents of the formatting and standard toolbars. - - - - - - - - - - The Appintment Editor's Insert Menu - - This menu contains: (FIXME: Insert Content Here) - - - File - - Choose a file to append to your appointment or appointment request. - - - - - - Item - - FIXME: ? - - - - - - Object - - FIXME: ? - - - - - - - - The Appintment Editor's Format Menu - - This menu contains two items, neither of which - have any functionality yet: - - - Font - - FIXME: ? - - - - - - Paragraph - - FIXME: ? - - - - - - - - The Appintment Editor's Tools Menu - - - This menu contains four items, none of which - have any functionality yet: - - - Item - - FIXME: ? - - - - - Item - - FIXME: ? - - - - - - - - The Appintment Editor's Actions Menu - - This menu contains: - - - - Invite Attendees - - Invite the listed attendees to the current event (via email). - You may be prompted to specify an invitation message. - - - - - Cancel Invitation - - Cancels the event, notifying all attendees. You may be prompted - to specify an invitation message. - - - - - Forward as vCalendar - - Opens the message composer with the current event attached. - - - - - Forward as Text - - Opens the message composer with a text description of the current - event included in the message body. - - - - - - - - The Appintment Editor's File Menu - - This menu is empty. - - - - - - - Contact Manager Menus - - Insert Content Here (FIXME). - - - - Contact Manager Edit Menu - - This menu is empty. - - - - - - Contact Manager Edit Menu - - This menu contains the following items: - - - - Show Shortcut Bar - - Toggle the Shortcut Bar on and off with this item. - - - - - Show Folder Bar - - Toggle the folder bar on and off with this item. - See for - more information about the folder bar. - - - - - As Table - - View your contacts as a table. - When in table-view mode, this menu item reads - As Minicards, and changes the view - back to the minicard format. - - - - - - - - Contact Manager Tools Menu - - This menu is empty. - - - - - - - Contact Manager Tools Menu - - This menu is broken. (FIXME). - - - - - - 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. - - - - - - - - - - - - diff --git a/help/C/evolution-guide.sgml b/help/C/evolution-guide.sgml index f7a7a87ab2..0eff8b99a0 100644 --- a/help/C/evolution-guide.sgml +++ b/help/C/evolution-guide.sgml @@ -1,4 +1,5 @@ @@ -9,18 +10,18 @@ - + - ]> + A User's Guide to Evolution @@ -115,7 +116,18 @@ &CONFIG-SYNC; - &APX-MENUREF; + + Comprehensive Menu reference + + + The following reference covers all, or nearly all, of the + menus and menu commands that + Evolution has to offer you. + + + &MENUREF; + + &APX-GLOSS; &APX-BUGS; &APX-AUTHORS; diff --git a/help/C/menuref.sgml b/help/C/menuref.sgml new file mode 100644 index 0000000000..b4ae8d4f83 --- /dev/null +++ b/help/C/menuref.sgml @@ -0,0 +1,1196 @@ + + + + Menu Reference + + This section will serve as a reference for every capability that + Evolution has. When menu items are + repeated in Evolution, they're repeated + here too. + + + From left to right, the menus available to you when you are + reading mail are: File, + Edit, View, + Tools, Actions, and + Help. The last of these doesn't change, but + the rest of them have contents that will change depending on + whether you're looking at mail, contacts, or calendar information. + In addition, the editor tools for messages, appointments, and + contacts all have menu bars. + + + + Menus that are the same everywhere + + The File and Help menus in + the main Evolution window do not + change, because they refer to universal items. Other menus have + contents that change depending on context. + + + + File Menu + + + + + New... Submenu + + + + Folder — + Create a new folder. See + for more information about folders. + + + Shortcut — + Create a new Shortcut in the Shortcut Bar. + + + Mail Message — + Compose a new mail message. Covered in + . + + + Appointment — + Enter a new appointment in your calendar. See for more information. + + + Task — + Enter a new to-do item in your taskpad. Covered in + . + + + + + + + Go to Folder + + View the items in a particular folder. + + + + + Create New Folder + + This item doesn't belong here any more. + + + + + Print Message + + Print the current message. + + + + + Exit + + Quit using Evolution. + + + + + + + + The Help Menu + + + + Help Index + + Displays the table of contents for this document. + + + + Getting Started + + A quick look around, and a summary of the things + Evolution can do for you. + + + + Using the Mailer + + An in-depth tour of Evolution Mail. + + + + Using the Calendar + + A step-by-step guide to using the Calendar. + + + + Using the Contact Manager + + Find your way around the Contact Manager. + + + + Submit Bug Report + + If you don't report them, they can't fix them. Select this item to let the + developers know what's wrong. + + + + About Evolution + + Displays a window with information about the application and its authors. + This has the same information as . + + + + + + + + + + Mail Menus + + All the menus for mail. FIXME: this paragraph needs content. + + + + The Edit Menu + + This menu is currently empty. + + + + + The View Menu + + This menu lets you control the way + Evolution displays your information + for you. + + + Show Shortcut Bar + + Toggle the shortcut bar on and off with this item. + + + + + Show Folder Bar + + Toggle the folder bar on and off with this item. + See for + more information about the folder bar. + + + + + Threaded Message List + + This item controls whether your message list is displayed by thread + or by other criteria. The default order is by date; see + for information about the + order of the message list. + + + + + + + + The Tools Menu + + + + Mail Filters + + Edit your mail filters here. + See + for more information about mail filtering. + + + + + vFolder Editor + + Create, edit, and delete vFolders with this tool. + To learn about using vFolders with mail, see + . + + + + + Mail Configuration + + This is a poorly named tool. You can set your identity, + and everything else related to your mail account, here. + + + + + Forget Passwords + + Although it's really an Action (FIXME), this item will cause + Evolution to forget what your + password is. + + + + + Configure Folder + + Another FIXME item, this allows you to set the file format + in which Evolution stores mail. + + + + + + + + The Actions Menu + + When you select one of the actions from this menu, + Evolution will do your bidding, + usually to the item you have selected. + + + The actions you can perform are: + + + Edit Message + + Select a message in the drafts folder before you select this + item. You can only edit a message you have written. FIXME: POOR + description of BROKEN behavior. + + + + + View Message + + Displays the selected message in a new window. + + + + + Mark all Messages Read + + Evolution keeps track of which messages + you've seen; When you don't need to read all those messages, select this item. + You can mark a single message as read by right-clicking it in the message bar. + + + + + Expunge + + Emtpies the trash folder, erasing messages permanently. + Once you've done this, don't come crying to me if you + want a message back. + + + + + + + + + The Message Composer Menus + + The message composition window has its own set of menus: + File, which controls operations on files and + data, Edit, for text editing, + Format, which controls the file format of + messages you send, View, to set how you view + the message, and Insert, which holds tools + for embedding files and other items in messages. Here's what's in them: + + + The Message Composer's File Menu + + + + Open + + Open a text file or a draft mail message. + + + + + Save + + Save a mail message as a text file. + + + + + Save As + + Choose a file name and location for + a message you want to save as a text file. + + + + + Save in Folder + + Save a message as a draft, rather than + as a seperate text file. (FIXME: should be removed, and + functionality subsumed under "Save As"). + + + + + Insert Text File + + Open a text file and insert it into + the current message. (FIXME: belongs under "Insert"). + + + + + Send + + Sends the message immediately. + + + + + Close + + Closes the message composer. If you have not done so, + Evolution + will ask you if you want to save your message. + + + + + + + The Message Composer's Edit Menu + + The Edit menu in the message composer + contains the following items. Keyboard shortcuts are listed + next to the items in the menus themselves. + + + + + Undo + + Undoes the last action you performed. + + + + + Redo + + If you change your mind about Undoing something, + you can always use this item. + + + + + Cut + + Removes the selected text from the text entry window and + retains it in the system "clipboard" memory, ready for pasting. + + + + + Copy + + Copies selected text to the system clipboard without deleting it. + The text can then be inserted elsewhere with the + Paste command. + + + + + Paste + + Inserts the contents of the system clipboard at the + location of the cursor. + + + + + Find + + Enter a phrase and find your match in your message body. + As with Find Regex, + Find Again, and + Replace, Evolution + will offer you the option to search forwards or backwards, and. + + + + + + Find Regex + + If you are familiar with regular expressions, often called + "regexes," you can search for something more complicated, + using wildcards and boolean logic. If you're not familiar with + them, there are numerous resources for you on the web. + + + + + Find Again + + Repeats your last search. + + + + + Replace + + Enter a word or phrase and the word or phrase with which you'd like + to replace it. + + + + + Properties + + This item brings up the Message Composer Properties Capplet, + a portion of the GNOME Control Center that determines the + key bindings for the message composer. Help for this capplet is + available directly from the Control Center. + (FIXME: Write that help doc too) (FIXME: this is in the wrong place!) + + + + + + + + The Message Composer's Format Menu + + The Format menu has only one item: + + + HTML + + Toggles HTML mode for the message composer. When selected, + the message is displayed and sent in HTML. If you have written a + message in HTML and turn HTML off, most formatting will be lost. + Evolution will attempt to preserve spacing + and to remove formatting gracefully, however. + + + + + + + The Message Composer's View Menu + + The View menu controls the way messages are + displayed, and how much of the message, its headers, and + attachments appear. It contains: + + + Show Attachments + + Toggles the display of attachments. When this item is selected, + Evolution will create a seperate pane + of the composition window to show what attachments you are appending + to the message. + + + + + + + The Message Composer's Insert Menu + + The Insert menu holds tools that allow you + to include images, horizontal rules, and other objects + in the body of your message. The tools are: + + + + Image + + This tool will prompt you to select an image file to + insert into your HTML message. For text messages, this + is the same as attaching an image file. + + + + + Link + + Opens the link creation window, + which lets you specify the URL and text description + for a link in your message. This only works with HTML + messages. + + + + + Rule + + Opens the horizontal rule creation dialog, which lets you + create an HTML horizontal rule. For more information, + see . + This tool only works with HTML messages. + + + + + Text File + + Open a text file and insert it into the current message. + This tool works with both plain text and HTML messages. + + + + + + + + Contextual Menus in Evolution Mail + + The following menus appear when you right-click on something: + + + + Right-click menu for messages in the message list + + + + + Open in New Window + + Open a new window to read this message. + + + + + Edit this Message + + Available only for messages you have + written and saved to the Drafts + or Outbox folders, this opens the + message in a message composition window, so you can alter it. + + + + + Print + + Opens the Print Preview window in preparation + for printing the message. + + + + + Reply to Sender + + Opens a message composition window addressed to the + author of the message. Covered in detail in + . + + + + + Reply to All + + Opens a message composition window addressed to the + author of the message and all known recipients. + Covered in detail in . + + + + + Forward + + Appends the body of the selected message to a new message. + Covered in detail in . + + + + + Delete Message + + Marks a message for deletion. + + + + + Move Message + + Choose a folder in which to place this message. + + + + + VFolder on Subject + + This item, and the three that follow it, will create vFolders + which you may customize further or save as-is. This one will + create a vFolder which will display all messages that contain the + subject line of the selected message. + + + + + VFolder on Sender + + Creates a vFolder to hold all messages from the sender of + the selected message. + + + + + + VFolder on Recipients + + Creates a VFolder to hold all messages addressed to the + recipient of the selected message. + + + + + Filter on Subject + + This item, and the three that follow it, will create Filters + for which you must select actions. You may keep the criteria as + they are, or alter them as you wish. This one will + create a filter which will affect all messages that contain the + subject line of the selected message. + + + + + Filter on Sender + + Creates a Filter which affects all messages from the sender of + the selected message. + + + + + + Filter on Recipients + + Creates a filter which will affect all messages addressed to the + recipient of the selected message. + + + + + + + + + The Calendar Menus + + The Main window of the calendar has the same menus as the main + window of the mail client. However, their contents vary in a + number of ways. + + + The Calendar Edit Menu + + The contents of the Edit menu are currently so borked that I + refuse to document them right now. (That means FIXME). They + should be: + + + + Item + + Description + + + + Item + + Description + + + + + Item + + Description + + + + + + + The Calendar View Menu + + The Calendar's View menu contains the following items: + + + + Show Shortcut Bar + + Toggle the Shortcut Bar on and off with this item. + + + + + Show Folder Bar + + Toggle the folder bar on and off with this item. + See for + more information about the folder bar. + + + + + View By Day + + Switch to the day view for your calendar. + + + + + View Five Days + + View five calendar days at once. + + + + + View by Week + + Switch the calendar view to full week mode. + + + + + View By Month + + Look at a month at a time. + + + + + + + + The Calendar Tools Menu + + This menu is empty. + + + + + The Calendar Actions Menu + + This menu is empty. + + + + + + The Appointment Editor Menus + + FIXME: Insert Content Here. + + + + The Appintment Editor's File Menu + + This menu contains several items, including a New + that is identical to that in the + main window's file menu. + Its other contents are: + + + + Send + + Opens a mail message with the appointment attached to it. + + + + + + Save + + Save this appointment in the existing location and name. If you have not yet + chosen a location and name, this is the same as Save As. + + + + + + Save As + + Choose a location and name for this appointment, and save it. + + + + + Delete + + Deletes the appointment. + + + + + Move to Folder + + Chose a folder, and move the appointment into it. + + + + + + Copy to Folder + + Chose a folder, and put a copy of the appointment into it. + + + + + + Page Setup Submenu + + This menu contains two items: + + + Memo Style — + FIXME: What does this do? + + + + Define Print Styles — + FIXME: What does this do? + + + + + + + Print Preview + + Shows you what your appointment will look like if you print it. + + + + + + Print + + Prints the appointment without preview. + + + + + + Properties + + FIXME: What does this do? + + + + + + Close + + Close the appointment editor window. + + + + + + + + The Appintment Editor's Edit Menu + + FIXME: this menu is copied and pasted entirely from somewhere + else. + + + + + The Appintment Editor's View Menu + + This menu allows you to look at different appointments, and + set the way you look at them, without having to move back to + the Main Window. It contains: + + + + Previous + + The items in this submenu will take you to appointments + prior to the current one. (FIXME: describe). + + + + + Next + + The items in this submenu will take you to appointments + scheduled to occur after the current one. (FIXME: describe). + + + + + Calendar + + FIXME: What does this item do? + + + + + Toolbars + + The Toolbars submenu + allows you to choose which toolbars + are displayed in the + Appointment Editor. They are: + + + Standard — + Toggle the standard toolbar on and off. + + + + Formatting — + Toggle the formatting toolbar on and off. + + + + Customize — + Select the contents of the formatting and standard toolbars. + + + + + + + + + + The Appintment Editor's Insert Menu + + This menu contains: (FIXME: Insert Content Here) + + + File + + Choose a file to append to your appointment or appointment request. + + + + + + Item + + FIXME: ? + + + + + + Object + + FIXME: ? + + + + + + + + The Appintment Editor's Format Menu + + This menu contains two items, neither of which + have any functionality yet: + + + Font + + FIXME: ? + + + + + + Paragraph + + FIXME: ? + + + + + + + + The Appintment Editor's Tools Menu + + + This menu contains four items, none of which + have any functionality yet: + + + Item + + FIXME: ? + + + + + Item + + FIXME: ? + + + + + + + + The Appintment Editor's Actions Menu + + This menu contains: + + + + Invite Attendees + + Invite the listed attendees to the current event (via email). + You may be prompted to specify an invitation message. + + + + + Cancel Invitation + + Cancels the event, notifying all attendees. You may be prompted + to specify an invitation message. + + + + + Forward as vCalendar + + Opens the message composer with the current event attached. + + + + + Forward as Text + + Opens the message composer with a text description of the current + event included in the message body. + + + + + + + + The Appintment Editor's File Menu + + This menu is empty. + + + + + + + Contact Manager Menus + + Insert Content Here (FIXME). + + + + Contact Manager Edit Menu + + This menu is empty. + + + + + + Contact Manager Edit Menu + + This menu contains the following items: + + + + Show Shortcut Bar + + Toggle the Shortcut Bar on and off with this item. + + + + + Show Folder Bar + + Toggle the folder bar on and off with this item. + See for + more information about the folder bar. + + + + + As Table + + View your contacts as a table. + When in table-view mode, this menu item reads + As Minicards, and changes the view + back to the minicard format. + + + + + + + + Contact Manager Tools Menu + + This menu is empty. + + + + + + + Contact Manager Tools Menu + + This menu is broken. (FIXME). + + + + + + 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. + + + + + + + + + + + + diff --git a/help/C/preface.sgml b/help/C/preface.sgml index c7f6c2824d..f456be0e22 100644 --- a/help/C/preface.sgml +++ b/help/C/preface.sgml @@ -167,11 +167,11 @@ - A Quick Reference to Common Tasks + Quick Reference for 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 + You might want to get a copy of this section and tape it 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. @@ -305,7 +305,7 @@ - Reply to Message + Reply to a message Message Select the message to which you want to reply, and @@ -321,7 +321,7 @@ - Forward Message + Forward a Message Select the message you want to forward, and @@ -360,7 +360,6 @@ Calendar - diff --git a/help/C/usage-mail.sgml b/help/C/usage-mail.sgml index ed101f6884..ad7419f330 100644 --- a/help/C/usage-mail.sgml +++ b/help/C/usage-mail.sgml @@ -48,6 +48,7 @@ Reading, Getting and Sending Mail + Reading Mail @@ -55,161 +56,37 @@ Inbox in the shortcut bar. By default, the Inbox is open when you start Evolution, and the first - time you see your inbox, there's a message in it from Helix + time you see your Inbox, there's a message in it from Helix Code welcoming you to the application. - The first time you open your - Evolution - Inbox, you will see a window like the one - in , with a message from - Helix Code in the message list. The - message is displayed below that, in the view - pane. If you find the view - pane too small, you can double-click on the - message in the message list to have it - open in a new window. As is the case with folders, you can - right-click on messages in the message list and get a menu of - possible actions: - - - - Open in New Window - - Select this item to view the message in - a new Evolution - window. - - - - - Edit Message - - This item is available only for messages and drafts - that you have written. Select it to open the message - composer and make changes to the message. - - + 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 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. + - - Print Message - - Select this item to print a message. - - - - - Reply to Sender - - Use this item to reply only to the author of the message. - - + + +
+ Evolution Mail + + Inbox + + + +
+ - - Reply to All - - Send a reply to the author of the message - and to all others on the recipient list. See for more information. - - - - - Forward Message - - Send the message on to another person. - See for - information about how to use the Forward feature. - - - - - Delete Message - - Mark the message for deletion. Choose - ActionsExpunge - to delete marked messages permanently. - - - - Move Message - - Select this item to move the message to another folder. - This will open a dialog to let you choose the destination - from a folder tree. - - - - vFolder for Subject - - Select this item to create a pre-fabricated vFolder based on - the current message's Subject line. - - - - vFolder for Sender - - Select this item to create a pre-fabricated vFolder based on - who sent the current message. - - - - vFolder for Recipients - - Select this item to create a pre-fabricated vFolder based on - who the recipients are. - - - - Filter for Subject - - Select this item to create a pre-fabricated filter based on - the current message's Subject line. - - - - Filter for Sender - - Select this item to create a pre-fabricated filter based on - who sent the current message. - - - - Filter for Recipients - - Select this item to create a pre-fabricated filter based on - who the recipients are. - - - - - - - The Order of the Message List - - You can also select the order in which messages appear in - that list. 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. - - - Aside from sorting the messages, you can opt to have the - messages threaded. Select - View Threaded Message - List to turn the threaded view - on or off. If the option selected, - Evolution will attempt to - associate related messages by using the - References, - In-Reply-To, and - Subject message headers. Messages - which are related are then placed next to each other, so - that it's easier to follow the thread of a conversation from - message to message. - - Other actions you can perform are listed, appropriately, in the Actions menu in the menu bar: @@ -249,6 +126,35 @@ + + Sorting the message list + + You can also select the order in which messages appear in + that list. 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. + + + Aside from sorting the messages, you can opt to have the + messages threaded. Select + View Threaded Message + List to turn the threaded view + on or off. If the option selected, + Evolution will attempt to + associate related messages by using the + References, + In-Reply-To, and + Subject message headers. Messages + which are related are then placed next to each other, so + that it's easier to follow the thread of a conversation from + message to message. + + + + + + Checking Mail + Now that you've had a look around the Inbox, select the welcome message in @@ -263,22 +169,8 @@ marked as deleted. At some point in the future, this feature will change to something a little less counter-intuitive. - - -
- Evolution Mail - - Inbox - - - -
- - - - Checking Mail To check your email, just click Get mail in the toolbar. If this is the first time @@ -620,18 +512,10 @@ with quoted materials and the relevant replies interspersed--> Find Regex - Regular expressions, often called "regex" for short, - are a powerful way of expressing complicated - statements using metacharacters or wildcard symbols. - For example, the statement - fly*so[a|u]p means "any - phrase beginning with 'fly' and ending in 'soup' or - 'soap'", so you'd find both "fly in my soup" and - "fly in my soap." There's not room here to go into - depth here, but if you want, have a look at the - documentation for the grep - command. - + Perform a search for a regular + expression, or "regex." + + diff --git a/help/C/usage-mainwindow.sgml b/help/C/usage-mainwindow.sgml index 370403415d..3dcc38db86 100644 --- a/help/C/usage-mainwindow.sgml +++ b/help/C/usage-mainwindow.sgml @@ -302,7 +302,7 @@ Any time new information arrives in a folder, that folder label - is displayed as bold text. + is displayed in bold text. To delete a folder, right-click it and select @@ -324,10 +324,8 @@ items will relate to mail; some will relate to other components of Evolution and some, especially those in the File Menu will relate to the - application as a whole. This section describes those items that - cover the application as a whole; items specific to mailer are - discussed in the mail chapter, calendar items in the calendar - chapter, and so forth. + application as a whole. The contents of the menu bar are + described in . @@ -335,31 +333,11 @@ File Menu - Anything related to a file falls under this - menu: - - - New... — If you - want to create a new folder, calendar, - appointment, address card, or message, this is - where you should look. - - - - Go to Folder — - Select this item, then choose which folder you'd - like to view. - - - Exit — Quits the application. - - - - Print... — Opens the printing - dialog box so you can print items from the view pane of - Evolution. - - + Anything even related to a file or to the operations + of the application generally falls under this + menu: creating things, saving them to disk, + printing them, and quitting the program itself. + @@ -368,7 +346,7 @@ Although it doesn't contain anything at first, the Edit menu fills up with - useful editing tools when you're... editing. + useful tools that help you edit text and move it around. @@ -380,7 +358,8 @@ Configuration and the vFolder Editor. For the Calendar and the Contact - Manager + Manager, it's color, network, and layout + configuration. @@ -401,16 +380,17 @@ Help Menu Select among these items to open the - Help Browser to the appropriate section. + Help Browser + and read the Evolution manual. Once you've familiarized yourself with the main - window you can start doing things with it. We'lql - start with your email inbox: you've got a letter waiting for you - already. + window you can start doing things with it. We'll + start with your email inbox, since you've got a letter waiting + for you already. -- cgit v1.2.3