--- /dev/null
+<chapter>
+ <title>
+ Frequently Asked Questions
+ </title>
+ <summary>
+ Often people have the same questions that have been asked many times
+ before. This is a list of commonly asked questions and answers.
+ </summary>
+</chapter>
+
+<section>
+ <title>
+ Can I use multiple names from the address book?
+ </title>
+ <description>
+ <p>
+ Yes. The address book search will display all matches for the
+ search criteria entered in the search box. If 10 names are displayed
+ any combination may be selected for either the <B>To:</B> or <B>CC:</B>
+ fields. All selected addresses will be inserted into the proper
+ filed when the Use Address button is pressed.
+ </p>
+ </description>
+</section>
+
+<section>
+ <title>
+ Can I add names directly to the address book from a email?
+ </title>
+ <description>
+ <p>
+ No. At this time you cannot add names directly from a received email
+ to the address book. You can, however, right click on the address and
+ save it to the clipboard and paste this into the address book. Try
+ not to be disappointed. SquirrelMail is under continual development
+ and this might be included in the future in one form or another.
+ </p>
+ </description>
+</section>
+
+<section>
+ <title>
+ Who made SquirrelMail?
+ </title>
+ <description>
+ <p>
+ A lot of people helped out. To get a list of them, you can visit our
+ web site <a href="http://www.squirrelmail.org" target=_top>www.squirrelmail.org</a>.
+ </p>
+ </description>
+</section>
+
+<section>
+ <title>
+ What is webmail?
+ </title>
+ <description>
+ <p>
+ In SquirrelMail's case it gives you access through the IMAP protocol
+ to your email account. These means you don't have to figure out how
+ to setup someone else's stuff just to check your mail.
+ </p>
+ </description>
+</section>
+
+<section>
+ <title>
+ Where can I use this webmail?
+ </title>
+ <description>
+ <p>
+ Any where there is a browser available.
+ Wireless access (WAP/WML) is not on the drawing board at this time though.
+ </p>
+ </description>
+</section>
+
+<section>
+ <title>
+ Why use webmail instead of a regular email client?
+ </title>
+ <description>
+ <p>
+ It is doubtful that webmail will ever be a complete substitute for
+ a regular email client. But hey, who knows? Anyway, If you ever
+ were at a friends house, on a trip, at home or work and away from
+ your computer and wanted to check your mail you already know why.
+ Because it is a huge hassle to set your mail up on their computer
+ and then delete it again. SquirrelMail is designed to be a supplement
+ to your normal email client.
+ </p>
+ </description>
+</section>
+
+<section>
+ <title>
+ How does this stuff work?
+ </title>
+ <description>
+ <p>
+ SquirrelMail uses the IMAP protocol, info on it can be found
+ <A HREF="http://imap.org"/>here</A>. The program also uses
+ its own IMAP functions, not those built in to PHP4. This won't
+ matter to anybody except those responsible for installing it,
+ but trust us when we say they appreciate it.
+ </p>
+ </description>
+</section>
--- /dev/null
+<chapter>
+ <title>
+ Addresses
+ </title>
+ <summary>
+ Address books can save a lot of time and typing. You can put the
+ addresses of people you write most often in them, and reuse them
+ over and over.
+ </summary>
+ <description>
+ <p>
+ Address books are a great time saving feature. Frequently used
+ addresses may be stored here. LDAP servers (Often used in companies
+ and universities to make organization-wide addresses easily available)
+ are supported as well.
+ </p>
+ <p>
+ If your Browser supports Javascript then you might want to enable the
+ JavaScript based address book under the Options menu item. It is a really
+ nifty little pop-up thing. Pure HTML address lists are supported so
+ even browsers without Javascript support can use SquirrelMail without
+ any loss of function.
+ </p>
+ </description>
+</chapter>
+
+<section>
+ <title>
+ Nick Name
+ </title>
+ <description>
+ <p>
+ Put a familiar name here. Something to help jog your memory.
+ Anything that will give you an accurate idea to whom this email
+ address belongs.
+ </p>
+ </description>
+</section>
+
+<section>
+ <title>
+ Email Address
+ </title>
+ <description>
+ <p>
+ This must be the persons' fully qualified email address. Guessing here
+ just won't cut it. There are three parts to an email address. First is
+ the recipients identifier, such as "johnq" Next is the domain name
+ section, which could take the form "tayloru". Last comes the top level
+ domain, which could be one of a ton of things like au, cc, us, com, org,
+ net or might look like edu. So if we put all those together it must be
+ in the form of johnq@tayloru.edu. If this is not correct you are likely
+ to get your mail back in the form of a bounced message.
+ </p>
+ </description>
+</section>
+
+<section>
+ <title>
+ Info
+ </title>
+ <description>
+ <p>
+ This is another field where you can put something to remind you about
+ who this person is. This is made to be longer than the "Nick Name".
+ For instance, if you meet a business contact, you could put "Met at
+ the Tomatoe Symposium".
+ </p>
+ </description>
+</section>
+
+<section>
+ <title>
+ Edit or Delete
+ </title>
+ <description>
+ <p>
+ These two buttons allow you to select a single address and then change
+ any of the above fields, or delete the entry entirely. You are only
+ allowed to select one entry at a time for the edit button.
+ </p>
+ </description>
+</section>
+
+<section>
+ <title>
+ Add to Personal address book
+ </title>
+ <description>
+ <p>
+ Fill in the fields as they are listed. The first three (Nickname,
+ E-mail address, and First name) must be filled in. Both Last name and
+ Additional info are optional.
+ </p>
+ </description>
+</section>
+
+<section>
+ <title>
+ LDAP
+ </title>
+ <description>
+ <p>
+ LDAP is a protocol for central unified storage and remote access of
+ information. For example; a university might use LDAP as the single
+ place where all students, staff, and faculty email addresses are
+ stored and made available. If configured to use the universities
+ LDAP server, SquirrelMail would then be able to list all campus email
+ address (along with the other address book fields if available).
+ SquirrelMail's LDAP use is truly powerful in that it <I>combines</I>
+ your local address book and the LDAP address server information to
+ present all of the information as if it was a single address book.
+ </p><p>
+ The LDAP setting may be configured to use any LDAP server, or disabled
+ as a feature altogether. You will need to talk to you system
+ administrator about this feature if you have specific questions.
+ </p><p>
+ LDAP settings affect the entire SquirrelMail system; as a result they
+ must be set up or altered by someone with administrative authority.
+ </p>
+ </description>
+</section>
--- /dev/null
+<chapter>
+ <title>
+ Introduction to SquirrelMail
+ </title>
+ <summary>
+ SquirrelMail provides a way of checking your E-Mail over the World Wide
+ Web.
+ </summary>
+ <description>
+ <p>
+ So what exactly is <A HREF="http://www.squirrelmail.org/index.php3?from=1">SquirrelMail</A>?
+ It's a web interface to email that's written in <A HREF="http://www.php.net">PHP4</A>.
+ It was designed to allow email access through your server from
+ anywhere in the world via the Web. More information about exactly
+ how it does this and the IMAP protocol can be found <A HREF="http://imap.org">here</A>.
+ </p>
+ </description>
+</chapter>
+
+<section>
+ <title>
+ The Basics
+ </title>
+ <description>
+ <p>
+ If you just have a quick question, you might want to look at the FAQ.
+ </p>
+ <p>
+ SquirrelMail is laid out in two main sections called frames. The
+ left frame lists the currently subscribed folders. More information
+ about the left frame may be found under the "Folders" section of this
+ help documentation.
+ </p>
+ <p>
+ On the right is where most of the action will take place. At the
+ top of the page is a menu bar. Sign out will safely log you out of
+ the program when you are finished. The Current Folder displays which
+ of the folders listed in the left frame you are currently in.
+ Right after you log in, by default your INBOX will be shown.
+ </p>
+ <p>
+ Under the top bar is a row of menu choices:
+ <ul>
+ <li><b>Compose</b> - Make and send an email which may include attachments.
+ <li><b>Addresses</b> - Holds a list of addresses that are contained in your personal address book.
+ <li><b>Folders</b> - All folder manipulation takes place under this. You can delete, create, rename, subscribe, and unsubscribe folders.
+ <li><b>Options</b> - Change settings of how SquirrelMail responds and looks.
+ <li><b>Search</b> - With this tool, you can search through a mailbox for given criteria.
+ <li><b>Help</b> - You are already here!
+ </ul>
+ </p>
+ </description>
+</section>
--- /dev/null
+<chapter>
+ <title>
+ Compose
+ </title>
+ <summary>
+ With this feature, you can send messages to different people
+ from within SquirrelMail.
+ </summary>
+ <description>
+ <p>
+ The Compose menu choice will take you to a new Compose page.
+ Here you will find several fields and a couple of buttons.
+ Depending on how you got to the compose view, some of these
+ fields may already be filled in.
+ </p>
+ </description>
+</chapter>
+
+<section>
+ <title>
+ To
+ </title>
+ <description>
+ <p>
+ First among these is the <B>To:</B> field. In this field you should
+ enter the email address of the person or persons you are sending a
+ message to. You may enter as many addresses as you like, separating
+ them with a coma. One may also press the "Addresses" button to fill
+ in the field. Don't worry if the entire address is not displayed.
+ The field is a fixed length but everything you put in it will be used,
+ even though it might scroll to the right or left.
+ </p>
+ </description>
+</section>
+
+<section>
+ <title>
+ Cc
+ </title>
+ <description>
+ <p>
+ Next is the <B>CC:</B> field. CC is an abbreviation for <B>C</B>arbon
+ <B>C</B>opy. If you wish to send someone else a copy of the message
+ here is where you would do that. Think of this in the same way a memo
+ is laid out. You can have as many people as you like in the <B>To:</B>,
+ <B>CC:</B>, and <B>BCC:</B> fields. Only the people to whom the message
+ has direct impact would be in the <B>To:</B> field while recipients to
+ whom this is possibly only informative would be in the <B>CC:</B> and
+ <B>BCC:</B> fields.
+ </p>
+ </description>
+</section>
+
+<section>
+ <title>
+ Bcc
+ </title>
+ <description>
+ <p>
+ BCC is an abbreviation for <B>B</B>lind <B>C</B>arbon <B>C</B>opy.
+ Use this to send someone a copy of the email <I>without</I> the
+ recipients in the <B>To:</B> or <B>CC:</B> fields knowing about it.
+ </p>
+ </description>
+</section>
+
+<section>
+ <title>
+ Subject
+ </title>
+ <description>
+ <p>
+ Type in a relevant heading here. Remember, email can be a great time
+ saver and an accurate subject line is one big reason.
+ </p>
+ </description>
+</section>
+
+<section>
+ <title>
+ Addresses Button
+ </title>
+ <description>
+ <p>
+ This button will open the address book after a search box is presented.
+ Something must be entered in the search box to retrieve a result.
+ If all addresses in the address book are required enter a space here
+ and click the submit button. The address book has enough functionality
+ that it deserves it's own section. More detailed information is
+ available in the "Addresses" chapter.
+ </p>
+ </description>
+</section>
+
+<section>
+ <title>
+ Message Body
+ </title>
+ <description>
+ <p>
+ The large empty box is for whatever you want to put there. If a
+ signature file has been saved it will appear here as well. This is
+ where you type the body of your message.
+ </p>
+ </description>
+</section>
+
+<section>
+ <title>
+ Attach
+ </title>
+ <description>
+ <p>
+ Located at the bottom of the Compose page, this feature allows you to
+ include a file with your email. The file must be located on your
+ <I>local</I> machine or network to be attached. A browse button is
+ present so you may search through your directory structure and click
+ on the file to include. Alternatively you may type directly into the
+ attach field if you know the full path and exact file name. Simply
+ press the Add button to list the selected file as an attachment and it
+ will appear below.
+ </p>
+ <p>
+ Once at least one file is presented for attachment another button is
+ revealed. Deletion of one or more attached files is accomplished by
+ selecting the offending file or files and pressing the delete selected
+ attachments button.
+ <p>
+ </description>
+</section>
--- /dev/null
+<chapter>
+ <title>
+ Folders
+ </title>
+ <summary>
+ You can store messages in different folders. This is
+ especially useful if you have a lot of email and want
+ to keep it organized. The folders option allows
+ manipulation of your folders.
+ </summary>
+</chapter>
+
+<section>
+ <title>
+ Subscribed Folders and the Left Frame
+ </title>
+ <description>
+ <p>
+ Currently subscribed folders are listed in the colored
+ area to the left. This frame may be set to automatically
+ refresh in the Options page. At the top of the left
+ frame is large and bolded heading. If changes have been
+ made to the subscribed folders using the folders menu
+ item, this list can be refreshed with the link below the
+ title. Oddly enough this link is titled "refresh folder
+ list".
+ </p><p>
+ The first folder listed contains received mail. To the
+ right of the first folder is a number in parenthesis
+ "( )" reflecting the count of <I>unread</I> emails.
+ This number is likely to vary from the total number
+ of emails displayed in the right frame. Under the main
+ folder are likely to be other folders or subfolders.
+ Colors for these folders will change with theme choices
+ made in the options page.
+ </p>
+ </description>
+</section>
+
+<section>
+ <title>
+ Delete
+ </title>
+ <description>
+ <p>
+ You may delete any folder displayed in the drop down list box to
+ the left of the Delete button. Notice that this list may <B>not</B>
+ include all the folders displayed. The special folders such as
+ your sent or your trash folder cannot be deleted, and of course,
+ you cannot delete INBOX.
+ </p>
+ </description>
+</section>
+
+
+<section>
+ <title>
+ Create
+ </title>
+ <description>
+ <p>
+ Folders may be created by simply typing the desired name into the
+ text box and pressing the Create button. If you wish that this folder
+ be a subfolder of another one, you can choose that in the drop-down
+ box with the list of folders.
+ </p>
+ <p>
+ On some mail servers, there are two types of folders.
+ One that contains messages, and one that
+ contains folders. You may see an option called "Let this folder contain
+ subfolders." If you do and you check that, the folder you create will
+ only be able to contain folders and not any messages. Otherwise, you
+ will only be able to store messages in it and not folders.
+ </p>
+ </description>
+</section>
+
+<section>
+ <title>
+ Rename
+ </title>
+ <description>
+ <p>
+ You may rename any folder displayed in the drop down list box to the
+ left of the Rename button. Notice that this list may <B>not</B>
+ include all the folders displayed in the left frame. For obvious
+ reasons, you cannot rename the sent, trash, or INBOX folders.
+ </p>
+ </description>
+</section>
+
+<section>
+ <title>
+ Unsubscribe and Subscribe
+ </title>
+ <description>
+ Definitions:<br>
+ <i>Subscribe</i>: To register a folder with the mail server, allowing
+ you to view it in the folder listings.<br>
+ <i>Unsubscribe</i>: The opposite of subscribing. This unregisters a
+ folder with the mail server.<br>
+ <br><p>
+ You may choose as many folders as you wish from either the subscribe
+ or the unsubscribe box, then click the button under the box to make
+ the action take effect. You will notice that the folders move to the
+ other box. You can then re-subscribe to them, or unsubscribe again
+ as you wish.
+ </p>
+ </description>
+</section>
--- /dev/null
+<chapter>
+ <title>
+ Message Index
+ </title>
+ <summary>
+ The name may sound complex, but this is just the list of email
+ messages that are in a particular folder.
+ </summary>
+</chapter>
+
+<section>
+ <title>
+ The Message Index
+ </title>
+ <description>
+ <p>
+ After you click on a folder, you will be taken (in the right frame) to the
+ message index. This lists messages in the selected folder. Below the
+ menu choice is a line which informs you which mails you are viewing
+ numerically and how many total you have.
+ </p><p>
+ For example: Viewing messages <B>20</B> to <B>30</B> (45 total).
+ </p><p>
+ Notice that the total message count might be different from the unread
+ mail count which is to the right of the main mail folder.
+ </p><p>
+ A bar containing three buttons is next. On the left side is a drop down
+ list box. This box lists your currently subscribed folders. Any selected
+ message will be moved to the selected folder when the move button is pushed.
+ Multiple messages may be moved at once. On the right side of this bar is
+ a button used to delete selected messages. Just select the junk mail and
+ press the button.
+ </p><p>
+ A bar three fields (From, Date, and Subject) is next. These Headings
+ separate the message table into logical parts. From tells you who sent
+ you the message. Or at least what email address it came from. Date
+ shows the day which the email was sent. Subject displays what the sender
+ entered as the subject. <b>Note:</b> Between the Date and Subject
+ columns is a small column that is unlabeled. There could be a "+", "!"
+ or an "A" in there. If you see the "+", that means that the message has
+ attachments, if you see the "A", that means that you have answered the
+ message, and if you see the "!", then the message was marked as urgent!
+ </p><p>
+ What remains is the actual message table. You will notice that unread
+ messages are <B>bold</B> while viewed messages are in normal text.
+ Four fields form this table. On the far left is a select box. When
+ selected the message on the same line is subject to the actions previously
+ discussed, (moving and deletion). Under the From header is listed whom
+ the message is from. Surprising, we know. But hey, you don't have to read
+ this. Next is listed the date, and finally the subject.
+ </p>
+ </description>
+</section>
--- /dev/null
+<chapter>
+ <title>
+ Options
+ </title>
+ <summary>
+ You can customize the way that SquirrelMail looks and responds to you
+ by setting different options in this section.
+ </summary>
+ <description>
+ <p>
+ One of the great things about SquirrelMail is the degree to which it may be customized.
+ Depending on the configuration, you may have several choices of themes, languages,
+ folders, and other preferences. All of these may be changed without affecting any other
+ users on the system. There are four main parts to the Options: Personal, Display,
+ Message Highlighting, and Folders.
+ </p>
+ </description>
+</chapter>
+
+<section>
+ <title>
+ Personal Information
+ </title>
+ <description>
+ <b>Full Name</b><br>
+ You should put your entire name here. For example, "John Doe". This is what is
+ shown to people that you send the message to. They will see that it is from
+ "John Doe". If you don't fill this in, they will see it is from your email address,
+ "jdoe@mydomain.org".
+ <br><br>
+
+ <b>E-Mail Address</b><br>
+ <i>Optional</i> - If your email address is different than what is automatically
+ assigned, you can change it here.
+ <br><br>
+
+ <b>Reply To</b><br>
+ <i>Optional</i> - This is the email address that people will reply to when they
+ reply to your message. If this is different than the email address you are sending
+ from, you can enter it here. This is useful if you want people to reply to your
+ Yahoo account rather than your office address.
+ <br><br>
+
+ <b>Signature</b><br>
+ <i>Optional</i> - Signatures are attached at the bottom of all messages you send
+ out. If you want a signature, you must make sure that the checkbox beside
+ "use a signature" is checked, and then fill in what you want your signature to be
+ in the box below it.
+ <br><br>
+ </description>
+</section>
+
+<section>
+ <title>
+ Display Preferences
+ </title>
+ <description>
+ <b>Theme</b><br>
+ SquirrelMail offers different color themes for your viewing pleasure. You can
+ choose between the many listed there if you so desire.
+ <br><br>
+
+ <b>Language</b><br>
+ If English isn't your native tongue, you can easily change the language that
+ most things display in. If your desired language is in the list, you can choose
+ it and all future SquirrelMail related messages will be in that language. Note
+ that this doesn't translate incoming email messages or folder names.
+ <br><br>
+
+ <b>Use Javascript address book?</b><br>
+ One of our main goals in creating SquirrelMail was to have no Javascript in
+ any of our pages. However, some of our developers made a very good address
+ book searching utility that uses Javascript. Rather than remove it, we now
+ give you the option of using the HTML address book or the Javascript one. If
+ you don't know what this means, you are safest to choose the HTML address book,
+ but most likely Javascript will work for you.
+ <br><br>
+
+ <b>Number of Messages to Index</b><br>
+ This is the number of messages to show at a time in a folder. If there are
+ more than this number in the folder, you will see a "Previous" and "Next" link
+ above and below the listing which will take you to the previous or next
+ messages.
+ <br><br>
+
+ <b>Wrap incoming text at</b><br>
+ How many characters should we allow before wrapping the text. This prevents
+ messages from scrolling way off the screen. 86 is usually a safe thing to
+ put in here, but you are free to change it to whatever you desire.
+ <br><br>
+
+ <b>Size of editor window</b><br>
+ How wide do you want your "Compose" box to be? This is the number of characters
+ per line that you will be able to type before wrapping in the Compose section.
+ <br><br>
+
+ <b>Width of left folder list</b><br>
+ On the left side of your browser window, you will see the list of folders. With
+ this option, you can select how wide that will be. If you have very long folder
+ names or large fonts, it is good to set this pretty high. Otherwise, you should
+ set it low so you don't waste screen space.
+ <br><br>
+
+ <b>Auto refresh folder list</b><br>
+ SquirrelMail has the functionality to automatically refresh the folder listing
+ on the left side of your browser window. This will also update the number of
+ unseen messages that are in each folder. This is a good way to check for unseen
+ messages in the INBOX without having to click on it every time.
+ <br><br>
+ </description>
+</section>
+
+<section>
+ <title>
+ Message Highlighting
+ </title>
+ <description>
+ The idea for this came because if you are subscribed to many mailing lists,
+ it is very hard to distinguish which messages came from where while reading
+ through the list of messages. With Message Highlighting, you can have the
+ background color of all messages from one mailing list different than the
+ color of another list.<br><br>
+
+ Just click on [New] to create a new one, or [Edit] to edit an existing one
+ and the options will appear below.<br><br>
+
+ <b>Identifying Name</b><br>
+ This is simply the name that you see which describes what it is. For
+ example, if you are highlighting messages from your mother, you might
+ set this to "From Mom".
+ <br><br>
+
+ <b>Color</b><br>
+ This is the actual color that the background will be. You can choose between
+ a number of pre-defined colors that we have selected for you, or you can enter
+ the HEX code for the color that you desire (i.e. a6b492). If you choose to
+ enter your own color, you must also select the radio button in front so that it is
+ checked.
+ <br><br>
+
+ <b>Match</b><br>
+ Here you can choose the matching phrase. From the drop-down box, you can
+ choose which header field to match against (to, from, subject...) and in the
+ text box, you can enter the phrase to match (mom@yahoo.com).
+ <br><br>
+ </description>
+</section>
+
+<section>
+ <title>
+ Folder Preferences
+ </title>
+ <description>
+ <b>Folder Path</b><br>
+ On some system this will not be displayed. If you don't see this option, just
+ ignore this. On other systems, this is quite a necessary feature. Usually the
+ option that is in there is what should be there. This is the folder in your
+ home directory that holds all your email folders. If you don't understand this,
+ just leave it what it is.
+ <br><br>
+
+ <b>Trash Folder</b><br>
+ You can choose which folder messages will be sent to when you delete them. If
+ you don't want deleted messages to go to the trash, set this to "Don't use Trash".
+ <br><br>
+
+ <b>Sent Folder</b><br>
+ You can choose which folder your sent messages will go to. If you don't want
+ these, just set it to "Don't use Sent".
+ <br><br>
+
+ <b>Unseen message notification</b><br>
+ This option specifies how to display unseen messages in the folder listing on the
+ right side of your browser window. If you set this to No Notification, you will
+ not be notified of unseen messages. If you set it to INBOX, when you have new
+ messages, the INBOX will become bold and a number will appear to the right of it
+ to say how many new messages are in it. If you set it to All Folders, this
+ behavior will happen on all folders. If you notice that loading the folder list
+ is really slow, you can set this to INBOX or None and that should speed it up.
+ <br><br>
+
+ <b>Unseen message notification type</b><br>
+ When new messages are in a folder, this option tells how to notify you of that.
+ <br><br>
+ </description>
+</section>
--- /dev/null
+<chapter>
+ <title>
+ Reading an email message
+ </title>
+ <summary>
+ The ability to read an email message is one of the most basic features
+ of any email client. However, SquirrelMail has quite a few features
+ for while you are reading messages. This explains what they all do.
+ </summary>
+ <description>
+ <p>
+ Click on the subject of a particular mail and that message is displayed.
+ One thing you will notice is that email and web addresses are live
+ links so you can click on them and send an email or open a page.
+ Another really nifty feature is that mail threads are color coded.
+ The standard for a reply is to quote the previous message with ">" before
+ every line. SquirrelMail sees this and color codes them. A replied
+ message will have a different color on the reply than the new text.
+ This works two layers deep. Another menu bar is now presented below the
+ main menu choices. This bar is in three sections. On the left side
+ you may delete or return to the summary. In the middle direct
+ navigation between messages is made possible. On the right, various
+ mailing functions are presented.
+ </p>
+ </description>
+</chapter>
+
+<section>
+ <title>
+ Message List
+ </title>
+ <description>
+ <p>
+ Click this link to return to the folder from which you came.
+ </p>
+ </description>
+</section>
+
+<section>
+ <title>
+ Delete
+ </title>
+ <description>
+ <p>
+ Click this link to delete the message being currently viewed.
+ All attachments of deleted mail are deleted as well. Prevent the
+ loss of attachments by Downloading them first (explained further in
+ this chapter).
+ </p>
+ </description>
+</section>
+
+<section>
+ <title>
+ Navigation
+ </title>
+ <description>
+ <p>
+ In the middle of the bar are navigation buttons. Previous will be
+ an active link if it can be utilized and plain text otherwise. Clicking
+ this link will display the previous message without the need to go back
+ to the summary display of messages.
+ </p>
+ </description>
+</section>
+
+<section>
+ <title>
+ Next
+ </title>
+ <description>
+ <p>
+ Click this link to advance to the mail immediately following the one
+ currently being viewed. Next will be an active link if it can be
+ utilized and plain text otherwise.
+ </p>
+ </description>
+</section>
+
+<section>
+ <title>
+ Forward
+ </title>
+ <description>
+ <p>
+ On the right, the forward link when pressed opens the Compose page
+ with the previously viewed email in the text box below a tag of
+ "--Original Message--". Fwd: is appended to the original subject
+ line and placed in the correct field. The various fields for sending
+ to an address await your completion. You may position the cursor in
+ the text box in order to add comments to the already existing text.
+ You may also use the attachment feature.
+ </p>
+ </description>
+</section>
+
+<section>
+ <title>
+ Reply
+ </title>
+ <description>
+ <p>
+ Click this link to return a new message to the originator of the
+ previously viewed message. Re: is appended to the original subject
+ line and placed in the subject field. Again, the text of the original
+ message is quoted in the text box. This time the ">" symbol is placed
+ in front of the original text. You may note that some of the original
+ text doesn't have the ">" symbol. This is due to line wrapping and
+ may be unavoidable. Try setting the value of <i>Wrap incoming text</i>
+ in the Options page to a larger number, this may help. Comments can be
+ made anywhere in the text box in addition to the quoted message. You
+ may also use the attachment feature.
+ </p>
+ </description>
+</section>
+
+<section>
+ <title>
+ Reply All
+ </title>
+ <description>
+ <p>
+ Same story here as "reply" with the exception that all addresses listed
+ in the header will receive the mail.
+ </p>
+ </description>
+</section>
+
+<section>
+ <title>
+ View all headers
+ </title>
+ <description>
+ <p>
+ This will display the entire header for the email message. This includes
+ the route that the message took to get here, and a lot more detailed
+ information about the message itself.
+ </p>
+ </description>
+</section>
+
+<section>
+ <title>
+ Download this as a file
+ </title>
+ <description>
+ <p>
+ At the bottom just above the bottom bar you will find this link.
+ Clicking this link allows you to save this email to your local hard drive
+ as a plain text message. A simple header will be attached to the top
+ of the message as well.
+ </p>
+ </description>
+</section>
+
+<section>
+ <title>
+ Attachments
+ </title>
+ <description>
+ <p>
+ Any attachments sent with a received email will be displayed at the
+ bottom of the message inside a colored box. The file is presented
+ as a link with a description of the file type to it's right. Clicking
+ on the file name will either display the attachment or present a
+ download dialog depending on the file type. If you wish to download
+ the file (rather than possibly viewing it), click on the "download"
+ link on the right side.
+ </p>
+ </description>
+</section>
--- /dev/null
+<chapter>
+ <title>
+ Search
+ </title>
+ <summary>
+ Searches through a folder for given criteria.
+ </summary>
+ <description>
+ <p>
+ With this useful tool, you can search through a specific folder for
+ given criteria that match against different header fields.
+ </p>
+ </description>
+</chapter>
+
+<section>
+ <title>
+ General Overview
+ </title>
+ <description>
+ <p>
+ You simply choose the folder you wish to search, type in the search
+ criteria, and then choose the part of the message to search. When
+ you submit your data, the list of messages will come up below the
+ search form. You can choose the message you wish to view, and read
+ it just like a normal message.
+ </p>
+ <p>
+ Notice that when you are reading messages and then go into the search
+ section, your currently active folder will be the default to search
+ through. For example, if you were browsing through your "Friends"
+ folder and then click on "Search", "Friends" will already be selected
+ for searching.
+ </p>
+ </description>
+</section>
+
+<section>
+ <title>
+ What to search through
+ </title>
+ <description>
+ <p>
+ To the left of the input field, you see a drop-down list of places
+ that are possible to search through. This includes: Body, Everywhere,
+ Subject, From, Cc, To.
+ </p>
+ <p>
+ <b>Body</b> - Searches through the body of the message. This is the
+ main part of the message where the important stuff is located.
+ </p>
+ <p>
+ <b>Everywhere</b> - This searches everything, including the entire
+ header for the message. Unless you are sure this is what you want,
+ it probably isn't. It can return results that you wouldn't normally
+ expect.
+ </p>
+ <p>
+ <b>Subject</b> - Searches through the subjects for all the messages.
+ </p>
+ <p>
+ <b>From</b> - Who the message is from. Note that this might be more
+ than is actually displayed in the folder list. A normal "From" field
+ includes the name AND email address, but SquirrelMail usually only
+ displays the name. If your criteria matches the email address, but
+ it is not displayed, that message will still return as having matched.
+ </p>
+ <p>
+ <b>To</b> - Who the message was sent to. This can be many addresses,
+ and is not always just one email address.
+ </p>
+ <p>
+ <b>Cc</b> - Same as "To", except who the message was carbon copied to.
+ </p>
+ </description>
+</section>