/usr/share/doc/exmh/html/AddrEdit.html is in exmh 1:2.8.0-4.
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 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 | <Html>
<Head>
<Title>Address DB Browser and Editor Help</Title>
<!-- Author: bwelch -->
</Head>
<Body>
<h1 align=center>Address DB Browser Help</h1>
<p>
The Address DB Browser window is accessed from the Addresses.../Address
Book menu item in the exmh main window. This window allows you to view
the contents of the Address Database and operate on the contents of
the database.
<p>
The Browser window shows a formatted and sorted list of mail addresses
as in the example below. The full name and email address are shown.
In addition the presence of a "-" preceding the email address indicates
that the record is marked for exclusion from searches.
<pre>
Brent B. Welch <welch@acm.org>
Brent B. Welch - <brent.welch@scriptics.com>
</pre>
<p>
At the bottom of the Address DB Browser window is an entry field
labeled <b>Find</b>. Text entered in the Find field will applied as
a case-insensitive regular expression filter to the records in the
Address Database and only matching records will be displayed.
<p>After using <b>Find</b>, to return to viewing all records it is
necessary to delete any text entered in the Find field and press enter.
<br>
<br>
<h3>Address DB Browser Buttons</h3>
<p>
The following buttons are available in the Address DB Browser window:
<dl>
<br>
<dt>Help
<dd>Shows this help.
<br>
<br>
<dt>New <dd>Pops up a window that allows you to manually introduce a new
address in the addresses database.
<p>The following fields exist in this window:
<p>
<dl>
<dt>Full Name
<dd>The "text name" of the person associated with this
email address and it may be blank.
<br>
<br>
<dt>Address
<dd>This is the email address of the person. Don't add the angle brackets
to it ("<>") as they will be added when needed.
</dl>
<br>
<br>
<dt><a href="#dbmenu">Database...</a>
<dd>Pops up the
<a href="#dbmenu">Database... menu</a>,
a group of operations on the entire database.
<br>
<br>
<dt><a href="#selmenu">Selected...</a>
<dd>Pops up the
<a href="#selmenu">Selected Records menu</a>.
Items available in this menu operate on the currently selected record
or records in the database.
<br>
<br>
<p>
This menu is disabled when no records are
selected. Selection of records is accomplished by clicking or
dragging using mouse button 1 and may also be done using the keyboard
arrow keys and spacebar.
<br>
<br>
<dt>Dismiss
<dd>Closes the Address Database Browser window
</dl>
<br>
<br>
<h4><a name=dbmenu>Database... menu</a></h4>
<br>
<dl>
<dt>Save <Meta-s>
<dd>
<p>
Pressing the <b>Save</b> button or the <Meta-s> key unconditionally
writes the current contents of the complete Address Database to disk.
Note that the Address Database will also be saved when exmh exits
normally and <i>may</i> optionally be saved each time you change the
current folder if the database has changed <b>and</b> if "Checkpoint
on folder change" is set to "on" in the Address Database Preference
panel.
<br>
<br>
<dt>Reload <Meta-r>
<dd>
<p>
Pressing the <b>Reload</b> button or the <Meta-r> key causes the
current contents of the complete address database to be discarded and
the last saved file to be reread. If the database has changed you
will be prompted to confirm the reload to prevent inadvertent loss of
changes.
<br>
<br>
<dt>Sort <Meta-t>
<dd>
<p>
Pressing the <b>Sort</b> button or the <Meta-t> key causes the
contents of the address browser list to be resorted. This may
occasionally be desirable since new database entries are added to the
end of the browser list for performance reasons.
<br>
<br>
</dl>
<br>
<br>
<h4><a name=selmenu>Selected Records menu</a></h4>
<p>
Items in the <b>Selected...</b> menu operate on the currently
selected record or records and are only available when records have
been selected in the Address Browser listbox.
<br>
<br>
<dl>
<dt>Edit
<dd>
<p>
Pressing the <b>Edit</b> button will open an <a href="#dbedit">Address
DB Editor</a> window for each selected record. A single record can be
quickly edited by double-clicking mouse button 1 on a record in the
Address DB Browser.
<br>
<br>
<dt>Delete <Control-w>
<dd>
<p>
Pressing the <b>Delete</b> button or the <Control-w> key removes all
the selected record from the database. No confirmation will be
requested but the change is not committed to disk until the Address DB
is saved.
<br>
<br>
<dt>Toggle Excluded <Meta-x>
<dd>
<p>
Pressing the <b>Toggle Excluded</b> button or the <Meta-x> key will
invert the "excluded" flag for all selected records. This can also be
done by clicking mouse button 2 in the list box with records selected.
No confirmation will be requested but the change is not committed to
disk until the Address DB is saved.
<br>
<br>
<dt>View Last Msg
<dd>
<p>
Pressing the <b>View Last Msg</b> button will cause a new window to be
opened for each selected address. The windows will contain the last
message received from the selected address(es). Note that this may
give incorrect results if the selected message was moved, the folder
was packed, or the message was deleted. The Address Database field
containing the last message information is only updated when an
address is saved.
<br>
<br>
</dl>
<p>
<br>
<br>
<br>
<h1 align=center><a name=dbedit>Address DB Editor Help</a></h1>
<p>
The <b>Address DB Editor</b> is used to change the contents or exclusion
status of a single record in the Address Database.
<h3>Address DB Editor Fields</h3>
<p>
The following fields are available and may be altered. No checking
of contents is done so preserving valid data is strictly up to you.
<dl>
<dt>Full Name
<dd>The "text name" of the person associated with this email address.
This may be blank. It is not necessary to provide quotation marks around
addresses containing commas or other restricted characters as the Address
Database will automatically provide them when needed.
<br>
<br>
<dt>Address
<dd>This will display the fully formatted address containing the full
name (quoted if necessary) and the email address. The email address
will be enclosed in angle brackets ("<>") if there is a full
name.
<br>
<br>
<p>
<b>If you alter this field you should <i>only</i> enter a valid email
address.</b>
<br>
<br>
<dt><a name=lastmsgfield>Last Message</a>
<dd>This field will contain the fully qualified filename of the last
message received from this address. It will only be correct if you
have not packed the folder, moved the message, or deleted the message.
This field is used when you press the <b>Last Msg</b> button in the
Address DB Browser.
<br>
<br>
<dt>Date
<dd>This field will contain the contents of the Date: header from the
message pointed to by the <a href="#lastmsgfield">Last Message</a> field
above. When displaying messages in exmh this field is used to determine
if the <a href="#lastmsgfield">Last Message</a> field should be updated.
</dl>
<h3>Address DB Editor buttons</h3>
<dl>
<br>
<br>
<dt>Exclude / Include
<dd>If the record being edited is marked for exclusion from searches
then the <b>Include</b> button will be available to unmark it. If it
is not currently marked for exclusion the <b>Exclude</b> button will
be available to so mark it.
<br>
<br>
<dt>ViewLastMsg
<dd>Pressing the <b>ViewLastMsg</b> button will open a window containing
the last message (as listed in the <a href=lastmsgfield>Last Message</a>
field).
<br>
<br>
<dt>Delete
<dd>Pressing the <b>Delete</b> button will remove the current record
from the Address Database and close the Address DB Editor window. <dt>Save
<dd>Pressing the <b>Save</b> button will save changes from the window
to the in-memory Address Database. This does not commit the changes
to disk.
<br>
<br>
<dt>Dismiss
<dd>Pressing the <b>Save</b> button will close the Address DB Editor
window, discarding any changes made in the window.
</dl>
<br>
<br>
<br>
<h2><a HREF="AddressBk.html">Address Database Help</a></h2>
<h2><a HREF="index.html">Main Help Index</a></h2>
</Body>
</Html>
|