/usr/share/doc/exmh/html/Search.html is in exmh 1:2.8.0-7.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 | <Html>
<Head>
<Title>Search Help</Title>
<!-- Author: bwelch -->
</Head>
<Body>
<h1 align=center>Searching in exmh</h1>
<p>
There are several ways to search for things in exmh:
<h2>In the current message. </h2>
<p>
Search for a string in the current message body. Searching uses regular
expression syntax, and case is ignored. Note that this only looks in
the currently displayed message. (Use the "Search" field in Pick to
search through all messages in a folder. )
<h2>In the scan listing</h2>
<p>
Search for a string in the table of contents. Searching uses regular
expression syntax, and case is ignored. This just searches over what
you can see in the display. If you select All, then all matching messages
are selected.
<h2>In the current folder</h2>
The MH pick program is used to search within a folder. This can run
slowly because each message in the folder must be processed.
<p>
The pick dialog displays some command buttons, two fields, and a menu
that says "Choose pick option".
<p>
Ignore the fields labeled "Add to Sequence" and "Pick from Seq/msg"
unless you are already familiar with pick.
<p>
Choose your selection criteria with the menu, which offers:
<ul>
<li>subject
<li>from
<li>to
<li>cc
<li>before - select messages received before this date or time.
<li>after - select messages received after this date or time.
<li>search - search the contents of all messages for a string.
<li>component - enter a mail header name, like X-URL, and a value to
search for in that header.
</ul>
<br>
If you choose more than one option, the messages must match all of
them, unless you use the Not and Or buttons to build up more complex
criteria.
<br>
<br>
The "Add to Sequence(s)" option will add the matching messages to
an MH sequence. Just pick a meaningful name for the sequence.
<p>
The "Pick from Seq/msg(s)" lets you narrow the search to a sequence
(e.g., "unseen" or something you defined yourself) or a set of messages
(e.g., last:100 for the last 100 messages in the folder).
<br>
<br>
The "Add to Sel" option determines if the matching messages are added
to the currently selected set, or if a new set is created.
<h2>In all folders</h2>
<p>
A full text search over all folders uses the <strong>Glimpse</strong>
facility.
<p>
First you must create an index, which costs about %10 to %15 space
overhead based on the size of your message storage. You can index the
current folder or all folders. The indexing runs in the background
but it may take some time.
<p>
The search can be over all folders, the current folder, or the current
folder and all of its nested folders. A search over multiple folders
can be stopped, although the Stop happens at the end of a folder.
<p>
The search tolerates spelling errors, and you can control this with
the Opts... menu.
<p>
The results of the search are displayed, and you can click on the message
IDs and exmh will visit that message.
<h3>Maintaining your Glimpse Indexes. </h3>
<p>
The exmh interface does not automatically maintain your Glimpse Indexes.
The typical scenario is that you periodically index your mail, either
by choosing Index as you leave for the day, or with a nightly "cron
job". Your job can send a Tcl command to Exmh and have it do all the
hard work. You may have trouble connecting to exmh, but you can try
something like:
<p>
<br>
In your crontab, for 1:30 AM
<pre>30 1 * * * /tilde/welch/scripts/glimpseindex -display unix:0</pre>
<p>
<br>
In the script, using a hack to allow /bin/sh to run the script:
<p>
<br>
#!/import/tcl/bin/wish4.0.g
<br>
# The next line is a comment in Tcl, but not to /bin/sh \
<br>
exec /import/tcl/bin/wish4.0.g -f "$0" ${1+"$@"}
<br>
<br>
message .msg -text "Starting Glimpse Index"
<br>
pack .msg
<br>
if [catch {send exmh Glimpse_Index} err] {
<br>
catch {exec cat > /dev/console << $err}
<br>
}
<br>
exit
<p>
<br>
If you want to write your own script, use something like this:
<p>
<br>
#!/bin/csh -f
<br>
cat /dev/null > ~/Mail/glimpseindex.log
<br>
foreach f (`cat ~/Mail/.folders`)
<br>
glimpseindex -H /tilde/welch/Mail/.glimpse/$f ~/Mail/$f | \
<br>
egrep '(Indexing|Size)' >> ~/Mail/glimpseindex.log
<br>
end
<h2><a HREF="index.html">Main Help Index</a></h2>
</Body>
</Html>
|