Replace PHP4 -> PHP since we also support upcoming PHP versions
[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>