really remove doc/
[apps/madmutt.git] / doc / manual.xml.tail
1 <!-- vim:ft=xml
2 -->
3       
4     </sect1>
5     
6     <sect1 id="functions">
7       <title>Functions</title>
8       
9       <para>
10         The following is the list of available functions listed by the mapping
11         in which they are available.  The default key setting is given, and an
12         explanation of what the function does.  The key bindings of these
13         functions can be changed with the <link linkend="bind">bind</link>
14         command.
15       </para>
16       
17       <sect2 id="functions-generic">
18         <title>generic</title>
19         
20         <para>
21           The <emphasis>generic</emphasis> menu is not a real menu, but
22           specifies common functions
23           (such as movement) available in all menus except for <emphasis>pager</emphasis> and
24           <emphasis>editor</emphasis>.  Changing settings for this menu will
25           affect the default
26           bindings for all menus (except as noted).
27         </para>
28         
29         <para>
30           
31         <table frame="none" rowsep="1" texstr="l|l|l">
32           <title>Reference: Default Generic Function Bindings</title>
33           <tgroup cols="3" align="left" colsep="1" rowsep="1">
34           <thead>
35             <row>
36               <entry>Function</entry>
37               <entry>Default Key</entry>
38               <entry>Description</entry>
39             </row>
40           </thead>
41           <tbody>
42             <row>
43               <entry><madmutt-doc:funcref name="bottom-page"/></entry>
44               <entry><madmutt-doc:key>L</madmutt-doc:key></entry>
45               <entry>move to the bottom of the page</entry>
46             </row>
47             <row>
48               <entry><madmutt-doc:funcref name="current-bottom"/></entry>
49               <entry></entry>
50               <entry>move current entry to bottom of page</entry>
51             </row>
52             <row>
53               <entry><madmutt-doc:funcref name="current-middle"/></entry>
54               <entry></entry>
55               <entry>move current entry to middle of page</entry>
56             </row>
57             <row>
58               <entry><madmutt-doc:funcref name="current-top"/></entry>
59               <entry></entry>
60               <entry>move current entry to top of page</entry>
61             </row>
62             <row>
63               <entry><madmutt-doc:funcref name="enter-command"/></entry>
64               <entry><madmutt-doc:key>:</madmutt-doc:key></entry>
65               <entry>enter a madmuttrc command</entry>
66             </row>
67             <row>
68               <entry><madmutt-doc:funcref name="exit"/></entry>
69               <entry><madmutt-doc:key>q</madmutt-doc:key></entry>
70               <entry>exit this menu</entry>
71             </row>
72             <row>
73               <entry><madmutt-doc:funcref name="first-entry"/></entry>
74               <entry><madmutt-doc:key>=</madmutt-doc:key></entry>
75               <entry>move to the first entry</entry>
76             </row>
77             <row>
78               <entry><madmutt-doc:funcref name="half-down"/></entry>
79               <entry><madmutt-doc:key>]</madmutt-doc:key></entry>
80               <entry>scroll down 1/2 page</entry>
81             </row>
82             <row>
83               <entry><madmutt-doc:funcref name="half-up"/></entry>
84               <entry><madmutt-doc:key>[</madmutt-doc:key></entry>
85               <entry>scroll up 1/2 page</entry>
86             </row>
87             <row>
88               <entry><madmutt-doc:funcref name="help"/></entry>
89               <entry><madmutt-doc:key>?</madmutt-doc:key></entry>
90               <entry>this screen</entry>
91             </row>
92             <row>
93               <entry><madmutt-doc:funcref name="jump"/></entry>
94               <entry><madmutt-doc:key>number</madmutt-doc:key></entry>
95               <entry>jump to an index number</entry>
96             </row>
97             <row>
98               <entry><madmutt-doc:funcref name="last-entry"/></entry>
99               <entry><madmutt-doc:key>*</madmutt-doc:key></entry>
100               <entry>move to the last entry</entry>
101             </row>
102             <row>
103               <entry><madmutt-doc:funcref name="middle-page"/></entry>
104               <entry><madmutt-doc:key>M</madmutt-doc:key></entry>
105               <entry>move to the middle of the page</entry>
106             </row>
107             <row>
108               <entry><madmutt-doc:funcref name="next-entry"/></entry>
109               <entry><madmutt-doc:key>j</madmutt-doc:key></entry>
110               <entry>move to the next entry</entry>
111             </row>
112             <row>
113               <entry><madmutt-doc:funcref name="next-line"/></entry>
114               <entry><madmutt-doc:key>></madmutt-doc:key></entry>
115               <entry>scroll down one line</entry>
116             </row>
117             <row>
118               <entry><madmutt-doc:funcref name="next-page"/></entry>
119               <entry><madmutt-doc:key>z</madmutt-doc:key></entry>
120               <entry>move to the next page</entry>
121             </row>
122             <row>
123               <entry><madmutt-doc:funcref name="previous-entry"/></entry>
124               <entry><madmutt-doc:key>k</madmutt-doc:key></entry>
125               <entry>move to the previous entry</entry>
126             </row>
127             <row>
128               <entry><madmutt-doc:funcref name="previous-line"/></entry>
129               <entry><madmutt-doc:key>></madmutt-doc:key></entry>
130               <entry>scroll up one line</entry>
131             </row>
132             <row>
133               <entry><madmutt-doc:funcref name="previous-page"/></entry>
134               <entry><madmutt-doc:key>Z</madmutt-doc:key></entry>
135               <entry>move to the previous page</entry>
136             </row>
137             <row>
138               <entry><madmutt-doc:funcref name="rebuild-cache"/></entry>
139               <entry></entry>
140               <entry>cycle through all defined mailboxes to rebuild all header caches</entry>
141             </row>
142             <row>
143               <entry><madmutt-doc:funcref name="refresh"/></entry>
144               <entry><madmutt-doc:key mod="C">L</madmutt-doc:key></entry>
145               <entry>clear and redraw the screen</entry>
146             </row>
147             <row>
148               <entry><madmutt-doc:funcref name="search"/></entry>
149               <entry><madmutt-doc:key>/</madmutt-doc:key></entry>
150               <entry>search for a regular expression</entry>
151             </row>
152             <row>
153               <entry><madmutt-doc:funcref name="search-next"/></entry>
154               <entry><madmutt-doc:key>n</madmutt-doc:key></entry>
155               <entry>search for next match</entry>
156             </row>
157             <row>
158               <entry><madmutt-doc:funcref name="search-opposite"/></entry>
159               <entry></entry>
160               <entry>search for next match in opposite direction</entry>
161             </row>
162             <row>
163               <entry><madmutt-doc:funcref name="search-reverse"/></entry>
164               <entry><madmutt-doc:key mod="E">/</madmutt-doc:key></entry>
165               <entry>search backwards for a regular expression</entry>
166             </row>
167             <row>
168               <entry><madmutt-doc:funcref name="select-entry"/></entry>
169               <entry><madmutt-doc:key>Return</madmutt-doc:key></entry>
170               <entry>select the current entry</entry>
171             </row>
172             <row>
173               <entry><madmutt-doc:funcref name="shell-escape"/></entry>
174               <entry><madmutt-doc:key>!</madmutt-doc:key></entry>
175               <entry>run a program in a subshell</entry>
176             </row>
177             <row>
178               <entry><madmutt-doc:funcref name="tag-entry"/></entry>
179               <entry><madmutt-doc:key>t</madmutt-doc:key></entry>
180               <entry>toggle the tag on the current entry</entry>
181             </row>
182             <row>
183               <entry><madmutt-doc:funcref name="tag-prefix"/></entry>
184               <entry><madmutt-doc:key>;</madmutt-doc:key></entry>
185               <entry>apply next command to tagged entries</entry>
186             </row>
187             <row>
188               <entry><madmutt-doc:funcref name="tag-prefix-cond"/></entry>
189               <entry></entry>
190               <entry>apply next function ONLY to tagged messages</entry>
191             </row>
192             <row>
193               <entry><madmutt-doc:funcref name="top-page"/></entry>
194               <entry><madmutt-doc:key>H</madmutt-doc:key></entry>
195               <entry>move to the top of the page</entry>
196             </row>
197             <row>
198               <entry><madmutt-doc:funcref name="what-key"/></entry>
199               <entry></entry>
200               <entry>display the keycode for a key press</entry>
201             </row>
202                   </tbody>
203       </tgroup>
204     </table>
205
206           
207         </para>
208         
209       </sect2>
210       
211       <sect2 id="functions-index">
212         <title>index</title>
213         
214         <para>
215           
216         <table frame="none" rowsep="1" texstr="l|l|l">
217           <title>Reference: Default Index Function Bindings</title>
218           <tgroup cols="3" align="left" colsep="1" rowsep="1">
219           <thead>
220             <row>
221               <entry>Function</entry>
222               <entry>Default Key</entry>
223               <entry>Description</entry>
224             </row>
225           </thead>
226           <tbody>
227             <row>
228               <entry><madmutt-doc:funcref name="bounce-message"/></entry>
229               <entry><madmutt-doc:key>b</madmutt-doc:key></entry>
230               <entry>remail a message to another user</entry>
231             </row>
232             <row>
233               <entry><madmutt-doc:funcref name="change-folder"/></entry>
234               <entry><madmutt-doc:key>c</madmutt-doc:key></entry>
235               <entry>open a different folder</entry>
236             </row>
237             <row>
238               <entry><madmutt-doc:funcref name="change-folder-readonly"/></entry>
239               <entry><madmutt-doc:key mod="E">c</madmutt-doc:key></entry>
240               <entry>open a different folder in read only mode</entry>
241             </row>
242             <row>
243               <entry><madmutt-doc:funcref name="check-traditional-pgp"/></entry>
244               <entry><madmutt-doc:key mod="E">P</madmutt-doc:key></entry>
245               <entry>check for classic pgp</entry>
246             </row>
247             <row>
248               <entry><madmutt-doc:funcref name="clear-flag"/></entry>
249               <entry><madmutt-doc:key>W</madmutt-doc:key></entry>
250               <entry>clear a status flag from a message</entry>
251             </row>
252             <row>
253               <entry><madmutt-doc:funcref name="copy-message"/></entry>
254               <entry><madmutt-doc:key>C</madmutt-doc:key></entry>
255               <entry>copy a message to a file/mailbox</entry>
256             </row>
257             <row>
258               <entry><madmutt-doc:funcref name="create-alias"/></entry>
259               <entry><madmutt-doc:key>a</madmutt-doc:key></entry>
260               <entry>create an alias from a message sender</entry>
261             </row>
262             <row>
263               <entry><madmutt-doc:funcref name="decode-copy"/></entry>
264               <entry><madmutt-doc:key mod="E">C</madmutt-doc:key></entry>
265               <entry>decode a message and copy it to a file/mailbox</entry>
266             </row>
267             <row>
268               <entry><madmutt-doc:funcref name="decode-save"/></entry>
269               <entry><madmutt-doc:key mod="E">s</madmutt-doc:key></entry>
270               <entry>decode a message and save it to a file/mailbox</entry>
271             </row>
272             <row>
273               <entry><madmutt-doc:funcref name="delete-message"/></entry>
274               <entry><madmutt-doc:key>d</madmutt-doc:key></entry>
275               <entry>delete the current entry</entry>
276             </row>
277             <row>
278               <entry><madmutt-doc:funcref name="delete-pattern"/></entry>
279               <entry><madmutt-doc:key>D</madmutt-doc:key></entry>
280               <entry>delete messages matching a pattern</entry>
281             </row>
282             <row>
283               <entry><madmutt-doc:funcref name="delete-subthread"/></entry>
284               <entry><madmutt-doc:key mod="E">d</madmutt-doc:key></entry>
285               <entry>delete all messages in subthread</entry>
286             </row>
287             <row>
288               <entry><madmutt-doc:funcref name="delete-thread"/></entry>
289               <entry><madmutt-doc:key mod="C">D</madmutt-doc:key></entry>
290               <entry>delete all messages in thread</entry>
291             </row>
292             <row>
293               <entry><madmutt-doc:funcref name="display-address"/></entry>
294               <entry><madmutt-doc:key>@</madmutt-doc:key></entry>
295               <entry>display full address of sender</entry>
296             </row>
297             <row>
298               <entry><madmutt-doc:funcref name="display-toggle-weed"/></entry>
299               <entry><madmutt-doc:key>h</madmutt-doc:key></entry>
300               <entry>display message and toggle header weeding</entry>
301             </row>
302             <row>
303               <entry><madmutt-doc:funcref name="display-message"/></entry>
304               <entry><madmutt-doc:key>Return</madmutt-doc:key></entry>
305               <entry>display a message</entry>
306             </row>
307             <row>
308               <entry><madmutt-doc:funcref name="edit"/></entry>
309               <entry><madmutt-doc:key>e</madmutt-doc:key></entry>
310               <entry>edit the current message</entry>
311             </row>
312             <row>
313               <entry><madmutt-doc:funcref name="edit-type"/></entry>
314               <entry><madmutt-doc:key mod="C">E</madmutt-doc:key></entry>
315               <entry>edit the current message's Content-Type</entry>
316             </row>
317             <row>
318               <entry><madmutt-doc:funcref name="exit"/></entry>
319               <entry><madmutt-doc:key>x</madmutt-doc:key></entry>
320               <entry>exit without saving changes</entry>
321             </row>
322             <row>
323               <entry><madmutt-doc:funcref name="extract-keys"/></entry>
324               <entry><madmutt-doc:key mod="C">K</madmutt-doc:key></entry>
325               <entry>extract PGP public keys</entry>
326             </row>
327             <row>
328               <entry><madmutt-doc:funcref name="fetch-mail"/></entry>
329               <entry><madmutt-doc:key>G</madmutt-doc:key></entry>
330               <entry>retrieve mail from POP server</entry>
331             </row>
332             <row>
333               <entry><madmutt-doc:funcref name="flag-message"/></entry>
334               <entry><madmutt-doc:key>F</madmutt-doc:key></entry>
335               <entry>toggle a message's 'important' flag</entry>
336             </row>
337             <row>
338               <entry><madmutt-doc:funcref name="forget-passphrase"/></entry>
339               <entry><madmutt-doc:key mod="C">F</madmutt-doc:key></entry>
340               <entry>wipe PGP passphrase from memory</entry>
341             </row>
342             <row>
343               <entry><madmutt-doc:funcref name="forward-message"/></entry>
344               <entry><madmutt-doc:key>f</madmutt-doc:key></entry>
345               <entry>forward a message with comments</entry>
346             </row>
347             <row>
348               <entry><madmutt-doc:funcref name="group-reply"/></entry>
349               <entry><madmutt-doc:key>g</madmutt-doc:key></entry>
350               <entry>reply to all recipients</entry>
351             </row>
352             <row>
353               <entry><madmutt-doc:funcref name="limit"/></entry>
354               <entry><madmutt-doc:key>l</madmutt-doc:key></entry>
355               <entry>show only messages matching a pattern</entry>
356             </row>
357             <row>
358               <entry><madmutt-doc:funcref name="list-reply"/></entry>
359               <entry><madmutt-doc:key>L</madmutt-doc:key></entry>
360               <entry>reply to specified mailing list</entry>
361             </row>
362             <row>
363               <entry><madmutt-doc:funcref name="mail"/></entry>
364               <entry><madmutt-doc:key>m</madmutt-doc:key></entry>
365               <entry>compose a new mail message</entry>
366             </row>
367             <row>
368               <entry><madmutt-doc:funcref name="mail-key"/></entry>
369               <entry><madmutt-doc:key mod="E">k</madmutt-doc:key></entry>
370               <entry>mail a PGP public key</entry>
371             </row>
372             <row>
373               <entry><madmutt-doc:funcref name="next-new"/></entry>
374               <entry></entry>
375               <entry>jump to the next new message</entry>
376             </row>
377             <row>
378               <entry><madmutt-doc:funcref name="next-new-then-unread"/></entry>
379               <entry><madmutt-doc:key>Tab</madmutt-doc:key></entry>
380               <entry>jump to the next new or unread message</entry>
381             </row>
382             <row>
383               <entry><madmutt-doc:funcref name="next-subthread"/></entry>
384               <entry><madmutt-doc:key mod="E">n</madmutt-doc:key></entry>
385               <entry>jump to the next subthread</entry>
386             </row>
387             <row>
388               <entry><madmutt-doc:funcref name="next-thread"/></entry>
389               <entry><madmutt-doc:key mod="C">N</madmutt-doc:key></entry>
390               <entry>jump to the next thread</entry>
391             </row>
392             <row>
393               <entry><madmutt-doc:funcref name="next-undeleted"/></entry>
394               <entry><madmutt-doc:key>j</madmutt-doc:key></entry>
395               <entry>move to the next undeleted message</entry>
396             </row>
397             <row>
398               <entry><madmutt-doc:funcref name="next-unread"/></entry>
399               <entry></entry>
400               <entry>jump to the next unread message</entry>
401             </row>
402             <row>
403               <entry><madmutt-doc:funcref name="parent-message"/></entry>
404               <entry><madmutt-doc:key>P</madmutt-doc:key></entry>
405               <entry>jump to parent message in thread </entry>
406             </row>
407             <row>
408               <entry><madmutt-doc:funcref name="pipe-message"/></entry>
409               <entry><madmutt-doc:key>|</madmutt-doc:key></entry>
410               <entry>pipe message/attachment to a shell command</entry>
411             </row>
412             <row>
413               <entry><madmutt-doc:funcref name="previous-new"/></entry>
414               <entry></entry>
415               <entry>jump to the previous new message</entry>
416             </row>
417             <row>
418               <entry><madmutt-doc:funcref name="previous-new-then-unread"/></entry>
419               <entry><madmutt-doc:key mod="E">Tab</madmutt-doc:key></entry>
420               <entry>jump to the previous new or unread message</entry>
421             </row>
422             <row>
423               <entry><madmutt-doc:funcref name="previous-page"/></entry>
424               <entry><madmutt-doc:key>Z</madmutt-doc:key></entry>
425               <entry>move to the previous page</entry>
426             </row>
427             <row>
428               <entry><madmutt-doc:funcref name="previous-subthread"/></entry>
429               <entry><madmutt-doc:key mod="E">p</madmutt-doc:key></entry>
430               <entry>jump to previous subthread</entry>
431             </row>
432             <row>
433               <entry><madmutt-doc:funcref name="previous-thread"/></entry>
434               <entry><madmutt-doc:key mod="C">P</madmutt-doc:key></entry>
435               <entry>jump to previous thread</entry>
436             </row>
437             <row>
438               <entry><madmutt-doc:funcref name="previous-undeleted"/></entry>
439               <entry><madmutt-doc:key>k</madmutt-doc:key></entry>
440               <entry>move to the last undelete message</entry>
441             </row>
442             <row>
443               <entry><madmutt-doc:funcref name="previous-unread"/></entry>
444               <entry></entry>
445               <entry>jump to the previous unread message</entry>
446             </row>
447             <row>
448               <entry><madmutt-doc:funcref name="print-message"/></entry>
449               <entry><madmutt-doc:key>p</madmutt-doc:key></entry>
450               <entry>print the current entry</entry>
451             </row>
452             <row>
453               <entry><madmutt-doc:funcref name="query"/></entry>
454               <entry><madmutt-doc:key>Q</madmutt-doc:key></entry>
455               <entry>query external program for addresses</entry>
456             </row>
457             <row>
458               <entry><madmutt-doc:funcref name="quit"/></entry>
459               <entry><madmutt-doc:key>q</madmutt-doc:key></entry>
460               <entry>save changes to mailbox and quit</entry>
461             </row>
462             <row>
463               <entry><madmutt-doc:funcref name="read-subthread"/></entry>
464               <entry><madmutt-doc:key mod="E">r</madmutt-doc:key></entry>
465               <entry>mark the current subthread as read</entry>
466             </row>
467             <row>
468               <entry><madmutt-doc:funcref name="read-thread"/></entry>
469               <entry><madmutt-doc:key mod="C">R</madmutt-doc:key></entry>
470               <entry>mark the current thread as read</entry>
471             </row>
472             <row>
473               <entry><madmutt-doc:funcref name="recall-message"/></entry>
474               <entry><madmutt-doc:key>R</madmutt-doc:key></entry>
475               <entry>recall a postponed message</entry>
476             </row>
477             <row>
478               <entry><madmutt-doc:funcref name="reply"/></entry>
479               <entry><madmutt-doc:key>r</madmutt-doc:key></entry>
480               <entry>reply to a message</entry>
481             </row>
482             <row>
483               <entry><madmutt-doc:funcref name="resend-message"/></entry>
484               <entry><madmutt-doc:key mod="E">e</madmutt-doc:key></entry>
485               <entry>resend message and preserve MIME structure</entry>
486             </row>
487             <row>
488               <entry><madmutt-doc:funcref name="save-message"/></entry>
489               <entry><madmutt-doc:key>s</madmutt-doc:key></entry>
490               <entry>save message/attachment to a file</entry>
491             </row>
492             <row>
493               <entry><madmutt-doc:funcref name="set-flag"/></entry>
494               <entry><madmutt-doc:key>w</madmutt-doc:key></entry>
495               <entry>set a status flag on a message</entry>
496             </row>
497             <row>
498               <entry><madmutt-doc:funcref name="show-version"/></entry>
499               <entry><madmutt-doc:key>V</madmutt-doc:key></entry>
500               <entry>show the Madmutt version number and date</entry>
501             </row>
502             <row>
503               <entry><madmutt-doc:funcref name="show-limit"/></entry>
504               <entry><madmutt-doc:key mod="E">l</madmutt-doc:key></entry>
505               <entry>show currently active limit pattern, if any</entry>
506             </row>
507             <row>
508               <entry><madmutt-doc:funcref name="sort-mailbox"/></entry>
509               <entry><madmutt-doc:key>o</madmutt-doc:key></entry>
510               <entry>sort messages</entry>
511             </row>
512             <row>
513               <entry><madmutt-doc:funcref name="sort-reverse"/></entry>
514               <entry><madmutt-doc:key>O</madmutt-doc:key></entry>
515               <entry>sort messages in reverse order</entry>
516             </row>
517             <row>
518               <entry><madmutt-doc:funcref name="sync-mailbox"/></entry>
519               <entry><madmutt-doc:key>$</madmutt-doc:key></entry>
520               <entry>save changes to mailbox</entry>
521             </row>
522             <row>
523               <entry><madmutt-doc:funcref name="tag-pattern"/></entry>
524               <entry><madmutt-doc:key>T</madmutt-doc:key></entry>
525               <entry>tag messages matching a pattern</entry>
526             </row>
527             <row>
528               <entry><madmutt-doc:funcref name="tag-thread"/></entry>
529               <entry><madmutt-doc:key mod="E">t</madmutt-doc:key></entry>
530               <entry>tag/untag all messages in the current thread</entry>
531             </row>
532             <row>
533               <entry><madmutt-doc:funcref name="toggle-new"/></entry>
534               <entry><madmutt-doc:key>N</madmutt-doc:key></entry>
535               <entry>toggle a message's 'new' flag</entry>
536             </row>
537             <row>
538               <entry><madmutt-doc:funcref name="toggle-write"/></entry>
539               <entry><madmutt-doc:key>%</madmutt-doc:key></entry>
540               <entry>toggle whether the mailbox will be rewritten</entry>
541             </row>
542             <row>
543               <entry><madmutt-doc:funcref name="undelete-message"/></entry>
544               <entry><madmutt-doc:key>u</madmutt-doc:key></entry>
545               <entry>undelete the current entry</entry>
546             </row>
547             <row>
548               <entry><madmutt-doc:funcref name="undelete-pattern"/></entry>
549               <entry><madmutt-doc:key>U</madmutt-doc:key></entry>
550               <entry>undelete messages matching a pattern</entry>
551             </row>
552             <row>
553               <entry><madmutt-doc:funcref name="undelete-subthread"/></entry>
554               <entry><madmutt-doc:key mod="E">u</madmutt-doc:key></entry>
555               <entry>undelete all messages in subthread</entry>
556             </row>
557             <row>
558               <entry><madmutt-doc:funcref name="undelete-thread"/></entry>
559               <entry><madmutt-doc:key mod="C">U</madmutt-doc:key></entry>
560               <entry>undelete all messages in thread</entry>
561             </row>
562             <row>
563               <entry><madmutt-doc:funcref name="untag-pattern"/></entry>
564               <entry><madmutt-doc:key mod="C">T</madmutt-doc:key></entry>
565               <entry>untag messages matching a pattern</entry>
566             </row>
567             <row>
568               <entry><madmutt-doc:funcref name="view-attachments"/></entry>
569               <entry><madmutt-doc:key>v</madmutt-doc:key></entry>
570               <entry>show MIME attachments</entry>
571             </row>
572                   </tbody>
573       </tgroup>
574     </table>
575
576           
577         </para>
578         
579       </sect2>
580       
581       <sect2 id="functions-pager">
582         <title>pager</title>
583         
584         <para>
585           
586         <table frame="none" rowsep="1" texstr="l|l|l">
587           <title>Reference: Default Pager Function Bindings</title>
588           <tgroup cols="3" align="left" colsep="1" rowsep="1">
589           <thead>
590             <row>
591               <entry>Function</entry>
592               <entry>Default Key</entry>
593               <entry>Description</entry>
594             </row>
595           </thead>
596           <tbody>
597             <row>
598               <entry><madmutt-doc:funcref name="bottom"/></entry>
599               <entry></entry>
600               <entry>jump to the bottom of the message</entry>
601             </row>
602             <row>
603               <entry><madmutt-doc:funcref name="bounce-message"/></entry>
604               <entry><madmutt-doc:key>b</madmutt-doc:key></entry>
605               <entry>remail a message to another user</entry>
606             </row>
607             <row>
608               <entry><madmutt-doc:funcref name="change-folder"/></entry>
609               <entry><madmutt-doc:key>c</madmutt-doc:key></entry>
610               <entry>open a different folder</entry>
611             </row>
612             <row>
613               <entry><madmutt-doc:funcref name="change-folder-readonly"/></entry>
614               <entry><madmutt-doc:key mod="E">c</madmutt-doc:key></entry>
615               <entry>open a different folder in read only mode</entry>
616             </row>
617             <row>
618               <entry><madmutt-doc:funcref name="check-traditional-pgp"/></entry>
619               <entry><madmutt-doc:key mod="E">P</madmutt-doc:key></entry>
620               <entry>check for classic pgp</entry>
621             </row>
622             <row>
623               <entry><madmutt-doc:funcref name="copy-message"/></entry>
624               <entry><madmutt-doc:key>C</madmutt-doc:key></entry>
625               <entry>copy a message to a file/mailbox</entry>
626             </row>
627             <row>
628               <entry><madmutt-doc:funcref name="create-alias"/></entry>
629               <entry><madmutt-doc:key>a</madmutt-doc:key></entry>
630               <entry>create an alias from a message</entry>
631             </row>
632             <row>
633               <entry><madmutt-doc:funcref name="senderdecode-copy"/></entry>
634               <entry><madmutt-doc:key mod="E">C</madmutt-doc:key></entry>
635               <entry>decode a message and copy it to a file/mailbox</entry>
636             </row>
637             <row>
638               <entry><madmutt-doc:funcref name="decode-save"/></entry>
639               <entry><madmutt-doc:key mod="E">s</madmutt-doc:key></entry>
640               <entry>decode a message and save it to a file/mailbox</entry>
641             </row>
642             <row>
643               <entry><madmutt-doc:funcref name="delete-message"/></entry>
644               <entry><madmutt-doc:key>d</madmutt-doc:key></entry>
645               <entry>delete the current entry</entry>
646             </row>
647             <row>
648               <entry><madmutt-doc:funcref name="delete-subthread"/></entry>
649               <entry><madmutt-doc:key mod="E">d</madmutt-doc:key></entry>
650               <entry>delete all messages in subthread</entry>
651             </row>
652             <row>
653               <entry><madmutt-doc:funcref name="delete-thread"/></entry>
654               <entry><madmutt-doc:key mod="C">D</madmutt-doc:key></entry>
655               <entry>delete all messages in thread</entry>
656             </row>
657             <row>
658               <entry><madmutt-doc:funcref name="display-address"/></entry>
659               <entry><madmutt-doc:key>@</madmutt-doc:key></entry>
660               <entry>display full address of sender</entry>
661             </row>
662             <row>
663               <entry><madmutt-doc:funcref name="display-toggle-weed"/></entry>
664               <entry><madmutt-doc:key>h</madmutt-doc:key></entry>
665               <entry>display message and toggle header weeding</entry>
666             </row>
667             <row>
668               <entry><madmutt-doc:funcref name="edit"/></entry>
669               <entry><madmutt-doc:key>e</madmutt-doc:key></entry>
670               <entry>edit the current message</entry>
671             </row>
672             <row>
673               <entry><madmutt-doc:funcref name="edit-type"/></entry>
674               <entry><madmutt-doc:key mod="C">E</madmutt-doc:key></entry>
675               <entry>edit the current message's             Content-Type</entry>
676             </row>
677             <row>
678               <entry><madmutt-doc:funcref name="enter-command"/></entry>
679               <entry><madmutt-doc:key>:</madmutt-doc:key></entry>
680               <entry>enter a madmuttrc command</entry>
681             </row>
682             <row>
683               <entry><madmutt-doc:funcref name="exit"/></entry>
684               <entry><madmutt-doc:key>i</madmutt-doc:key></entry>
685               <entry>return to the main-menu</entry>
686             </row>
687             <row>
688               <entry><madmutt-doc:funcref name="extract-keys"/></entry>
689               <entry><madmutt-doc:key mod="C">K</madmutt-doc:key></entry>
690               <entry>extract PGP public keys</entry>
691             </row>
692             <row>
693               <entry><madmutt-doc:funcref name="flag-message"/></entry>
694               <entry><madmutt-doc:key>F</madmutt-doc:key></entry>
695               <entry>toggle a message's 'important' flag</entry>
696             </row>
697             <row>
698               <entry><madmutt-doc:funcref name="forget-passphrase"/></entry>
699               <entry><madmutt-doc:key mod="C">F</madmutt-doc:key></entry>
700               <entry>wipe PGP passphrase from memory</entry>
701             </row>
702             <row>
703               <entry><madmutt-doc:funcref name="forward-message"/></entry>
704               <entry><madmutt-doc:key>f</madmutt-doc:key></entry>
705               <entry>forward a message with comments</entry>
706             </row>
707             <row>
708               <entry><madmutt-doc:funcref name="group-reply"/></entry>
709               <entry><madmutt-doc:key>g</madmutt-doc:key></entry>
710               <entry>reply to all recipients</entry>
711             </row>
712             <row>
713               <entry><madmutt-doc:funcref name="half-up"/></entry>
714               <entry></entry>
715               <entry>move up one-half page</entry>
716             </row>
717             <row>
718               <entry><madmutt-doc:funcref name="half-down"/></entry>
719               <entry></entry>
720               <entry>move down one-half page</entry>
721             </row>
722             <row>
723               <entry><madmutt-doc:funcref name="help"/></entry>
724               <entry><madmutt-doc:key>?</madmutt-doc:key></entry>
725               <entry>this screen</entry>
726             </row>
727             <row>
728               <entry><madmutt-doc:funcref name="list-reply"/></entry>
729               <entry><madmutt-doc:key>L</madmutt-doc:key></entry>
730               <entry>reply to specified mailing list</entry>
731             </row>
732             <row>
733               <entry><madmutt-doc:funcref name="mail"/></entry>
734               <entry><madmutt-doc:key>m</madmutt-doc:key></entry>
735               <entry>compose a new mail message</entry>
736             </row>
737             <row>
738               <entry><madmutt-doc:funcref name="mail-key"/></entry>
739               <entry><madmutt-doc:key mod="E">k</madmutt-doc:key></entry>
740               <entry>mail a PGP public key</entry>
741             </row>
742             <row>
743               <entry><madmutt-doc:funcref name="mark-as-new"/></entry>
744               <entry><madmutt-doc:key>N</madmutt-doc:key></entry>
745               <entry>toggle a message's 'new' flag</entry>
746             </row>
747             <row>
748               <entry><madmutt-doc:funcref name="next-line"/></entry>
749               <entry><madmutt-doc:key>Return</madmutt-doc:key></entry>
750               <entry>scroll down one line</entry>
751             </row>
752             <row>
753               <entry><madmutt-doc:funcref name="next-entry"/></entry>
754               <entry><madmutt-doc:key>J</madmutt-doc:key></entry>
755               <entry>move to the next entry</entry>
756             </row>
757             <row>
758               <entry><madmutt-doc:funcref name="next-new"/></entry>
759               <entry></entry>
760               <entry>jump to the next new message</entry>
761             </row>
762             <row>
763               <entry><madmutt-doc:funcref name="next-new-then-unread"/></entry>
764               <entry><madmutt-doc:key>Tab</madmutt-doc:key></entry>
765               <entry>jump to the next new or unread message</entry>
766             </row>
767             <row>
768               <entry><madmutt-doc:funcref name="next-page"/></entry>
769               <entry></entry>
770               <entry>move to the next page</entry>
771             </row>
772             <row>
773               <entry><madmutt-doc:funcref name="next-subthread"/></entry>
774               <entry><madmutt-doc:key mod="E">n</madmutt-doc:key></entry>
775               <entry>jump to the next subthread</entry>
776             </row>
777             <row>
778               <entry><madmutt-doc:funcref name="next-thread"/></entry>
779               <entry><madmutt-doc:key mod="C">N</madmutt-doc:key></entry>
780               <entry>jump to the next thread</entry>
781             </row>
782             <row>
783               <entry><madmutt-doc:funcref name="next-undeleted"/></entry>
784               <entry><madmutt-doc:key>j</madmutt-doc:key></entry>
785               <entry>move to the next undeleted message</entry>
786             </row>
787             <row>
788               <entry><madmutt-doc:funcref name="next-unread"/></entry>
789               <entry></entry>
790               <entry>jump to the next unread message</entry>
791             </row>
792             <row>
793               <entry><madmutt-doc:funcref name="parent-message"/></entry>
794               <entry><madmutt-doc:key>P</madmutt-doc:key></entry>
795               <entry>jump to parent message in thread</entry>
796             </row>
797             <row>
798               <entry><madmutt-doc:funcref name="pipe-message"/></entry>
799               <entry><madmutt-doc:key>|</madmutt-doc:key></entry>
800               <entry>pipe message/attachment to a shell command</entry>
801             </row>
802             <row>
803               <entry><madmutt-doc:funcref name="previous-line"/></entry>
804               <entry><madmutt-doc:key>BackSpace</madmutt-doc:key></entry>
805               <entry>scroll up one line</entry>
806             </row>
807             <row>
808               <entry><madmutt-doc:funcref name="previous-entry"/></entry>
809               <entry><madmutt-doc:key>K</madmutt-doc:key></entry>
810               <entry>move to the previous entry</entry>
811             </row>
812             <row>
813               <entry><madmutt-doc:funcref name="previous-new"/></entry>
814               <entry></entry>
815               <entry>jump to the previous new message</entry>
816             </row>
817             <row>
818               <entry><madmutt-doc:funcref name="previous-new-then-unread"/></entry>
819               <entry></entry>
820               <entry>jump to the previous new or unread message</entry>
821             </row>
822             <row>
823               <entry><madmutt-doc:funcref name="previous-page"/></entry>
824               <entry><madmutt-doc:key>-</madmutt-doc:key></entry>
825               <entry>move to the previous page</entry>
826             </row>
827             <row>
828               <entry><madmutt-doc:funcref name="previous-subthread"/></entry>
829               <entry><madmutt-doc:key mod="E">p</madmutt-doc:key></entry>
830               <entry>jump to previous subthread</entry>
831             </row>
832             <row>
833               <entry><madmutt-doc:funcref name="previous-thread"/></entry>
834               <entry><madmutt-doc:key mod="C">P</madmutt-doc:key></entry>
835               <entry>jump to previous thread</entry>
836             </row>
837             <row>
838               <entry><madmutt-doc:funcref name="previous-undeleted"/></entry>
839               <entry><madmutt-doc:key>k</madmutt-doc:key></entry>
840               <entry>move to the last undelete message</entry>
841             </row>
842             <row>
843               <entry><madmutt-doc:funcref name="previous-unread"/></entry>
844               <entry></entry>
845               <entry>jump to the previous unread message</entry>
846             </row>
847             <row>
848               <entry><madmutt-doc:funcref name="print-message"/></entry>
849               <entry><madmutt-doc:key>p</madmutt-doc:key></entry>
850               <entry>print the current entry</entry>
851             </row>
852             <row>
853               <entry><madmutt-doc:funcref name="quit"/></entry>
854               <entry><madmutt-doc:key>Q</madmutt-doc:key></entry>
855               <entry>save changes to mailbox and quit</entry>
856             </row>
857             <row>
858               <entry><madmutt-doc:funcref name="read-subthread"/></entry>
859               <entry><madmutt-doc:key mod="E">r</madmutt-doc:key></entry>
860               <entry>mark the current subthread as read</entry>
861             </row>
862             <row>
863               <entry><madmutt-doc:funcref name="read-thread"/></entry>
864               <entry><madmutt-doc:key mod="C">R</madmutt-doc:key></entry>
865               <entry>mark the current thread as read</entry>
866             </row>
867             <row>
868               <entry><madmutt-doc:funcref name="recall-message"/></entry>
869               <entry><madmutt-doc:key>R</madmutt-doc:key></entry>
870               <entry>recall a postponed message</entry>
871             </row>
872             <row>
873               <entry><madmutt-doc:funcref name="redraw-screen"/></entry>
874               <entry><madmutt-doc:key mod="C">L</madmutt-doc:key></entry>
875               <entry>clear and redraw the screen</entry>
876             </row>
877             <row>
878               <entry><madmutt-doc:funcref name="reply"/></entry>
879               <entry><madmutt-doc:key>r</madmutt-doc:key></entry>
880               <entry>reply to a message</entry>
881             </row>
882             <row>
883               <entry><madmutt-doc:funcref name="save-message"/></entry>
884               <entry><madmutt-doc:key>s</madmutt-doc:key></entry>
885               <entry>save message/attachment to a file</entry>
886             </row>
887             <row>
888               <entry><madmutt-doc:funcref name="search"/></entry>
889               <entry><madmutt-doc:key>/</madmutt-doc:key></entry>
890               <entry>search for a regular expression</entry>
891             </row>
892             <row>
893               <entry><madmutt-doc:funcref name="search-next"/></entry>
894               <entry><madmutt-doc:key>n</madmutt-doc:key></entry>
895               <entry>search for next match</entry>
896             </row>
897             <row>
898               <entry><madmutt-doc:funcref name="search-opposite"/></entry>
899               <entry></entry>
900               <entry>search for next match in opposite direction</entry>
901             </row>
902             <row>
903               <entry><madmutt-doc:funcref name="search-reverse"/></entry>
904               <entry><madmutt-doc:key mod="E">/</madmutt-doc:key></entry>
905               <entry>search backwards for a regular expression</entry>
906             </row>
907             <row>
908               <entry><madmutt-doc:funcref name="search-toggle"/></entry>
909               <entry><madmutt-doc:key>\</madmutt-doc:key></entry>
910               <entry>toggle search pattern coloring</entry>
911             </row>
912             <row>
913               <entry><madmutt-doc:funcref name="shell-escape"/></entry>
914               <entry><madmutt-doc:key>!</madmutt-doc:key></entry>
915               <entry>invoke a command in a subshell</entry>
916             </row>
917             <row>
918               <entry><madmutt-doc:funcref name="show-version"/></entry>
919               <entry><madmutt-doc:key>V</madmutt-doc:key></entry>
920               <entry>show the Madmutt version number and date</entry>
921             </row>
922             <row>
923               <entry><madmutt-doc:funcref name="skip-quoted"/></entry>
924               <entry><madmutt-doc:key>S</madmutt-doc:key></entry>
925               <entry>skip beyond quoted text</entry>
926             </row>
927             <row>
928               <entry><madmutt-doc:funcref name="sync-mailbox"/></entry>
929               <entry><madmutt-doc:key>$</madmutt-doc:key></entry>
930               <entry>save changes to mailbox</entry>
931             </row>
932             <row>
933               <entry><madmutt-doc:funcref name="tag-message"/></entry>
934               <entry><madmutt-doc:key>t</madmutt-doc:key></entry>
935               <entry>tag a message</entry>
936             </row>
937             <row>
938               <entry><madmutt-doc:funcref name="toggle-quoted"/></entry>
939               <entry><madmutt-doc:key>T</madmutt-doc:key></entry>
940               <entry>toggle display of quoted text</entry>
941             </row>
942             <row>
943               <entry><madmutt-doc:funcref name="top"/></entry>
944               <entry><madmutt-doc:key>^</madmutt-doc:key></entry>
945               <entry>jump to the top of the message</entry>
946             </row>
947             <row>
948               <entry><madmutt-doc:funcref name="undelete-message"/></entry>
949               <entry><madmutt-doc:key>u</madmutt-doc:key></entry>
950               <entry>undelete the current entry</entry>
951             </row>
952             <row>
953               <entry><madmutt-doc:funcref name="undelete-subthread"/></entry>
954               <entry><madmutt-doc:key mod="E">u</madmutt-doc:key></entry>
955               <entry>undelete all messages in subthread</entry>
956             </row>
957             <row>
958               <entry><madmutt-doc:funcref name="undelete-thread"/></entry>
959               <entry><madmutt-doc:key mod="C">U</madmutt-doc:key></entry>
960               <entry>undelete all messages in thread</entry>
961             </row>
962             <row>
963               <entry><madmutt-doc:funcref name="view-attachments"/></entry>
964               <entry><madmutt-doc:key>v</madmutt-doc:key></entry>
965               <entry>show MIME attachments</entry>
966             </row>
967                   </tbody>
968       </tgroup>
969     </table>
970
971           
972         </para>
973         
974       </sect2>
975       
976       <sect2 id="functions-alias">
977         <title>alias</title>
978         
979         <para>
980           
981         <table frame="none" rowsep="1" texstr="l|l|l">
982           <title>Reference: Default Alias Menu Function Bindings</title>
983           <tgroup cols="3" align="left" colsep="1" rowsep="1">
984           <thead>
985             <row>
986               <entry>Function</entry>
987               <entry>Default Key</entry>
988               <entry>Description</entry>
989             </row>
990           </thead>
991           <tbody>
992             <row>
993               <entry><madmutt-doc:funcref name="search"/></entry>
994               <entry><madmutt-doc:key>/</madmutt-doc:key></entry>
995               <entry>search for a regular expression</entry>
996             </row>
997             <row>
998               <entry><madmutt-doc:funcref name="search-next"/></entry>
999               <entry><madmutt-doc:key>n</madmutt-doc:key></entry>
1000               <entry>search for next match</entry>
1001             </row>
1002             <row>
1003               <entry><madmutt-doc:funcref name="search-reverse"/></entry>
1004               <entry><madmutt-doc:key mod="E">/</madmutt-doc:key></entry>
1005               <entry>search backwards for a regular expression</entry>
1006             </row>
1007                   </tbody>
1008       </tgroup>
1009     </table>
1010
1011           
1012         </para>
1013         
1014       </sect2>
1015       
1016       <sect2 id="functions-query">
1017         <title>query</title>
1018         
1019         <para>
1020           
1021         <table frame="none" rowsep="1" texstr="l|l|l">
1022           <title>Reference: Default Query Menu Function Bindings</title>
1023           <tgroup cols="3" align="left" colsep="1" rowsep="1">
1024           <thead>
1025             <row>
1026               <entry>Function</entry>
1027               <entry>Default Key</entry>
1028               <entry>Description</entry>
1029             </row>
1030           </thead>
1031           <tbody>
1032             <row>
1033               <entry><madmutt-doc:funcref name="create-alias"/></entry>
1034               <entry><madmutt-doc:key>a</madmutt-doc:key></entry>
1035               <entry>create an alias from a message sender</entry>
1036             </row>
1037             <row>
1038               <entry><madmutt-doc:funcref name="mail"/></entry>
1039               <entry><madmutt-doc:key>m</madmutt-doc:key></entry>
1040               <entry>compose a new mail message</entry>
1041             </row>
1042             <row>
1043               <entry><madmutt-doc:funcref name="query"/></entry>
1044               <entry><madmutt-doc:key>Q</madmutt-doc:key></entry>
1045               <entry>query external program for addresses</entry>
1046             </row>
1047             <row>
1048               <entry><madmutt-doc:funcref name="query-append"/></entry>
1049               <entry><madmutt-doc:key>A</madmutt-doc:key></entry>
1050               <entry>append new query results to current results</entry>
1051             </row>
1052             <row>
1053               <entry><madmutt-doc:funcref name="search"/></entry>
1054               <entry><madmutt-doc:key>/</madmutt-doc:key></entry>
1055               <entry>search for a regular expression</entry>
1056             </row>
1057             <row>
1058               <entry><madmutt-doc:funcref name="search-next"/></entry>
1059               <entry><madmutt-doc:key>n</madmutt-doc:key></entry>
1060               <entry>search for next match</entry>
1061             </row>
1062             <row>
1063               <entry><madmutt-doc:funcref name="search-opposite"/></entry>
1064               <entry></entry>
1065               <entry>search for next match in opposite direction</entry>
1066             </row>
1067             <row>
1068               <entry><madmutt-doc:funcref name="search-reverse"/></entry>
1069               <entry><madmutt-doc:key mod="E">/</madmutt-doc:key></entry>
1070               <entry>search backwards for a regular expression</entry>
1071             </row>
1072                   </tbody>
1073       </tgroup>
1074     </table>
1075
1076           
1077         </para>
1078         
1079       </sect2>
1080       
1081       <sect2 id="functions-attach">
1082         <title>attach</title>
1083         
1084         <para>
1085           
1086         <table frame="none" rowsep="1" texstr="l|l|l">
1087           <title>Reference: Default Attachment Menu Function Bindings</title>
1088           <tgroup cols="3" align="left" colsep="1" rowsep="1">
1089           <thead>
1090             <row>
1091               <entry>Function</entry>
1092               <entry>Default Key</entry>
1093               <entry>Description</entry>
1094             </row>
1095           </thead>
1096           <tbody>
1097             <row>
1098               <entry><madmutt-doc:funcref name="bounce-message"/></entry>
1099               <entry><madmutt-doc:key>b</madmutt-doc:key></entry>
1100               <entry>remail a message to another user</entry>
1101             </row>
1102             <row>
1103               <entry><madmutt-doc:funcref name="collapse-parts"/></entry>
1104               <entry><madmutt-doc:key>v</madmutt-doc:key></entry>
1105               <entry>toggle display of subparts</entry>
1106             </row>
1107             <row>
1108               <entry><madmutt-doc:funcref name="delete-entry"/></entry>
1109               <entry><madmutt-doc:key>d</madmutt-doc:key></entry>
1110               <entry>delete the current entry</entry>
1111             </row>
1112             <row>
1113               <entry><madmutt-doc:funcref name="display-toggle-weed"/></entry>
1114               <entry><madmutt-doc:key>h</madmutt-doc:key></entry>
1115               <entry>display message and toggle header weeding</entry>
1116             </row>
1117             <row>
1118               <entry><madmutt-doc:funcref name="edit-type"/></entry>
1119               <entry><madmutt-doc:key mod="C">E</madmutt-doc:key></entry>
1120               <entry>edit the current entry's Content-Type</entry>
1121             </row>
1122             <row>
1123               <entry><madmutt-doc:funcref name="extract-keys"/></entry>
1124               <entry><madmutt-doc:key mod="C">K</madmutt-doc:key></entry>
1125               <entry>extract PGP public keys</entry>
1126             </row>
1127             <row>
1128               <entry><madmutt-doc:funcref name="forward-message"/></entry>
1129               <entry><madmutt-doc:key>f</madmutt-doc:key></entry>
1130               <entry>forward a message with comments</entry>
1131             </row>
1132             <row>
1133               <entry><madmutt-doc:funcref name="group-reply"/></entry>
1134               <entry><madmutt-doc:key>g</madmutt-doc:key></entry>
1135               <entry>reply to all recipients</entry>
1136             </row>
1137             <row>
1138               <entry><madmutt-doc:funcref name="list-reply"/></entry>
1139               <entry><madmutt-doc:key>L</madmutt-doc:key></entry>
1140               <entry>reply to specified mailing list</entry>
1141             </row>
1142             <row>
1143               <entry><madmutt-doc:funcref name="pipe-entry"/></entry>
1144               <entry><madmutt-doc:key>|</madmutt-doc:key></entry>
1145               <entry>pipe message/attachment to a shell command</entry>
1146             </row>
1147             <row>
1148               <entry><madmutt-doc:funcref name="print-entry"/></entry>
1149               <entry><madmutt-doc:key>p</madmutt-doc:key></entry>
1150               <entry>print the current entry</entry>
1151             </row>
1152             <row>
1153               <entry><madmutt-doc:funcref name="reply"/></entry>
1154               <entry><madmutt-doc:key>r</madmutt-doc:key></entry>
1155               <entry>reply to a message</entry>
1156             </row>
1157             <row>
1158               <entry><madmutt-doc:funcref name="resend-message"/></entry>
1159               <entry><madmutt-doc:key mod="E">e</madmutt-doc:key></entry>
1160               <entry>resend message and preserve MIME        structure</entry>
1161             </row>
1162             <row>
1163               <entry><madmutt-doc:funcref name="save-entry"/></entry>
1164               <entry><madmutt-doc:key>s</madmutt-doc:key></entry>
1165               <entry>save message/attachment to a file</entry>
1166             </row>
1167             <row>
1168               <entry><madmutt-doc:funcref name="undelete-entry"/></entry>
1169               <entry><madmutt-doc:key>u</madmutt-doc:key></entry>
1170               <entry>undelete the current entry</entry>
1171             </row>
1172             <row>
1173               <entry><madmutt-doc:funcref name="view-attach"/></entry>
1174               <entry><madmutt-doc:key>Return</madmutt-doc:key></entry>
1175               <entry>view attachment using mailcap entry if necessary</entry>
1176             </row>
1177             <row>
1178               <entry><madmutt-doc:funcref name="view-mailcap"/></entry>
1179               <entry><madmutt-doc:key>m</madmutt-doc:key></entry>
1180               <entry>force viewing of attachment using mailcap</entry>
1181             </row>
1182             <row>
1183               <entry><madmutt-doc:funcref name="view-text"/></entry>
1184               <entry><madmutt-doc:key>T</madmutt-doc:key></entry>
1185               <entry>view attachment as text</entry>
1186             </row>
1187                   </tbody>
1188       </tgroup>
1189     </table>
1190
1191           
1192         </para>
1193         
1194       </sect2>
1195       
1196       <sect2 id="functions-compose">
1197         <title>compose</title>
1198         
1199         <para>
1200           
1201         <table frame="none" rowsep="1" texstr="l|l|l">
1202           <title>Reference: Default Compose Menu Function Bindings</title>
1203           <tgroup cols="3" align="left" colsep="1" rowsep="1">
1204           <thead>
1205             <row>
1206               <entry>Function</entry>
1207               <entry>Default Key</entry>
1208               <entry>Description</entry>
1209             </row>
1210           </thead>
1211           <tbody>
1212             <row>
1213               <entry><madmutt-doc:funcref name="attach-file"/></entry>
1214               <entry><madmutt-doc:key>a</madmutt-doc:key></entry>
1215               <entry>attach a file(s) to this message</entry>
1216             </row>
1217             <row>
1218               <entry><madmutt-doc:funcref name="attach-message"/></entry>
1219               <entry><madmutt-doc:key>A</madmutt-doc:key></entry>
1220               <entry>attach message(s) to this message</entry>
1221             </row>
1222             <row>
1223               <entry><madmutt-doc:funcref name="attach-key"/></entry>
1224               <entry><madmutt-doc:key mod="E">k</madmutt-doc:key></entry>
1225               <entry>attach a PGP public key</entry>
1226             </row>
1227             <row>
1228               <entry><madmutt-doc:funcref name="copy-file"/></entry>
1229               <entry><madmutt-doc:key>C</madmutt-doc:key></entry>
1230               <entry>save message/attachment to a file</entry>
1231             </row>
1232             <row>
1233               <entry><madmutt-doc:funcref name="detach-file"/></entry>
1234               <entry><madmutt-doc:key>D</madmutt-doc:key></entry>
1235               <entry>delete the current entry</entry>
1236             </row>
1237             <row>
1238               <entry><madmutt-doc:funcref name="display-toggle-weed"/></entry>
1239               <entry><madmutt-doc:key>h</madmutt-doc:key></entry>
1240               <entry>display message and toggle header weeding</entry>
1241             </row>
1242             <row>
1243               <entry><madmutt-doc:funcref name="edit-bcc"/></entry>
1244               <entry><madmutt-doc:key>b</madmutt-doc:key></entry>
1245               <entry>edit the BCC list</entry>
1246             </row>
1247             <row>
1248               <entry><madmutt-doc:funcref name="edit-cc"/></entry>
1249               <entry><madmutt-doc:key>c</madmutt-doc:key></entry>
1250               <entry>edit the CC list</entry>
1251             </row>
1252             <row>
1253               <entry><madmutt-doc:funcref name="edit-description"/></entry>
1254               <entry><madmutt-doc:key>d</madmutt-doc:key></entry>
1255               <entry>edit attachment description</entry>
1256             </row>
1257             <row>
1258               <entry><madmutt-doc:funcref name="edit-encoding"/></entry>
1259               <entry><madmutt-doc:key mod="C">E</madmutt-doc:key></entry>
1260               <entry>edit attachment transfer-encoding</entry>
1261             </row>
1262             <row>
1263               <entry><madmutt-doc:funcref name="edit-fcc"/></entry>
1264               <entry><madmutt-doc:key>f</madmutt-doc:key></entry>
1265               <entry>enter a file to save a copy of this message in</entry>
1266             </row>
1267             <row>
1268               <entry><madmutt-doc:funcref name="edit-from"/></entry>
1269               <entry><madmutt-doc:key mod="E">f</madmutt-doc:key></entry>
1270               <entry>edit the from: field</entry>
1271             </row>
1272             <row>
1273               <entry><madmutt-doc:funcref name="edit-file"/></entry>
1274               <entry><madmutt-doc:key mod="C">X e</madmutt-doc:key></entry>
1275               <entry>edit the file to be attached</entry>
1276             </row>
1277             <row>
1278               <entry><madmutt-doc:funcref name="edit-headers"/></entry>
1279               <entry><madmutt-doc:key>E</madmutt-doc:key></entry>
1280               <entry>edit the message with headers</entry>
1281             </row>
1282             <row>
1283               <entry><madmutt-doc:funcref name="edit"/></entry>
1284               <entry><madmutt-doc:key>e</madmutt-doc:key></entry>
1285               <entry>edit the message</entry>
1286             </row>
1287             <row>
1288               <entry><madmutt-doc:funcref name="edit-mime"/></entry>
1289               <entry><madmutt-doc:key>m</madmutt-doc:key></entry>
1290               <entry>edit attachment using mailcap entry</entry>
1291             </row>
1292             <row>
1293               <entry><madmutt-doc:funcref name="edit-reply-to"/></entry>
1294               <entry><madmutt-doc:key>r</madmutt-doc:key></entry>
1295               <entry>edit the Reply-To field</entry>
1296             </row>
1297             <row>
1298               <entry><madmutt-doc:funcref name="edit-subject"/></entry>
1299               <entry><madmutt-doc:key>s</madmutt-doc:key></entry>
1300               <entry>edit the subject of this message</entry>
1301             </row>
1302             <row>
1303               <entry><madmutt-doc:funcref name="edit-to"/></entry>
1304               <entry><madmutt-doc:key>t</madmutt-doc:key></entry>
1305               <entry>edit the TO list</entry>
1306             </row>
1307             <row>
1308               <entry><madmutt-doc:funcref name="edit-type"/></entry>
1309               <entry><madmutt-doc:key mod="C">T</madmutt-doc:key></entry>
1310               <entry>edit attachment type</entry>
1311             </row>
1312             <row>
1313               <entry><madmutt-doc:funcref name="filter-entry"/></entry>
1314               <entry><madmutt-doc:key>F</madmutt-doc:key></entry>
1315               <entry>filter attachment through a shell command</entry>
1316             </row>
1317             <row>
1318               <entry><madmutt-doc:funcref name="forget-passphrase"/></entry>
1319               <entry><madmutt-doc:key mod="C">F</madmutt-doc:key></entry>
1320               <entry>wipe PGP passphrase from memory</entry>
1321             </row>
1322             <row>
1323               <entry><madmutt-doc:funcref name="ispell"/></entry>
1324               <entry><madmutt-doc:key>i</madmutt-doc:key></entry>
1325               <entry>run ispell on the message</entry>
1326             </row>
1327             <row>
1328               <entry><madmutt-doc:funcref name="new-mime"/></entry>
1329               <entry><madmutt-doc:key>n</madmutt-doc:key></entry>
1330               <entry>compose new attachment using mailcap entry</entry>
1331             </row>
1332             <row>
1333               <entry><madmutt-doc:funcref name="pgp-menu"/></entry>
1334               <entry><madmutt-doc:key>p</madmutt-doc:key></entry>
1335               <entry>show PGP options</entry>
1336             </row>
1337             <row>
1338               <entry><madmutt-doc:funcref name="pipe-entry"/></entry>
1339               <entry><madmutt-doc:key>|</madmutt-doc:key></entry>
1340               <entry>pipe message/attachment to a shell command</entry>
1341             </row>
1342             <row>
1343               <entry><madmutt-doc:funcref name="postpone-message"/></entry>
1344               <entry><madmutt-doc:key>P</madmutt-doc:key></entry>
1345               <entry>save this message to send later</entry>
1346             </row>
1347             <row>
1348               <entry><madmutt-doc:funcref name="print-entry"/></entry>
1349               <entry><madmutt-doc:key>l</madmutt-doc:key></entry>
1350               <entry>print the current entry</entry>
1351             </row>
1352             <row>
1353               <entry><madmutt-doc:funcref name="rename-file"/></entry>
1354               <entry><madmutt-doc:key>R</madmutt-doc:key></entry>
1355               <entry>rename/move an attached file</entry>
1356             </row>
1357             <row>
1358               <entry><madmutt-doc:funcref name="send-message"/></entry>
1359               <entry><madmutt-doc:key>y</madmutt-doc:key></entry>
1360               <entry>send the message</entry>
1361             </row>
1362             <row>
1363               <entry><madmutt-doc:funcref name="toggle-unlink"/></entry>
1364               <entry><madmutt-doc:key>u</madmutt-doc:key></entry>
1365               <entry>toggle whether to delete file after sending it</entry>
1366             </row>
1367             <row>
1368               <entry><madmutt-doc:funcref name="view-attach"/></entry>
1369               <entry><madmutt-doc:key>Return</madmutt-doc:key></entry>
1370               <entry>view attachment using mailcap entry if necessary</entry>
1371             </row>
1372             <row>
1373               <entry><madmutt-doc:funcref name="write-fcc"/></entry>
1374               <entry><madmutt-doc:key>w</madmutt-doc:key></entry>
1375               <entry>write the message to a folder</entry>
1376             </row>
1377                   </tbody>
1378       </tgroup>
1379     </table>
1380
1381           
1382         </para>
1383         
1384       </sect2>
1385       
1386       <sect2 id="functions-postpone">
1387         <title>postpone</title>
1388         
1389         <para>
1390           
1391         <table frame="none" rowsep="1" texstr="l|l|l">
1392           <title>Reference: Default Postpone Menu Function Bindings</title>
1393           <tgroup cols="3" align="left" colsep="1" rowsep="1">
1394           <thead>
1395             <row>
1396               <entry>Function</entry>
1397               <entry>Default Key</entry>
1398               <entry>Description</entry>
1399             </row>
1400           </thead>
1401           <tbody>
1402             <row>
1403               <entry><madmutt-doc:funcref name="delete-entry"/></entry>
1404               <entry><madmutt-doc:key>d</madmutt-doc:key></entry>
1405               <entry>delete the current entry</entry>
1406             </row>
1407             <row>
1408               <entry><madmutt-doc:funcref name="undelete-entry"/></entry>
1409               <entry><madmutt-doc:key>u</madmutt-doc:key></entry>
1410               <entry>undelete the current entry</entry>
1411             </row>
1412                   </tbody>
1413       </tgroup>
1414     </table>
1415
1416           
1417         </para>
1418         
1419       </sect2>
1420       
1421       <sect2 id="functions-browser">
1422         <title>browser</title>
1423         
1424         <para>
1425           
1426         <table frame="none" rowsep="1" texstr="l|l|l">
1427           <title>Reference: Default Browser Menu Function Bindings</title>
1428           <tgroup cols="3" align="left" colsep="1" rowsep="1">
1429           <thead>
1430             <row>
1431               <entry>Function</entry>
1432               <entry>Default Key</entry>
1433               <entry>Description</entry>
1434             </row>
1435           </thead>
1436           <tbody>
1437             <row>
1438               <entry><madmutt-doc:funcref name="change-dir"/></entry>
1439               <entry><madmutt-doc:key>c</madmutt-doc:key></entry>
1440               <entry>change directories</entry>
1441             </row>
1442             <row>
1443               <entry><madmutt-doc:funcref name="check-new"/></entry>
1444               <entry><madmutt-doc:key>Tab</madmutt-doc:key></entry>
1445               <entry>check mailboxes for new mail</entry>
1446             </row>
1447             <row>
1448               <entry><madmutt-doc:funcref name="enter-mask"/></entry>
1449               <entry><madmutt-doc:key>m</madmutt-doc:key></entry>
1450               <entry>enter a file mask</entry>
1451             </row>
1452             <row>
1453               <entry><madmutt-doc:funcref name="search"/></entry>
1454               <entry><madmutt-doc:key>/</madmutt-doc:key></entry>
1455               <entry>search for a regular expression</entry>
1456             </row>
1457             <row>
1458               <entry><madmutt-doc:funcref name="search-next"/></entry>
1459               <entry><madmutt-doc:key>n</madmutt-doc:key></entry>
1460               <entry>search for next match</entry>
1461             </row>
1462             <row>
1463               <entry><madmutt-doc:funcref name="search-reverse"/></entry>
1464               <entry><madmutt-doc:key mod="E">/</madmutt-doc:key></entry>
1465               <entry>search backwards for a regular expression</entry>
1466             </row>
1467             <row>
1468               <entry><madmutt-doc:funcref name="select-new"/></entry>
1469               <entry><madmutt-doc:key>N</madmutt-doc:key></entry>
1470               <entry>select a new file in this directory</entry>
1471             </row>
1472             <row>
1473               <entry><madmutt-doc:funcref name="sort"/></entry>
1474               <entry><madmutt-doc:key>o</madmutt-doc:key></entry>
1475               <entry>sort messages</entry>
1476             </row>
1477             <row>
1478               <entry><madmutt-doc:funcref name="sort-reverse"/></entry>
1479               <entry><madmutt-doc:key>O</madmutt-doc:key></entry>
1480               <entry>sort messages in reverse order</entry>
1481             </row>
1482             <row>
1483               <entry><madmutt-doc:funcref name="toggle-mailboxes"/></entry>
1484               <entry><madmutt-doc:key>Tab</madmutt-doc:key></entry>
1485               <entry>toggle whether to browse mailboxes or all files</entry>
1486             </row>
1487             <row>
1488               <entry><madmutt-doc:funcref name="view-file"/></entry>
1489               <entry><madmutt-doc:key>Space</madmutt-doc:key></entry>
1490               <entry>view file</entry>
1491             </row>
1492             <row>
1493               <entry><madmutt-doc:funcref name="subscribe"/></entry>
1494               <entry><madmutt-doc:key>s</madmutt-doc:key></entry>
1495               <entry>subscribe to current mailbox (IMAP            Only)</entry>
1496             </row>
1497             <row>
1498               <entry><madmutt-doc:funcref name="unsubscribe"/></entry>
1499               <entry><madmutt-doc:key>u</madmutt-doc:key></entry>
1500               <entry>unsubscribe to current mailbox (IMAP            Only)</entry>
1501             </row>
1502             <row>
1503               <entry><madmutt-doc:funcref name="toggle-subscribed"/></entry>
1504               <entry><madmutt-doc:key>T</madmutt-doc:key></entry>
1505               <entry>toggle view all/subscribed mailboxes            (IMAP Only)</entry>
1506             </row>
1507                   </tbody>
1508       </tgroup>
1509     </table>
1510
1511           
1512         </para>
1513         
1514       </sect2>
1515       
1516       <sect2 id="functions-crypto">
1517         <title>pgp</title>
1518         
1519         <para>
1520           
1521         <table frame="none" rowsep="1" texstr="l|l|l">
1522           <title>Reference: Default PGP Menu Function Bindings</title>
1523           <tgroup cols="3" align="left" colsep="1" rowsep="1">
1524           <thead>
1525             <row>
1526               <entry>Function</entry>
1527               <entry>Default Key</entry>
1528               <entry>Description</entry>
1529             </row>
1530           </thead>
1531           <tbody>
1532             <row>
1533               <entry><madmutt-doc:funcref name="view-name"/></entry>
1534               <entry><madmutt-doc:key>%</madmutt-doc:key></entry>
1535               <entry>view the key's user id</entry>
1536             </row>
1537             <row>
1538               <entry><madmutt-doc:funcref name="verify-key"/></entry>
1539               <entry><madmutt-doc:key>c</madmutt-doc:key></entry>
1540               <entry>verify a PGP public key</entry>
1541             </row>
1542                   </tbody>
1543       </tgroup>
1544     </table>
1545
1546           
1547         </para>
1548         
1549       </sect2>
1550       
1551       <sect2 id="functions-editor">
1552         <title>editor</title>
1553         
1554         <para>
1555           
1556         <table frame="none" rowsep="1" texstr="l|l|l">
1557           <title>Reference: Default Editor Function Bindings</title>
1558           <tgroup cols="3" align="left" colsep="1" rowsep="1">
1559           <thead>
1560             <row>
1561               <entry>Function</entry>
1562               <entry>Default Key</entry>
1563               <entry>Description</entry>
1564             </row>
1565           </thead>
1566           <tbody>
1567             <row>
1568               <entry><madmutt-doc:funcref name="backspace"/></entry>
1569               <entry><madmutt-doc:key>BackSpace</madmutt-doc:key></entry>
1570               <entry>delete the char in front of the cursor</entry>
1571             </row>
1572             <row>
1573               <entry><madmutt-doc:funcref name="backward-char"/></entry>
1574               <entry><madmutt-doc:key mod="C">B</madmutt-doc:key></entry>
1575               <entry>move the cursor one character to the left</entry>
1576             </row>
1577             <row>
1578               <entry><madmutt-doc:funcref name="backward-word"/></entry>
1579               <entry><madmutt-doc:key mod="E">b</madmutt-doc:key></entry>
1580               <entry>move the cursor to the previous word</entry>
1581             </row>
1582             <row>
1583               <entry><madmutt-doc:funcref name="bol"/></entry>
1584               <entry><madmutt-doc:key mod="C">A</madmutt-doc:key></entry>
1585               <entry>jump to the beginning of the line</entry>
1586             </row>
1587             <row>
1588               <entry><madmutt-doc:funcref name="buffy-cycle"/></entry>
1589               <entry><madmutt-doc:key>Space</madmutt-doc:key></entry>
1590               <entry>cycle among incoming mailboxes</entry>
1591             </row>
1592             <row>
1593               <entry><madmutt-doc:funcref name="capitalize-word"/></entry>
1594               <entry><madmutt-doc:key mod="E">c</madmutt-doc:key></entry>
1595               <entry>uppercase the first character in the word</entry>
1596             </row>
1597             <row>
1598               <entry><madmutt-doc:funcref name="complete"/></entry>
1599               <entry><madmutt-doc:key>Tab</madmutt-doc:key></entry>
1600               <entry>complete filename or alias</entry>
1601             </row>
1602             <row>
1603               <entry><madmutt-doc:funcref name="complete-query"/></entry>
1604               <entry><madmutt-doc:key mod="C">T</madmutt-doc:key></entry>
1605               <entry>complete address with query</entry>
1606             </row>
1607             <row>
1608               <entry><madmutt-doc:funcref name="delete-char"/></entry>
1609               <entry><madmutt-doc:key mod="C">D</madmutt-doc:key></entry>
1610               <entry>delete the char under the cursor</entry>
1611             </row>
1612             <row>
1613               <entry><madmutt-doc:funcref name="downcase-word"/></entry>
1614               <entry><madmutt-doc:key mod="E">l</madmutt-doc:key></entry>
1615               <entry>lowercase all characters in current word</entry>
1616             </row>
1617             <row>
1618               <entry><madmutt-doc:funcref name="eol"/></entry>
1619               <entry><madmutt-doc:key mod="C">E</madmutt-doc:key></entry>
1620               <entry>jump to the end of the line</entry>
1621             </row>
1622             <row>
1623               <entry><madmutt-doc:funcref name="forward-char"/></entry>
1624               <entry><madmutt-doc:key mod="C">F</madmutt-doc:key></entry>
1625               <entry>move the cursor one character to the right</entry>
1626             </row>
1627             <row>
1628               <entry><madmutt-doc:funcref name="forward-word"/></entry>
1629               <entry><madmutt-doc:key mod="E">f</madmutt-doc:key></entry>
1630               <entry>move the cursor to the next word</entry>
1631             </row>
1632             <row>
1633               <entry><madmutt-doc:funcref name="history-down"/></entry>
1634               <entry></entry>
1635               <entry>scroll down through the history list</entry>
1636             </row>
1637             <row>
1638               <entry><madmutt-doc:funcref name="history-up"/></entry>
1639               <entry></entry>
1640               <entry>scroll up through the history list</entry>
1641             </row>
1642             <row>
1643               <entry><madmutt-doc:funcref name="kill-eol"/></entry>
1644               <entry><madmutt-doc:key mod="C">K</madmutt-doc:key></entry>
1645               <entry>delete chars from cursor to end of line</entry>
1646             </row>
1647             <row>
1648               <entry><madmutt-doc:funcref name="kill-eow"/></entry>
1649               <entry><madmutt-doc:key mod="E">d</madmutt-doc:key></entry>
1650               <entry>delete chars from cursor to end of word</entry>
1651             </row>
1652             <row>
1653               <entry><madmutt-doc:funcref name="kill-line"/></entry>
1654               <entry><madmutt-doc:key mod="C">U</madmutt-doc:key></entry>
1655               <entry>delete all chars on the line</entry>
1656             </row>
1657             <row>
1658               <entry><madmutt-doc:funcref name="kill-word"/></entry>
1659               <entry><madmutt-doc:key mod="C">W</madmutt-doc:key></entry>
1660               <entry>delete the word in front of the cursor</entry>
1661             </row>
1662             <row>
1663               <entry><madmutt-doc:funcref name="quote-char"/></entry>
1664               <entry><madmutt-doc:key mod="C">V</madmutt-doc:key></entry>
1665               <entry>quote the next typed key</entry>
1666             </row>
1667             <row>
1668               <entry><madmutt-doc:funcref name="transpose-chars"/></entry>
1669               <entry></entry>
1670               <entry>transpose character under cursor with previous</entry>
1671             </row>
1672             <row>
1673               <entry><madmutt-doc:funcref name="upcase-word"/></entry>
1674               <entry><madmutt-doc:key mod="E">u</madmutt-doc:key></entry>
1675               <entry>uppercase all characters in current word</entry>
1676             </row>
1677                   </tbody>
1678       </tgroup>
1679     </table>
1680
1681           
1682         </para>
1683         
1684       </sect2>
1685
1686       <sect2 id="functions-sidebar">
1687         <title>sidebar</title>
1688         
1689       <para>
1690         <table frame="none" rowsep="1" texstr="l|l|l">
1691           <title>Referene: Default Sidebar Function Bindings</title>
1692           <tgroup cols="3" align="left" colsep="1" rowsep="1">
1693           <thead>
1694             <row>
1695               <entry>Key</entry>
1696               <entry>Function</entry>
1697               <entry>Description</entry>
1698             </row>
1699           </thead>
1700           <tbody>
1701             <row>
1702               <entry></entry>
1703               <entry><madmutt-doc:funcref name="sidebar-scroll-up"/></entry>
1704               <entry>Scrolls the mailbox list up 1 page</entry>
1705             </row>
1706             <row>
1707               <entry></entry>
1708               <entry><madmutt-doc:funcref name="sidebar-scroll-down"/></entry>
1709               <entry>Scrolls the mailbox list down 1 page</entry>
1710             </row>
1711             <row>
1712               <entry></entry>
1713               <entry><madmutt-doc:funcref name="sidebar-next"/></entry>
1714               <entry>Highlights the next mailbox</entry>
1715             </row>
1716             <row>
1717               <entry></entry>
1718               <entry><madmutt-doc:funcref name="sidebar-next-new"/></entry>
1719               <entry>Highlights the next mailbox with new mail</entry>
1720             </row>
1721             <row>
1722               <entry></entry>
1723               <entry><madmutt-doc:funcref name="sidebar-previous"/></entry>
1724               <entry>Highlights the previous mailbox</entry>
1725             </row>
1726             <row>
1727               <entry></entry>
1728               <entry><madmutt-doc:funcref name="sidebar-open"/></entry>
1729               <entry>Opens the currently highlighted mailbox</entry>
1730             </row>
1731           </tbody>
1732         </tgroup>
1733       </table>
1734     </para>
1735
1736     </sect2>
1737
1738     </sect1>
1739     
1740   </chapter>
1741
1742   <appendix id="acknowledgments">
1743     <title>Acknowledgments</title>
1744     
1745     <para>
1746         Kari Hurtta <email>kari.hurtta@fmi.fi</email> co-developed the
1747       original MIME
1748       >parsing code back in the ELM-ME days.
1749     </para>
1750     
1751     <para> The following people have been very helpful to the development of
1752       Mutt (sorted by surnames): 
1753     </para>
1754     
1755     <para>
1756       <itemizedlist>
1757         <listitem>
1758           Vikas Agnihotri <email>vikasa@writeme.com</email>
1759         </listitem>
1760         <listitem>
1761           Francois Berjon <email> Francois.Berjon@aar.alcatel-alsthom.fr</email>
1762         </listitem>
1763         <listitem>
1764           Aric Blumer <email>aric@fore.com</email>
1765         </listitem>
1766         <listitem>
1767           John Capo <email>jc@irbs.com</email>
1768         </listitem>
1769         <listitem>
1770           David Champion <email>dgc@uchicago.edu</email>
1771         </listitem>
1772         <listitem>
1773           Brendan Cully <email>brendan@kublai.com</email>
1774         </listitem>
1775         <listitem>
1776           Liviu Daia <email>daia@stoilow.imar.ro</email>
1777         </listitem>
1778         <listitem>
1779           Thomas E. Dickey <email>dickey@herndon4.his.com</email>
1780         </listitem>
1781         <listitem>
1782           David DeSimone <email>fox@convex.hp.com</email>
1783         </listitem>
1784         <listitem>
1785           Nickolay N. Dudorov <email>nnd@wint.itfs.nsk.su</email>
1786         </listitem>
1787         <listitem>
1788           Ruslan Ermilov <email>ru@freebsd.org</email>
1789         </listitem>
1790         <listitem>
1791           Edmund Grimley Evans <email>edmundo@rano.org</email>
1792         </listitem>
1793         <listitem>
1794           Michael Finken <email>finken@conware.de</email>
1795         </listitem>
1796         <listitem>
1797           Sven Guckes <email>guckes@math.fu-berlin.de</email>
1798         </listitem>
1799         <listitem>
1800           Lars Hecking <email>lhecking@nmrc.ie</email>
1801         </listitem>
1802         <listitem>
1803           Mark Holloman <email>holloman@nando.net</email>
1804         </listitem>
1805         <listitem>
1806           Andreas Holzmann <email>holzmann@fmi.uni-passau.de</email>
1807         </listitem>
1808         <listitem>
1809           Marco d'Itri <email>md@linux.it</email>
1810         </listitem>
1811         <listitem>
1812           Björn Jacke <email>bjacke@suse.com</email>
1813         </listitem>
1814         <listitem>
1815           Byrial Jensen <email>byrial@image.dk</email>
1816         </listitem>
1817         <listitem>
1818           David Jeske <email>jeske@igcom.net</email>
1819         </listitem>
1820         <listitem>
1821           Christophe Kalt <email>kalt@hugo.int-evry.fr</email>
1822         </listitem>
1823         <listitem>
1824           Tommi Komulainen <email>Tommi.Komulainen@iki.fi</email>
1825         </listitem>
1826         <listitem>
1827           Felix von Leitner (a.k.a ``Fefe'') <email>
1828             leitner@math.fu-berlin.de
1829           </email>
1830         </listitem>
1831         <listitem>
1832           Brandon Long <email>blong@fiction.net</email>
1833         </listitem>
1834         <listitem>
1835           Jimmy Mäkeä <email>jmy@flashback.net</email>
1836         </listitem>
1837         <listitem>
1838           Lars Marowsky-Bree <email>lmb@pointer.in-minden.de</email>
1839         </listitem>
1840         <listitem>
1841           Thomas ``Mike'' Michlmayr <email>mike@cosy.sbg.ac.at</email>
1842         </listitem>
1843         <listitem>
1844           Andrew W. Nosenko <email>awn@bcs.zp.ua</email>
1845         </listitem>
1846         <listitem>
1847           David O'Brien <email>obrien@Nuxi.cs.ucdavis.edu</email>
1848         </listitem>
1849         <listitem>
1850           Clint Olsen <email>olsenc@ichips.intel.com</email>
1851         </listitem>
1852         <listitem>
1853           Park Myeong Seok <email>pms@romance.kaist.ac.kr</email>
1854         </listitem>
1855         <listitem>
1856           Thomas Parmelan <email>tom@ankh.fr.eu.org</email>
1857         </listitem>
1858         <listitem>
1859           Ollivier Robert <email>roberto@keltia.freenix.fr</email>
1860         </listitem>
1861         <listitem>
1862           Thomas Roessler <email>roessler@does-not-exist.org</email>
1863         </listitem>
1864         <listitem>
1865           Roland Rosenfeld <email>roland@spinnaker.de</email>
1866         </listitem>
1867         <listitem>
1868           TAKIZAWA Takashi <email>taki@luna.email.ne.jp</email>
1869         </listitem>
1870         <listitem>
1871           Allain Thivillon <email>Allain.Thivillon@alma.fr</email>
1872         </listitem>
1873         <listitem>
1874           Gero Treuner <email>gero@70t.de</email>
1875         </listitem>
1876         <listitem>
1877           Vsevolod Volkov <email>vvv@lucky.net</email>
1878         </listitem>
1879         <listitem>
1880           Ken Weinert <email>kenw@ihs.com</email>
1881         </listitem>
1882         </itemizedlist>
1883       </para>
1884       
1885       <para>
1886         Madmutt is developed by the following people:
1887       </para>
1888       
1889       <para>
1890         <itemizedlist>
1891           <listitem>
1892             Andreas Krennmair <email>ak@synflood.at</email>
1893           </listitem>
1894           <listitem>
1895             Nico Golde <email>nico@ngolde.de</email>
1896           </listitem>
1897           <listitem>
1898             Rocco Rutte <email>pdmef@cs.tu-berlin.de</email>
1899           </listitem>
1900         </itemizedlist>
1901       </para>
1902       
1903       <para>
1904         The following people have been very helpful to the
1905         development of Madmutt (sorted by surnames):
1906       </para>
1907       
1908       <para>
1909         <itemizedlist>
1910           <listitem>
1911             Christian Gall <email>cg@cgall.de</email>
1912           </listitem>
1913           <listitem>
1914             Iain Lea <email>iain@bricbrac.de</email>
1915           </listitem>
1916           <listitem>
1917             Andreas Kneib <email>akneib@gmx.net</email>
1918           </listitem>
1919           <listitem>
1920             Felix Meinhold <email>felix.meinhold@gmx.net</email>
1921           </listitem>
1922           <listitem>
1923             Carsten Schoelzki <email>cjs@weisshuhn.de</email>
1924           </listitem>
1925           <listitem>
1926             Elimar Riesebieter <email>riesebie@lxtec.de</email>
1927           </listitem>
1928         </itemizedlist>
1929       </para>
1930
1931     </appendix>
1932
1933     <appendix id="hacking-documentation">
1934       <title>Hacking Documentation</title>
1935
1936       <para>
1937         This manual is written in XML and transformed via a XSLT
1938         stylesheet into valid DocBook/XML and/or <madmutt-doc:special
1939           docbook="LaTeX" latex="\LaTeX{}"/> to be again transformed via a
1940         XSLT stylesheet into the final formats.
1941       </para>
1942
1943       <para>
1944         This two pass processing is required to keep the file size low
1945         and to sanitize use, i.e. drastically lower the typing
1946         overhead.
1947       </para>
1948
1949       <para>
1950         To achieve the latter, the sources come with a file called
1951         <literal>madmutt-manual.xsl</literal> introducing the
1952         <literal>madmutt-doc</literal> namespace which offers the following
1953         tags to be used (<emphasis>note: this is far from being
1954           complete, any help towards consistency is <emphasis
1955             role="bold">highly</emphasis> appreciated</emphasis>).
1956       </para>
1957
1958       <para>
1959         <variablelist>
1960           <varlistentry>
1961             <term><literal>&lt;madmutt-doc:man name="" [sect=""]/&gt;</literal></term>
1962             <listitem><para>
1963                 <emphasis>References to manual pages.</emphasis> If the
1964                 <literal>sect</literal> parameter is omitted, it'll
1965                 be 1 for the commands section. There's no auto-indexing yet.
1966             </para></listitem>
1967           </varlistentry>
1968           <varlistentry>
1969             <term><literal>&lt;madmutt-doc:envvar name=""/&gt;</literal></term>
1970             <listitem><para>
1971                 <emphasis>References to environment
1972                   variables.</emphasis> The <literal>name</literal>
1973                 parameter must contain upper-case letters only without
1974                 the dollar sign as it'll be added automatically.
1975                 Auto-indexing is done.
1976             </para></listitem>
1977           </varlistentry>
1978           <varlistentry>
1979             <term><literal>&lt;madmutt-doc:hook name=""/&gt;</literal></term>
1980             <listitem><para>
1981                 <emphasis>References to hooks.</emphasis> The string
1982                 <literal>-hook</literal> will be added automatically to
1983                 the value given in the <literal>name</literal>
1984                 parameter. All entries will be auto-indexed.
1985             </para></listitem>
1986           </varlistentry>
1987           <varlistentry>
1988             <term><literal>&lt;madmutt-doc:pattern name="" [full="1"]/&gt;</literal></term>
1989             <listitem><para>
1990                 <emphasis>References to patterns.</emphasis> The
1991                 <literal>name</literal> parameter must only contain the
1992                 letter/symbol for the pattern as the tilde symbol/equal
1993                 sign will be added automatically. Auto-indexing is done. If the
1994                 <literal>full</literal> parameter is given the equal sign as well
1995                 as tilde will be printed for a fully complete reference.
1996             </para></listitem>
1997           </varlistentry>
1998           <varlistentry>
1999             <term><literal>&lt;madmutt-doc:key [mod="C|E"]&gt;key&lt;/madmutt-doc:key&gt;</literal></term>
2000             <listitem><para>
2001                 <emphasis>Referencing a key.</emphasis>. Because it's
2002                 somewhat untrivial to always get the right escaping for 
2003                 <madmutt-doc:special docbook="LaTeX" latex="\LaTeX{}"/>,
2004                 there's a tag for it. The optional modifiers
2005                 <literal>C</literal> or <literal>E</literal> stand for
2006                 Control and Escape respectively. To still allow
2007                 escaping, the actual key sequences must be given within
2008                 the tag.
2009             </para></listitem>
2010           </varlistentry>
2011           <varlistentry>
2012             <term><literal>&lt;madmutt-doc:funcdef name=""/&gt;</literal></term>
2013             <listitem><para>
2014                 <emphasis>Defining a command.</emphasis>. It's used to
2015                 define a command with the name given in the
2016                 <literal>name</literal> parameter. The default key
2017                 binding must be given via
2018                 <literal>&lt;madmutt-doc:key/&gt;</literal> (see above). The string
2019                 will be automatically enclosed in
2020                 <literal>&lt;&gt;</literal>. Auto-indexing is done.
2021                 Also an anchor with id
2022                 <literal>func-[name]</literal> will be added with
2023                 <literal>[name]</literal> being the value of the
2024                 <literal>name</literal> parameter.
2025             </para></listitem>
2026           </varlistentry>
2027           <varlistentry>
2028             <term><literal>&lt;madmutt-doc:funcref name=""/&gt;</literal></term>
2029             <listitem><para>
2030                 <emphasis>References to functions.</emphasis>. This is
2031                 practically the same as the above except that there's no
2032                 anchor defined.
2033             </para></listitem>
2034           </varlistentry>
2035           <varlistentry>
2036             <term><literal>&lt;madmutt-doc:vardef name=""/&gt;</literal></term>
2037             <listitem><para>
2038                 <emphasis>Defining a variable.</emphasis> This is to be
2039                 used by <literal>makedoc</literal> only to define a
2040                 command with a given name and XML-normalized link given
2041                 via <literal>id</literal>. Auto-indexing is done. The
2042                 <literal>name</literal> parameter's value will be
2043                 prefixed with a dollar sign as for environment
2044                 variables.
2045             </para></listitem>
2046           </varlistentry>
2047           <varlistentry>
2048             <term><literal>&lt;madmutt-doc:varref name=""/&gt;</literal></term>
2049             <listitem><para>
2050                 <emphasis>References to variables.</emphasis> This
2051                 practically is the same as above except that the text
2052                 inbetween won't be wrapped within a
2053                 <literal>&lt;sect1&gt;</literal> tag. Auto-indexing is
2054                 the same as for the above. This one is intended for
2055                 manual use.
2056             </para></listitem>
2057           </varlistentry>
2058           <varlistentry>
2059             <term><literal>&lt;madmutt-doc:web url""/&gt;</literal></term>
2060             <listitem><para>
2061                 <emphasis>Pretty print a linked URL</emphasis>. As for
2062                 E-Mail addresses where the text (mostly) equals the
2063                 link's target, URLs must be enclosed in
2064                 <literal>&lt;&gt;</literal> (also this reduced redudant
2065                 URL typing).
2066             </para></listitem>
2067           </varlistentry>
2068           <varlistentry>
2069             <term><literal>&lt;madmutt-doc:rfc num=""/&gt;</literal></term>
2070             <listitem><para>
2071                 <emphasis>References to RfC documents.</emphasis> Use
2072                 this to produce links to RfC document with number given
2073                 as the <literal>num</literal> parameter. A link to
2074                 <madmutt-doc:web url="http://www.faqs.org/"/> will be
2075                 made. Auto-indexing is done under
2076                 <emphasis>RfC</emphasis>.
2077             </para></listitem>
2078           </varlistentry>
2079           <varlistentry>
2080             <term><literal>&lt;madmutt-doc:cmddef name="" [noanchor="1"]/&gt;</literal></term>
2081             <listitem><para>
2082                 <emphasis>Defining a configuration command.</emphasis>
2083                 The name of the command is given as the
2084                 <literal>name</literal> parameter. In case a single
2085                 command has multiple possible calling sequences, specify
2086                 <literal>noanchor="1"</literal> for subsequent use.
2087                 Auto-indexing is done. Specify the arguments within the
2088                 tag.
2089             </para></listitem>
2090           </varlistentry>
2091           <varlistentry>
2092             <term><literal>&lt;madmutt-doc:cmdref name=""/&gt;</literal></term>
2093             <listitem><para>
2094                 <emphasis>References to configuration commands.</emphasis>
2095                 Use this to refer to commands as it builds the proper
2096                 internal reference name. Auto-indexing is done.
2097             </para></listitem>
2098           </varlistentry>
2099           <varlistentry>
2100             <term><literal>&lt;madmutt-doc:lstconf/&gt;</literal>,
2101               <literal>&lt;madmutt-doc:lstmail/&gt;</literal>,
2102               <literal>&lt;madmutt-doc:lstshell/&gt;</literal>
2103             </term>
2104             <listitem><para>
2105                 <emphasis>Screen layout by context.</emphasis> These are
2106                 used to specify environments for different types of
2107                 screen output. For DocBook output, all of these simply
2108                 map to <literal>&lt;screen/&gt;</literal>. But as a
2109                 possible future migration to LaTeX may be ahead,
2110                 different languages defined for the
2111                 <literal>listings.sty</literal> packages may be used to
2112                 have proper syntax highlighting for these so that there
2113                 must be a context sensitive distinction.
2114             </para></listitem>
2115           </varlistentry>
2116           <varlistentry>
2117             <term><literal>&lt;madmutt-doc:special [docbook=""] [latex=""]/&gt;</literal></term>
2118             <listitem><para>
2119                 This is intended for specifying special strings for
2120                 either DocBook/XML or <madmutt-doc:special
2121                   docbook="LaTeX" latex="\LaTeX{}"/>.
2122             </para></listitem>
2123           </varlistentry>
2124
2125         </variablelist>
2126       </para>
2127
2128       <para>
2129         Additional notes follow.
2130       </para>
2131       
2132       <para>
2133         <itemizedlist>
2134           <listitem>
2135             <para>To not fully bloat the XSL stylesheet
2136               procuding the <madmutt-doc:special docbook="LaTeX"
2137                 latex="\LaTeX{}"/> code, all tables <emphasis>must</emphasis>
2138               have an attribute called <literal>texstr</literal> which is
2139               directly passed to <literal>longtable</literal>.
2140             </para>
2141           </listitem>
2142         </itemizedlist>
2143       </para>
2144
2145     </appendix>
2146
2147     <index/>
2148
2149   </book>