moving functions to separate file, adding configuration files
[squirrelmail.git] / help / en_US / search.hlp
1 <chapter>
2 <title>
3 Search
4 </title>
5 <summary>
6 Searches through a folder for given criteria.
7 </summary>
8 <description>
9 <p>
10 With this useful tool, you can search through a specific folder for
11 given criteria that match against different header fields.
12 </p>
13 </description>
14 </chapter>
16 <section>
17 <title>
18 General Overview
19 </title>
20 <description>
21 <p>
22 You simply choose the folder you wish to search, type in the search
23 criteria, and then choose the part of the message to search. When
24 you submit your data, the list of messages will come up below the
25 search form. You can choose the message you wish to view, and read
26 it just like a normal message.
27 </p>
28 <p>
29 Notice that when you are reading messages and then go into the search
30 section, your currently active folder will be the default to search
31 through. For example, if you were browsing through your "Friends"
32 folder and then click on "Search", "Friends" will already be selected
33 for searching.
34 </p>
35 </description>
36 </section>
38 <section>
39 <title>
40 What to search through
41 </title>
42 <description>
43 <p>
44 To the left of the input field, you see a drop-down list of places
45 that are possible to search through. This includes: Body, Everywhere,
46 Subject, From, Cc, To.
47 </p>
48 <p>
49 <b>Body</b> - Searches through the body of the message. This is the
50 main part of the message where the important stuff is located.
51 </p>
52 <p>
53 <b>Everywhere</b> - This searches everything, including the entire
54 header for the message. Unless you are sure this is what you want,
55 it probably isn't. It can return results that you wouldn't normally
56 expect.
57 </p>
58 <p>
59 <b>Subject</b> - Searches through the subjects for all the messages.
60 </p>
61 <p>
62 <b>From</b> - Who the message is from. Note that this might be more
63 than is actually displayed in the folder list. A normal "From" field
64 includes the name AND email address, but SquirrelMail usually only
65 displays the name. If your criteria matches the email address, but
66 it is not displayed, that message will still return as having matched.
67 </p>
68 <p>
69 <b>To</b> - Who the message was sent to. This can be many addresses,
70 and is not always just one email address.
71 </p>
72 <p>
73 <b>Cc</b> - Same as "To", except who the message was carbon copied to.
74 </p>
75 </description>
76 </section>
78 <section>
79 <title>
80 Recent Searches
81 </title>
82 <description>
83 If you've enabled this option, the Search page also displays an overview of
84 up to 9 of your most recent searches for quick access. Click on Search
85 next to the listed search to perform it again. With the Save link
86 you can move a search to the Saved Searches which will be kept until you
87 explicitly press Delete. Click Forget to remove a search from the list of
88 recent searches.
89 </description>
90 </section>