diff options
| author | Karoly Lorentey | 2006-03-15 17:22:12 +0000 |
|---|---|---|
| committer | Karoly Lorentey | 2006-03-15 17:22:12 +0000 |
| commit | b336ee388ed5300440e7bab24bf9eec9f250911a (patch) | |
| tree | 62c9058bd403d158d7d18d1cbd4ead3abf36a7aa /man | |
| parent | 47f3c6b4dbed851762dca99273d78642c3794188 (diff) | |
| parent | 4034b0e259dd59eda180bd0683876c9d0110f719 (diff) | |
| download | emacs-b336ee388ed5300440e7bab24bf9eec9f250911a.tar.gz emacs-b336ee388ed5300440e7bab24bf9eec9f250911a.zip | |
Merged from emacs@sv.gnu.org
Patches applied:
* emacs@sv.gnu.org/emacs--devo--0--patch-153
Update from CVS
* emacs@sv.gnu.org/emacs--devo--0--patch-154
Update from CVS
* emacs@sv.gnu.org/emacs--devo--0--patch-155
Remove nick-abbrevs stuff from rcirc.el
* emacs@sv.gnu.org/emacs--devo--0--patch-156
rcirc.el update from Ryan Yeske
* emacs@sv.gnu.org/emacs--devo--0--patch-157
Update from CVS
* emacs@sv.gnu.org/emacs--devo--0--patch-158
Update from CVS
* emacs@sv.gnu.org/emacs--devo--0--patch-159
Update from CVS
git-archimport-id: lorentey@elte.hu--2004/emacs--multi-tty--0--patch-532
Diffstat (limited to 'man')
| -rw-r--r-- | man/ChangeLog | 32 | ||||
| -rw-r--r-- | man/calendar.texi | 111 | ||||
| -rw-r--r-- | man/mh-e.texi | 1082 | ||||
| -rw-r--r-- | man/org.texi | 41 |
4 files changed, 941 insertions, 325 deletions
diff --git a/man/ChangeLog b/man/ChangeLog index 385a8c81ea0..7eddcae6b5e 100644 --- a/man/ChangeLog +++ b/man/ChangeLog | |||
| @@ -1,3 +1,35 @@ | |||
| 1 | 2006-03-14 Bill Wohler <wohler@newt.com> | ||
| 2 | |||
| 3 | * mh-e.texi: Add index entries around each paragraph rather than | ||
| 4 | depend on entries from beginning of node. Doing so ensures that | ||
| 5 | index entries are less likely to be forgotten if text is cut and | ||
| 6 | pasted, and are necessary anyway if the references are on a | ||
| 7 | separate page. It seems that makeinfo is now (v. 4.8) only | ||
| 8 | producing one index entry per node, so there is no longer any | ||
| 9 | excuse not to. Use subheading instead of heading. The incorrect | ||
| 10 | use of heading produced very large fonts in Info--as large as the | ||
| 11 | main heading. | ||
| 12 | (From Bill Wohler): MH-E never did appear in Emacs 21--MH-E | ||
| 13 | versions 6 and 7 appeared *around* the time of these Emacs | ||
| 14 | releases. | ||
| 15 | |||
| 16 | 2006-03-13 Carsten Dominik <dominik@science.uva.nl> | ||
| 17 | |||
| 18 | * org.texi (Clean view): Document new startup options. | ||
| 19 | |||
| 20 | 2006-03-11 Bill Wohler <wohler@newt.com> | ||
| 21 | |||
| 22 | * mh-e.texi (Preface, More About MH-E, Options, HTML, Folders) | ||
| 23 | (Composing, Scan Line Formats): Fix @refs. | ||
| 24 | (Getting Started): Define MH profile and MH profile components. | ||
| 25 | (Incorporating Mail, Reading Mail, Viewing, Printing) | ||
| 26 | (Sending Mail, Forwarding, Editing Drafts, Inserting Letter) | ||
| 27 | (Signature, Aliases, Scan Line Formats): Use @code instead of @samp | ||
| 28 | for string constants. | ||
| 29 | (Tool Bar): Remove spurious quote. | ||
| 30 | (Junk): Use ``...'' instead of "...". | ||
| 31 | (Scan Line Formats): Replace @samp with @kbd. | ||
| 32 | |||
| 1 | 2006-03-11 Luc Teirlinck <teirllm@auburn.edu> | 33 | 2006-03-11 Luc Teirlinck <teirllm@auburn.edu> |
| 2 | 34 | ||
| 3 | * search.texi (Regexps): Use @samp for regexp that is not in Lisp | 35 | * search.texi (Regexps): Use @samp for regexp that is not in Lisp |
diff --git a/man/calendar.texi b/man/calendar.texi index 988a509ca02..23aeb191e86 100644 --- a/man/calendar.texi +++ b/man/calendar.texi | |||
| @@ -24,7 +24,7 @@ particular date; @kbd{Mouse-3} brings up a menu of commonly used | |||
| 24 | calendar features that are independent of any particular date. To exit | 24 | calendar features that are independent of any particular date. To exit |
| 25 | the calendar, type @kbd{q}. | 25 | the calendar, type @kbd{q}. |
| 26 | 26 | ||
| 27 | The basic features of the Calendar/Diary are described here. | 27 | This chapter describes the basic calendar features. |
| 28 | @inforef{Advanced Calendar/Diary Usage,, emacs-xtra}, for information | 28 | @inforef{Advanced Calendar/Diary Usage,, emacs-xtra}, for information |
| 29 | about more specialized features. | 29 | about more specialized features. |
| 30 | 30 | ||
| @@ -49,13 +49,13 @@ about more specialized features. | |||
| 49 | @section Movement in the Calendar | 49 | @section Movement in the Calendar |
| 50 | 50 | ||
| 51 | @cindex moving inside the calendar | 51 | @cindex moving inside the calendar |
| 52 | Calendar mode lets you move through the calendar in logical units of | 52 | Calendar mode provides commands to move through the calendar in |
| 53 | time such as days, weeks, months, and years. If you move outside the | 53 | logical units of time such as days, weeks, months, and years. If you |
| 54 | three months originally displayed, the calendar display ``scrolls'' | 54 | move outside the three months originally displayed, the calendar |
| 55 | automatically through time to make the selected date visible. Moving to | 55 | display ``scrolls'' automatically through time to make the selected |
| 56 | a date lets you view its holidays or diary entries, or convert it to other | 56 | date visible. Moving to a date lets you view its holidays or diary |
| 57 | calendars; moving longer time periods is also useful simply to scroll the | 57 | entries, or convert it to other calendars; moving by long time periods |
| 58 | calendar. | 58 | is also useful simply to scroll the calendar. |
| 59 | 59 | ||
| 60 | @menu | 60 | @menu |
| 61 | * Calendar Unit Motion:: Moving by days, weeks, months, and years. | 61 | * Calendar Unit Motion:: Moving by days, weeks, months, and years. |
| @@ -117,16 +117,16 @@ moves to the same day in the previous week. | |||
| 117 | @findex calendar-forward-year | 117 | @findex calendar-forward-year |
| 118 | The commands for motion by months and years work like those for | 118 | The commands for motion by months and years work like those for |
| 119 | weeks, but move a larger distance. The month commands @kbd{M-@}} and | 119 | weeks, but move a larger distance. The month commands @kbd{M-@}} and |
| 120 | @kbd{M-@{} move forward or backward by an entire month's time. The | 120 | @kbd{M-@{} move forward or backward by an entire month. The year |
| 121 | year commands @kbd{C-x ]} and @w{@kbd{C-x [}} move forward or backward a | 121 | commands @kbd{C-x ]} and @w{@kbd{C-x [}} move forward or backward a |
| 122 | whole year. | 122 | whole year. |
| 123 | 123 | ||
| 124 | The easiest way to remember these commands is to consider months and | 124 | The easiest way to remember these commands is to consider months and |
| 125 | years analogous to paragraphs and pages of text, respectively. But the | 125 | years analogous to paragraphs and pages of text, respectively. But |
| 126 | commands themselves are not quite analogous. The ordinary Emacs paragraph | 126 | the commands themselves are not quite analogous. The ordinary Emacs |
| 127 | commands move to the beginning or end of a paragraph, whereas these month | 127 | paragraph commands move to the beginning or end of a paragraph, |
| 128 | and year commands move by an entire month or an entire year, which usually | 128 | whereas these month and year commands move by an entire month or an |
| 129 | involves skipping across the end of a month or year. | 129 | entire year, keeping the same date within the month or year. |
| 130 | 130 | ||
| 131 | All these commands accept a numeric argument as a repeat count. | 131 | All these commands accept a numeric argument as a repeat count. |
| 132 | For convenience, the digit keys and the minus sign specify numeric | 132 | For convenience, the digit keys and the minus sign specify numeric |
| @@ -313,8 +313,8 @@ Exit from calendar (@code{exit-calendar}). | |||
| 313 | To display the number of days elapsed since the start of the year, or | 313 | To display the number of days elapsed since the start of the year, or |
| 314 | the number of days remaining in the year, type the @kbd{p d} command | 314 | the number of days remaining in the year, type the @kbd{p d} command |
| 315 | (@code{calendar-print-day-of-year}). This displays both of those | 315 | (@code{calendar-print-day-of-year}). This displays both of those |
| 316 | numbers in the echo area. The number of days elapsed includes the | 316 | numbers in the echo area. The count of days elapsed includes the |
| 317 | selected date. The number of days remaining does not include that | 317 | selected date. The count of days remaining does not include that |
| 318 | date. | 318 | date. |
| 319 | 319 | ||
| 320 | @kindex C-c C-l @r{(Calendar mode)} | 320 | @kindex C-c C-l @r{(Calendar mode)} |
| @@ -432,8 +432,7 @@ date in the calendar window and use the @kbd{h} command. Alternatively, | |||
| 432 | click on that date with @kbd{Mouse-2} and then choose @kbd{Holidays} | 432 | click on that date with @kbd{Mouse-2} and then choose @kbd{Holidays} |
| 433 | from the menu that appears. Either way, this displays the holidays for | 433 | from the menu that appears. Either way, this displays the holidays for |
| 434 | that date, in the echo area if they fit there, otherwise in a separate | 434 | that date, in the echo area if they fit there, otherwise in a separate |
| 435 | window. If the variable @code{view-calendar-holidays-initially} is | 435 | window. |
| 436 | non-@code{nil}, creating the calendar displays holidays in this way. | ||
| 437 | 436 | ||
| 438 | @kindex x @r{(Calendar mode)} | 437 | @kindex x @r{(Calendar mode)} |
| 439 | @findex mark-calendar-holidays | 438 | @findex mark-calendar-holidays |
| @@ -462,9 +461,11 @@ calendar window to scroll that list up and down, respectively. | |||
| 462 | @findex holidays | 461 | @findex holidays |
| 463 | The command @kbd{M-x holidays} displays the list of holidays for the | 462 | The command @kbd{M-x holidays} displays the list of holidays for the |
| 464 | current month and the preceding and succeeding months; this works even | 463 | current month and the preceding and succeeding months; this works even |
| 465 | if you don't have a calendar window. If you want the list of holidays | 464 | if you don't have a calendar window. If the variable |
| 466 | centered around a different month, use @kbd{C-u M-x holidays}, which | 465 | @code{view-calendar-holidays-initially} is non-@code{nil}, creating |
| 467 | prompts for the month and year. | 466 | the calendar displays holidays in this way. If you want the list of |
| 467 | holidays centered around a different month, use @kbd{C-u M-x | ||
| 468 | holidays}, which prompts for the month and year. | ||
| 468 | 469 | ||
| 469 | The holidays known to Emacs include United States holidays and the | 470 | The holidays known to Emacs include United States holidays and the |
| 470 | major Christian, Jewish, and Islamic holidays; also the solstices and | 471 | major Christian, Jewish, and Islamic holidays; also the solstices and |
| @@ -1017,7 +1018,7 @@ following day. | |||
| 1017 | @kbd{Mouse-2} on the date, and then choose @kbd{Diary entries} from | 1018 | @kbd{Mouse-2} on the date, and then choose @kbd{Diary entries} from |
| 1018 | the menu that appears. If the variable | 1019 | the menu that appears. If the variable |
| 1019 | @code{view-diary-entries-initially} is non-@code{nil}, creating the | 1020 | @code{view-diary-entries-initially} is non-@code{nil}, creating the |
| 1020 | calendar also lists diary entries for the current date (provided the | 1021 | calendar lists the diary entries for the current date (provided the |
| 1021 | current date is visible). | 1022 | current date is visible). |
| 1022 | 1023 | ||
| 1023 | @kindex m @r{(Calendar mode)} | 1024 | @kindex m @r{(Calendar mode)} |
| @@ -1371,10 +1372,10 @@ begins with a recognizable time of day, Emacs can warn you several | |||
| 1371 | minutes beforehand that that appointment is pending. Emacs alerts you | 1372 | minutes beforehand that that appointment is pending. Emacs alerts you |
| 1372 | to the appointment by displaying a message in your chosen format, as | 1373 | to the appointment by displaying a message in your chosen format, as |
| 1373 | specified by the variable @code{appt-display-format}. If the value of | 1374 | specified by the variable @code{appt-display-format}. If the value of |
| 1374 | @code{appt-audible} is non-@code{nil}, an audible reminder is also | 1375 | @code{appt-audible} is non-@code{nil}, the warning includes an audible |
| 1375 | given. In addition, if @code{appt-display-mode-line} is non-@code{nil}, | 1376 | reminder. In addition, if @code{appt-display-mode-line} is |
| 1376 | Emacs displays the number of minutes to the appointment on the mode | 1377 | non-@code{nil}, Emacs displays the number of minutes to the |
| 1377 | line. | 1378 | appointment on the mode line. |
| 1378 | 1379 | ||
| 1379 | @vindex appt-display-duration | 1380 | @vindex appt-display-duration |
| 1380 | @vindex appt-disp-window-function | 1381 | @vindex appt-disp-window-function |
| @@ -1387,12 +1388,12 @@ give the names of functions used to create and destroy the window, | |||
| 1387 | respectively. | 1388 | respectively. |
| 1388 | 1389 | ||
| 1389 | @findex appt-activate | 1390 | @findex appt-activate |
| 1390 | To enable appointment notification, call the function | 1391 | To enable appointment notification, use the command @kbd{M-x |
| 1391 | @code{appt-activate} with a positive argument. This sets up an | 1392 | appt-activate}. With a positive argument, it enables notification; |
| 1392 | appointment list for today from the diary file, giving all diary entries | 1393 | with a negative argument, it disables notification; with no argument, |
| 1393 | found with recognizable times of day, and reminds you just before each | 1394 | it toggles. Enabling notification also sets up an appointment list |
| 1394 | of them. Calling @code{appt-activate} with a negative argument disables | 1395 | for today from the diary file, giving all diary entries found with |
| 1395 | the appointment package. With no argument, it toggles. | 1396 | recognizable times of day, and reminds you just before each of them. |
| 1396 | 1397 | ||
| 1397 | For example, suppose the diary file contains these lines: | 1398 | For example, suppose the diary file contains these lines: |
| 1398 | 1399 | ||
| @@ -1404,10 +1405,10 @@ Monday | |||
| 1404 | 1405 | ||
| 1405 | @vindex appt-message-warning-time | 1406 | @vindex appt-message-warning-time |
| 1406 | @noindent | 1407 | @noindent |
| 1407 | Then on Mondays, you will be reminded at around 9:20am about your coffee | 1408 | Then on Mondays, you will be reminded at around 9:20am about your |
| 1408 | break and at around 11:50am about lunch. How many minutes in advance you | 1409 | coffee break and at around 11:50am about lunch. The variable |
| 1409 | are first warned is determined by the value of | 1410 | @code{appt-message-warning-time} specifies how many minutes in advance |
| 1410 | @code{appt-message-warning-time}. | 1411 | to warn you; its default value is 12 (12 minutes). |
| 1411 | 1412 | ||
| 1412 | You can write times in am/pm style (with @samp{12:00am} standing | 1413 | You can write times in am/pm style (with @samp{12:00am} standing |
| 1413 | for midnight and @samp{12:00pm} standing for noon), or 24-hour | 1414 | for midnight and @samp{12:00pm} standing for noon), or 24-hour |
| @@ -1416,12 +1417,12 @@ can have a mixture of the two styles. Times must be at the beginning | |||
| 1416 | of lines if they are to be recognized. | 1417 | of lines if they are to be recognized. |
| 1417 | 1418 | ||
| 1418 | @vindex appt-display-diary | 1419 | @vindex appt-display-diary |
| 1419 | Emacs updates the appointments list from the diary file automatically | 1420 | Emacs updates the appointments list from the diary file |
| 1420 | just after midnight. An update can be forced at any time by | 1421 | automatically just after midnight. You can force an update at any |
| 1421 | re-activating the appointment package. Both these actions also display | 1422 | time by re-enabling appointment notification. Both these actions also |
| 1422 | the day's diary buffer, unless you set @code{appt-display-diary} to | 1423 | display the day's diary buffer, unless you set |
| 1423 | @code{nil}. The appointments list is also updated whenever the | 1424 | @code{appt-display-diary} to @code{nil}. The appointments list is |
| 1424 | diary file is saved. | 1425 | also updated whenever the diary file is saved. |
| 1425 | 1426 | ||
| 1426 | @findex appt-add | 1427 | @findex appt-add |
| 1427 | @findex appt-delete | 1428 | @findex appt-delete |
| @@ -1450,11 +1451,11 @@ diary file and iCalendar files, which are defined in ``RFC | |||
| 1450 | 2445---Internet Calendaring and Scheduling Core Object Specification | 1451 | 2445---Internet Calendaring and Scheduling Core Object Specification |
| 1451 | (iCalendar)'' (as well as the earlier vCalendar format). | 1452 | (iCalendar)'' (as well as the earlier vCalendar format). |
| 1452 | 1453 | ||
| 1453 | Importing works for ``ordinary'' (i.e. non-recurring) events, but (at | 1454 | Importing works for ``ordinary'' (i.e. non-recurring) events, but |
| 1454 | present) may not work correctly (if at all) for recurring events. | 1455 | (at present) may not work correctly (if at all) for recurring events. |
| 1455 | Exporting of diary files into iCalendar files should work correctly for | 1456 | Exporting of diary files into iCalendar files should work correctly |
| 1456 | most diary entries. Please note that @file{icalendar.el} is work in | 1457 | for most diary entries. This feature is a work in progress, so the |
| 1457 | progress, so usage may evolve in future. | 1458 | commands may evolve in future. |
| 1458 | 1459 | ||
| 1459 | @findex icalendar-import-buffer | 1460 | @findex icalendar-import-buffer |
| 1460 | The command @code{icalendar-import-buffer} extracts | 1461 | The command @code{icalendar-import-buffer} extracts |
| @@ -1476,7 +1477,7 @@ and adds the results to an Emacs diary file. For example: | |||
| 1476 | 1477 | ||
| 1477 | @noindent | 1478 | @noindent |
| 1478 | You can use an @code{#include} directive to add the import file contents | 1479 | You can use an @code{#include} directive to add the import file contents |
| 1479 | to the main diary file, if these are distinct. @inforef{Fancy Diary | 1480 | to the main diary file, if these are different files. @inforef{Fancy Diary |
| 1480 | Display,, emacs-xtra}. | 1481 | Display,, emacs-xtra}. |
| 1481 | 1482 | ||
| 1482 | @findex icalendar-export-file, icalendar-export-region | 1483 | @findex icalendar-export-file, icalendar-export-region |
| @@ -1485,7 +1486,6 @@ Emacs diary file to iCalendar format. To export only a part of a diary | |||
| 1485 | file, mark the relevant area, and call @code{icalendar-export-region}. | 1486 | file, mark the relevant area, and call @code{icalendar-export-region}. |
| 1486 | In both cases the result is appended to the target file. | 1487 | In both cases the result is appended to the target file. |
| 1487 | 1488 | ||
| 1488 | |||
| 1489 | @node Daylight Savings | 1489 | @node Daylight Savings |
| 1490 | @section Daylight Savings Time | 1490 | @section Daylight Savings Time |
| 1491 | @cindex daylight savings time | 1491 | @cindex daylight savings time |
| @@ -1560,7 +1560,8 @@ values are 120. | |||
| 1560 | @cindex timeclock | 1560 | @cindex timeclock |
| 1561 | 1561 | ||
| 1562 | The timeclock feature adds up time intervals, so you can (for | 1562 | The timeclock feature adds up time intervals, so you can (for |
| 1563 | instance) keep track of how much time you spend working. | 1563 | instance) keep track of how much time you spend working on particular |
| 1564 | projects. | ||
| 1564 | 1565 | ||
| 1565 | @findex timeclock-in | 1566 | @findex timeclock-in |
| 1566 | @findex timeclock-out | 1567 | @findex timeclock-out |
| @@ -1586,11 +1587,11 @@ workday in the mode line, either customize the | |||
| 1586 | @code{t}, or invoke the @kbd{M-x timeclock-modeline-display} command. | 1587 | @code{t}, or invoke the @kbd{M-x timeclock-modeline-display} command. |
| 1587 | 1588 | ||
| 1588 | @vindex timeclock-ask-before-exiting | 1589 | @vindex timeclock-ask-before-exiting |
| 1589 | Terminating the current Emacs session might or might not mean that you | 1590 | Terminating the current Emacs session might or might not mean that |
| 1590 | have stopped working on the project and, by default, Emacs queries this. | 1591 | you have stopped working on the project and, by default, Emacs asks |
| 1591 | You can, however, set the value of the variable | 1592 | you. You can, however, set the value of the variable |
| 1592 | @code{timeclock-ask-before-exiting} to @code{nil} (via @kbd{M-x | 1593 | @code{timeclock-ask-before-exiting} to @code{nil} (via @kbd{M-x |
| 1593 | customize}) to avoid this behavior; then, only an explicit @kbd{M-x | 1594 | customize}) to avoid the question; then, only an explicit @kbd{M-x |
| 1594 | timeclock-out} or @kbd{M-x timeclock-change} will tell Emacs that the | 1595 | timeclock-out} or @kbd{M-x timeclock-change} will tell Emacs that the |
| 1595 | current interval is over. | 1596 | current interval is over. |
| 1596 | 1597 | ||
diff --git a/man/mh-e.texi b/man/mh-e.texi index df0595a5c70..be1d61d930c 100644 --- a/man/mh-e.texi +++ b/man/mh-e.texi | |||
| @@ -9,10 +9,10 @@ | |||
| 9 | 9 | ||
| 10 | @c Version of the software and manual. | 10 | @c Version of the software and manual. |
| 11 | @set VERSION 7.93 | 11 | @set VERSION 7.93 |
| 12 | @c EDITION of the manual. It is either empty for the first edition or | 12 | @c Edition of the manual. It is either empty for the first edition or |
| 13 | @c has the form ", nth Edition" (without the quotes). | 13 | @c has the form ", nth Edition" (without the quotes). |
| 14 | @set EDITION | 14 | @set EDITION , 3rd Edition |
| 15 | @set UPDATED 2006-03-05 | 15 | @set UPDATED 2006-03-14 |
| 16 | @set UPDATE-MONTH March, 2006 | 16 | @set UPDATE-MONTH March, 2006 |
| 17 | 17 | ||
| 18 | @c Other variables. | 18 | @c Other variables. |
| @@ -203,6 +203,7 @@ History of MH-E | |||
| 203 | 203 | ||
| 204 | @cindex Emacs | 204 | @cindex Emacs |
| 205 | @cindex Unix commands, Emacs | 205 | @cindex Unix commands, Emacs |
| 206 | @cindex preface | ||
| 206 | 207 | ||
| 207 | This manual introduces another interface to the MH mail system that is | 208 | This manual introduces another interface to the MH mail system that is |
| 208 | accessible through the GNU Emacs editor, namely, @emph{MH-E}. MH-E is | 209 | accessible through the GNU Emacs editor, namely, @emph{MH-E}. MH-E is |
| @@ -218,8 +219,11 @@ in GNU Emacs 21, as well as XEmacs 21 (except for versions | |||
| 218 | 21.5.9-21.5.16). It is compatible with MH versions 6.8.4 and higher, | 219 | 21.5.9-21.5.16). It is compatible with MH versions 6.8.4 and higher, |
| 219 | all versions of nmh, and GNU mailutils 0.4 and higher.}, so you | 220 | all versions of nmh, and GNU mailutils 0.4 and higher.}, so you |
| 220 | shouldn't have to do anything special to use it. This manual covers | 221 | shouldn't have to do anything special to use it. This manual covers |
| 221 | MH-E version @value{VERSION}. @ref{Getting Started} will help you | 222 | MH-E version @value{VERSION}. To help you decide which version you |
| 222 | decide which version you have. | 223 | have, see @ref{Getting Started}. |
| 224 | |||
| 225 | @findex help-with-tutorial | ||
| 226 | @kindex C-h t | ||
| 223 | 227 | ||
| 224 | If you don't already use GNU Emacs but want to learn more, you can | 228 | If you don't already use GNU Emacs but want to learn more, you can |
| 225 | read an online tutorial by starting GNU Emacs and typing @kbd{C-h t} | 229 | read an online tutorial by starting GNU Emacs and typing @kbd{C-h t} |
| @@ -241,10 +245,13 @@ If more information is needed, you can go to the Unix manual pages of | |||
| 241 | the individual MH commands. When the name is not obvious, I'll guide | 245 | the individual MH commands. When the name is not obvious, I'll guide |
| 242 | you to a relevant MH manual page that describes the action more fully. | 246 | you to a relevant MH manual page that describes the action more fully. |
| 243 | 247 | ||
| 248 | @cindex info | ||
| 249 | @kindex C-h i | ||
| 250 | |||
| 244 | This manual is available in both Info and online formats. The Info | 251 | This manual is available in both Info and online formats. The Info |
| 245 | version is distributed with Emacs and can be accessed with the | 252 | version is distributed with Emacs and can be accessed with the |
| 246 | @command{info} command (@samp{info mh-e}) or within Emacs (@kbd{M-x | 253 | @command{info} command (@samp{info mh-e}) or within Emacs (@kbd{C-h i |
| 247 | info @key{RET} m mh-e @key{RET}}). The online version is available at | 254 | m mh-e @key{RET}}). The online version is available at |
| 248 | @uref{http://mh-e.sourceforge.net/manual/, SourceForge}. Another great | 255 | @uref{http://mh-e.sourceforge.net/manual/, SourceForge}. Another great |
| 249 | online resource is the book @uref{http://www.ics.uci.edu/~mh/book/, | 256 | online resource is the book @uref{http://www.ics.uci.edu/~mh/book/, |
| 250 | @cite{MH & nmh: Email for Users & Programmers}} (also known as | 257 | @cite{MH & nmh: Email for Users & Programmers}} (also known as |
| @@ -265,8 +272,11 @@ Bill Wohler <@i{wohler at newt.com}>@* | |||
| 265 | @chapter GNU Emacs Terms and Conventions | 272 | @chapter GNU Emacs Terms and Conventions |
| 266 | 273 | ||
| 267 | @cindex Emacs | 274 | @cindex Emacs |
| 268 | @cindex Emacs, terms and conventions | 275 | @cindex Emacs, conventions |
| 276 | @cindex Emacs, terms | ||
| 269 | @cindex Unix commands, Emacs | 277 | @cindex Unix commands, Emacs |
| 278 | @cindex conventions, Emacs | ||
| 279 | @cindex terms, Emacs | ||
| 270 | 280 | ||
| 271 | If you're an experienced Emacs user, you can skip the following | 281 | If you're an experienced Emacs user, you can skip the following |
| 272 | conventions and definition of terms and go directly to the next | 282 | conventions and definition of terms and go directly to the next |
| @@ -325,6 +335,7 @@ earlier of Emacs, you will need to use the @key{DEL} key.}. | |||
| 325 | 335 | ||
| 326 | @cindex Emacs, prefix argument | 336 | @cindex Emacs, prefix argument |
| 327 | @cindex prefix argument | 337 | @cindex prefix argument |
| 338 | @kindex C-u | ||
| 328 | 339 | ||
| 329 | A @dfn{prefix argument} allows you to pass an argument to any Emacs | 340 | A @dfn{prefix argument} allows you to pass an argument to any Emacs |
| 330 | function. To pass an argument, type @kbd{C-u} before the Emacs command | 341 | function. To pass an argument, type @kbd{C-u} before the Emacs command |
| @@ -348,8 +359,11 @@ numerical argument before entering the command. | |||
| 348 | @end quotation | 359 | @end quotation |
| 349 | @sp 1 | 360 | @sp 1 |
| 350 | 361 | ||
| 362 | @cindex @file{.emacs} | ||
| 351 | @cindex Emacs, variables | 363 | @cindex Emacs, variables |
| 364 | @cindex files, @file{.emacs} | ||
| 352 | @cindex variables | 365 | @cindex variables |
| 366 | @findex setq | ||
| 353 | 367 | ||
| 354 | Emacs uses @dfn{variables} to hold values. These can be changed via | 368 | Emacs uses @dfn{variables} to hold values. These can be changed via |
| 355 | calls to the function @code{setq} in @file{~/.emacs}. | 369 | calls to the function @code{setq} in @file{~/.emacs}. |
| @@ -392,9 +406,11 @@ See section | |||
| 392 | Face Customization} in @cite{The GNU Emacs Manual}. | 406 | Face Customization} in @cite{The GNU Emacs Manual}. |
| 393 | @end ifhtml | 407 | @end ifhtml |
| 394 | 408 | ||
| 409 | @cindex abnormal hooks | ||
| 395 | @cindex hooks | 410 | @cindex hooks |
| 396 | @cindex normal hooks | 411 | @cindex normal hooks |
| 397 | @cindex abnormal hooks | 412 | @findex add-hook |
| 413 | @findex customize-option | ||
| 398 | 414 | ||
| 399 | Commands often offer @dfn{hooks} which enable you to extend or modify | 415 | Commands often offer @dfn{hooks} which enable you to extend or modify |
| 400 | the way a command works. | 416 | the way a command works. |
| @@ -409,10 +425,11 @@ Hooks} in @cite{The GNU Emacs Manual} | |||
| 409 | @end ifhtml | 425 | @end ifhtml |
| 410 | for a description about @dfn{normal hooks} and @dfn{abnormal hooks}. | 426 | for a description about @dfn{normal hooks} and @dfn{abnormal hooks}. |
| 411 | MH-E uses normal hooks in nearly all cases, so you can assume that we | 427 | MH-E uses normal hooks in nearly all cases, so you can assume that we |
| 412 | are talking about normal hooks unless we explicitly mention that a hook | 428 | are talking about normal hooks unless we explicitly mention that a |
| 413 | is abnormal. We also follow the conventions described in that section: | 429 | hook is abnormal. We also follow the conventions described in that |
| 414 | the name of the abnormal hooks end in @code{-hooks} and all the rest | 430 | section: the name of the abnormal hooks end in @code{-hooks} and all |
| 415 | of the MH-E hooks end in @code{-hook}. | 431 | the rest of the MH-E hooks end in @code{-hook}. You can add hooks with |
| 432 | either @code{customize-option} or @code{add-hook}. | ||
| 416 | 433 | ||
| 417 | @cindex Emacs, mark | 434 | @cindex Emacs, mark |
| 418 | @cindex Emacs, point | 435 | @cindex Emacs, point |
| @@ -420,6 +437,8 @@ of the MH-E hooks end in @code{-hook}. | |||
| 420 | @cindex mark | 437 | @cindex mark |
| 421 | @cindex point | 438 | @cindex point |
| 422 | @cindex region | 439 | @cindex region |
| 440 | @kindex C-@@ | ||
| 441 | @kindex C-@key{SPC} | ||
| 423 | 442 | ||
| 424 | There are several other terms that are used in Emacs that you should | 443 | There are several other terms that are used in Emacs that you should |
| 425 | know. The @dfn{point} is where the cursor currently is. You can save | 444 | know. The @dfn{point} is where the cursor currently is. You can save |
| @@ -430,14 +449,16 @@ commands operate on regions, such as those for deleting text or | |||
| 430 | filling paragraphs. A mark can be set with @kbd{C-@@} (or | 449 | filling paragraphs. A mark can be set with @kbd{C-@@} (or |
| 431 | @kbd{C-@key{SPC}}). | 450 | @kbd{C-@key{SPC}}). |
| 432 | 451 | ||
| 452 | @cindex completion | ||
| 433 | @cindex Emacs, completion | 453 | @cindex Emacs, completion |
| 434 | @cindex Emacs, file completion | 454 | @cindex Emacs, file completion |
| 435 | @cindex Emacs, folder completion | 455 | @cindex Emacs, folder completion |
| 436 | @cindex Emacs, minibuffer | 456 | @cindex Emacs, minibuffer |
| 437 | @cindex completion | ||
| 438 | @cindex file completion | 457 | @cindex file completion |
| 439 | @cindex folder completion | 458 | @cindex folder completion |
| 440 | @cindex minibuffer | 459 | @cindex minibuffer |
| 460 | @kindex SPC | ||
| 461 | @kindex TAB | ||
| 441 | 462 | ||
| 442 | The @dfn{minibuffer} is the bottom line of the Emacs window, where all | 463 | The @dfn{minibuffer} is the bottom line of the Emacs window, where all |
| 443 | prompting and multiple-character input is directed. You can use | 464 | prompting and multiple-character input is directed. You can use |
| @@ -456,6 +477,10 @@ Completion} in @cite{The GNU Emacs Manual}. | |||
| 456 | Note that @key{SPC} cannot be used for completing filenames and | 477 | Note that @key{SPC} cannot be used for completing filenames and |
| 457 | folders. | 478 | folders. |
| 458 | 479 | ||
| 480 | @findex help-with-tutorial | ||
| 481 | @kindex C-h t | ||
| 482 | @kindex M-x | ||
| 483 | |||
| 459 | The minibuffer is also where you enter Emacs function names after | 484 | The minibuffer is also where you enter Emacs function names after |
| 460 | typing @kbd{M-x}. For example, in the preface, I mentioned that you | 485 | typing @kbd{M-x}. For example, in the preface, I mentioned that you |
| 461 | could obtain help with @kbd{C-h t} (@code{help-with-tutorial}). What | 486 | could obtain help with @kbd{C-h t} (@code{help-with-tutorial}). What |
| @@ -518,6 +543,14 @@ message, @samp{Cannot find the commands `inc' and `mhl' and the file | |||
| 518 | MH-E, and you may need to install MH too. However, newer versions of | 543 | MH-E, and you may need to install MH too. However, newer versions of |
| 519 | MH-E are better at finding MH if it is on your system.}. | 544 | MH-E are better at finding MH if it is on your system.}. |
| 520 | 545 | ||
| 546 | @cindex @command{mhparam} | ||
| 547 | @cindex MH commands, @command{mhparam} | ||
| 548 | @vindex exec-path | ||
| 549 | @vindex mh-path | ||
| 550 | @vindex mh-sys-path | ||
| 551 | @vindex mh-variant | ||
| 552 | @vindex mh-variant-in-use | ||
| 553 | |||
| 521 | The option @code{mh-variant} specifies the variant used by MH-E | 554 | The option @code{mh-variant} specifies the variant used by MH-E |
| 522 | (@pxref{Options}). The default setting of this option is | 555 | (@pxref{Options}). The default setting of this option is |
| 523 | @samp{Auto-detect} which means that MH-E will automatically choose the | 556 | @samp{Auto-detect} which means that MH-E will automatically choose the |
| @@ -525,15 +558,23 @@ first of nmh, MH, or GNU mailutils that it finds in the directories | |||
| 525 | listed in @code{mh-path} (which you can customize), | 558 | listed in @code{mh-path} (which you can customize), |
| 526 | @code{mh-sys-path}, and @code{exec-path}. If MH-E can't find MH at | 559 | @code{mh-sys-path}, and @code{exec-path}. If MH-E can't find MH at |
| 527 | all, you may have to customize @code{mh-path} and add the directory in | 560 | all, you may have to customize @code{mh-path} and add the directory in |
| 528 | which the command @code{mhparam} is located. If, on the other hand, | 561 | which the command @command{mhparam} is located. If, on the other hand, |
| 529 | you have both nmh and mailutils installed (for example) and | 562 | you have both nmh and mailutils installed (for example) and |
| 530 | @code{mh-variant-in-use} was initialized to nmh but you want to use | 563 | @code{mh-variant-in-use} was initialized to nmh but you want to use |
| 531 | mailutils, then you can set @code{mh-variant} to @samp{mailutils}. | 564 | mailutils, then you can set @code{mh-variant} to @samp{mailutils}. |
| 532 | 565 | ||
| 566 | @vindex mh-flists-present-flag | ||
| 567 | @vindex mh-lib | ||
| 568 | @vindex mh-lib-progs | ||
| 569 | @vindex mh-progs | ||
| 570 | |||
| 533 | When @code{mh-variant} is changed, MH-E resets @code{mh-progs}, | 571 | When @code{mh-variant} is changed, MH-E resets @code{mh-progs}, |
| 534 | @code{mh-lib}, @code{mh-lib-progs}, @code{mh-flists-present-flag}, and | 572 | @code{mh-lib}, @code{mh-lib-progs}, @code{mh-flists-present-flag}, and |
| 535 | @code{mh-variant-in-use} accordingly. | 573 | @code{mh-variant-in-use} accordingly. |
| 536 | 574 | ||
| 575 | @cindex @file{.emacs} | ||
| 576 | @cindex files, @file{.emacs} | ||
| 577 | |||
| 537 | @sp 1 | 578 | @sp 1 |
| 538 | @center @strong{NOTE} | 579 | @center @strong{NOTE} |
| 539 | 580 | ||
| @@ -554,14 +595,25 @@ environment@footnote{See the section | |||
| 554 | If you don't, you'll be greeted with the error message: @samp{Install | 595 | If you don't, you'll be greeted with the error message: @samp{Install |
| 555 | MH and run install-mh before running MH-E}. | 596 | MH and run install-mh before running MH-E}. |
| 556 | 597 | ||
| 557 | @cindex @samp{Draft-Folder:} MH profile component | ||
| 558 | @cindex @samp{Path:} MH profile component | 598 | @cindex @samp{Path:} MH profile component |
| 559 | @cindex @samp{Previous-Sequence:} MH profile component | 599 | @cindex MH profile |
| 560 | @cindex @samp{Unseen-Sequence:} MH profile component | 600 | @cindex MH profile component |
| 601 | @cindex MH profile component, @samp{Path:} | ||
| 602 | |||
| 603 | Your MH environment includes your @dfn{MH profile} which is found in | ||
| 604 | the file @file{~/.mh_profile}. This file contains a number of @dfn{MH | ||
| 605 | profile components}. For example, the @samp{Path:} MH profile | ||
| 606 | component contains the path to your mail directory, which is | ||
| 607 | @file{~/Mail} by default. | ||
| 608 | |||
| 561 | @cindex MH profile component, @samp{Draft-Folder:} | 609 | @cindex MH profile component, @samp{Draft-Folder:} |
| 562 | @cindex MH profile component, @samp{Path:} | 610 | @cindex MH profile component, @samp{Path:} |
| 563 | @cindex MH profile component, @samp{Previous-Sequence:} | 611 | @cindex MH profile component, @samp{Previous-Sequence:} |
| 564 | @cindex MH profile component, @samp{Unseen-Sequence:} | 612 | @cindex MH profile component, @samp{Unseen-Sequence:} |
| 613 | @cindex @samp{Draft-Folder:} MH profile component | ||
| 614 | @cindex @samp{Path:} MH profile component | ||
| 615 | @cindex @samp{Previous-Sequence:} MH profile component | ||
| 616 | @cindex @samp{Unseen-Sequence:} MH profile component | ||
| 565 | @findex mh-find-path | 617 | @findex mh-find-path |
| 566 | @vindex mh-draft-folder | 618 | @vindex mh-draft-folder |
| 567 | @vindex mh-find-path-hook | 619 | @vindex mh-find-path-hook |
| @@ -586,6 +638,10 @@ between MH and MH-E. | |||
| 586 | @node Tour Through MH-E, Using This Manual, Getting Started, Top | 638 | @node Tour Through MH-E, Using This Manual, Getting Started, Top |
| 587 | @chapter Tour Through MH-E | 639 | @chapter Tour Through MH-E |
| 588 | 640 | ||
| 641 | @cindex introduction | ||
| 642 | @cindex tour | ||
| 643 | @cindex tutorial | ||
| 644 | |||
| 589 | This chapter introduces some of the terms you'll need to know and then | 645 | This chapter introduces some of the terms you'll need to know and then |
| 590 | takes you on a tour of MH-E@footnote{The keys mentioned in these | 646 | takes you on a tour of MH-E@footnote{The keys mentioned in these |
| 591 | chapters refer to the default key bindings. If you've changed the | 647 | chapters refer to the default key bindings. If you've changed the |
| @@ -610,6 +666,7 @@ get the big picture, and then you can read the manual as you wish. | |||
| 610 | 666 | ||
| 611 | @cindex sending mail | 667 | @cindex sending mail |
| 612 | @findex mh-smail | 668 | @findex mh-smail |
| 669 | @kindex M-x mh-smail | ||
| 613 | 670 | ||
| 614 | Let's start our tour by sending ourselves a message which we can later | 671 | Let's start our tour by sending ourselves a message which we can later |
| 615 | read and process. Enter @kbd{M-x mh-smail} to invoke the MH-E program | 672 | read and process. Enter @kbd{M-x mh-smail} to invoke the MH-E program |
| @@ -660,7 +717,10 @@ present or the body of your message will be considered to be part of | |||
| 660 | the header. | 717 | the header. |
| 661 | 718 | ||
| 662 | @cindex help | 719 | @cindex help |
| 720 | @findex describe-mode | ||
| 721 | @kindex C-c ? | ||
| 663 | @kindex C-c C-c | 722 | @kindex C-c C-c |
| 723 | @kindex C-h m | ||
| 664 | 724 | ||
| 665 | There are several commands specific to MH-Letter mode@footnote{You can | 725 | There are several commands specific to MH-Letter mode@footnote{You can |
| 666 | get quick help for the commands used most often with @kbd{C-c ?} or | 726 | get quick help for the commands used most often with @kbd{C-c ?} or |
| @@ -679,6 +739,7 @@ message. Type @kbd{C-c C-c} now. That's all there is to it! | |||
| 679 | @cindex modes, MH-Folder | 739 | @cindex modes, MH-Folder |
| 680 | @cindex reading mail | 740 | @cindex reading mail |
| 681 | @findex mh-rmail | 741 | @findex mh-rmail |
| 742 | @kindex M-x mh-rmail | ||
| 682 | 743 | ||
| 683 | To read the mail you've just sent yourself, enter @kbd{M-x mh-rmail}. | 744 | To read the mail you've just sent yourself, enter @kbd{M-x mh-rmail}. |
| 684 | This incorporates the new mail and puts the output from | 745 | This incorporates the new mail and puts the output from |
| @@ -691,10 +752,15 @@ pick Ranges Sequences} in the MH book.} which prints a one-line | |||
| 691 | summary of each message) into a buffer called @samp{+inbox} whose | 752 | summary of each message) into a buffer called @samp{+inbox} whose |
| 692 | major mode is MH-Folder. | 753 | major mode is MH-Folder. |
| 693 | 754 | ||
| 755 | @findex mh-rmail | ||
| 756 | @kindex F r | ||
| 757 | @kindex M-x mh-rmail | ||
| 758 | |||
| 694 | @sp 1 | 759 | @sp 1 |
| 695 | @center @strong{NOTE} | 760 | @center @strong{NOTE} |
| 696 | 761 | ||
| 697 | @quotation | 762 | @quotation |
| 763 | |||
| 698 | The @kbd{M-x mh-rmail} command will show you only new mail, not mail | 764 | The @kbd{M-x mh-rmail} command will show you only new mail, not mail |
| 699 | you have already read. If you were to run this tour again, you would | 765 | you have already read. If you were to run this tour again, you would |
| 700 | use @kbd{F r} to pull all your messages into MH-E. | 766 | use @kbd{F r} to pull all your messages into MH-E. |
| @@ -742,6 +808,7 @@ If you typed a long message, you can view subsequent pages with | |||
| 742 | @section Processing Mail | 808 | @section Processing Mail |
| 743 | 809 | ||
| 744 | @cindex processing mail | 810 | @cindex processing mail |
| 811 | @kindex @key{RET} | ||
| 745 | @kindex r | 812 | @kindex r |
| 746 | 813 | ||
| 747 | The first thing we want to do is reply to the message that we sent | 814 | The first thing we want to do is reply to the message that we sent |
| @@ -778,8 +845,17 @@ Composing a reply...done | |||
| 778 | @end cartouche | 845 | @end cartouche |
| 779 | @i{Composition window during reply} | 846 | @i{Composition window during reply} |
| 780 | 847 | ||
| 848 | @findex backward-char | ||
| 849 | @findex forward-char | ||
| 850 | @findex next-line | ||
| 851 | @findex previous-line | ||
| 852 | @kindex C-b | ||
| 781 | @kindex C-c C-c | 853 | @kindex C-c C-c |
| 782 | @kindex C-c C-f C-t | 854 | @kindex C-c C-f C-t |
| 855 | @kindex C-f | ||
| 856 | @kindex C-n | ||
| 857 | @kindex C-p | ||
| 858 | @kindex @key{BS} | ||
| 783 | 859 | ||
| 784 | By default, MH will not add you to the address list of your replies, | 860 | By default, MH will not add you to the address list of your replies, |
| 785 | so if you find that the @samp{To:} header field is missing, don't | 861 | so if you find that the @samp{To:} header field is missing, don't |
| @@ -791,7 +867,10 @@ move around with the arrow keys or with @kbd{C-p} | |||
| 791 | delete the previous character with @key{BS}. When you're finished | 867 | delete the previous character with @key{BS}. When you're finished |
| 792 | editing your message, send it with @kbd{C-c C-c} as before. | 868 | editing your message, send it with @kbd{C-c C-c} as before. |
| 793 | 869 | ||
| 870 | @cindex @command{refile} | ||
| 871 | @cindex MH commands, @command{refile} | ||
| 794 | @cindex folders | 872 | @cindex folders |
| 873 | @kindex @key{SPC} | ||
| 795 | @kindex o | 874 | @kindex o |
| 796 | 875 | ||
| 797 | You'll often want to save messages that were sent to you in an | 876 | You'll often want to save messages that were sent to you in an |
| @@ -809,9 +888,11 @@ in a moment. | |||
| 809 | 888 | ||
| 810 | @cindex MH-Folder mode | 889 | @cindex MH-Folder mode |
| 811 | @cindex modes, MH-Folder | 890 | @cindex modes, MH-Folder |
| 812 | @kindex @key{RET} | ||
| 813 | @kindex d | 891 | @kindex d |
| 814 | @kindex i | 892 | @kindex i |
| 893 | @kindex @key{RET} | ||
| 894 | @kindex n | ||
| 895 | @kindex p | ||
| 815 | @kindex x | 896 | @kindex x |
| 816 | 897 | ||
| 817 | Your previous reply is now waiting in the system mailbox. You | 898 | Your previous reply is now waiting in the system mailbox. You |
| @@ -826,6 +907,7 @@ command. | |||
| 826 | 907 | ||
| 827 | @findex mh-smail | 908 | @findex mh-smail |
| 828 | @kindex m | 909 | @kindex m |
| 910 | @kindex M-x mh-smail | ||
| 829 | 911 | ||
| 830 | If you want to send another message you can use @kbd{m} instead of | 912 | If you want to send another message you can use @kbd{m} instead of |
| 831 | @kbd{M-x mh-smail}. So go ahead, send some mail to your friends! | 913 | @kbd{M-x mh-smail}. So go ahead, send some mail to your friends! |
| @@ -835,6 +917,7 @@ If you want to send another message you can use @kbd{m} instead of | |||
| 835 | @findex describe-mode | 917 | @findex describe-mode |
| 836 | @kindex ? | 918 | @kindex ? |
| 837 | @kindex C-h m | 919 | @kindex C-h m |
| 920 | @kindex F ? | ||
| 838 | 921 | ||
| 839 | You can get a quick reminder about these commands by typing @kbd{?}. | 922 | You can get a quick reminder about these commands by typing @kbd{?}. |
| 840 | This lists several @dfn{prefix characters}. To list the commands | 923 | This lists several @dfn{prefix characters}. To list the commands |
| @@ -847,6 +930,8 @@ available with the @kbd{C-h m} (@code{describe-mode}) command. | |||
| 847 | 930 | ||
| 848 | @cindex Emacs, quitting | 931 | @cindex Emacs, quitting |
| 849 | @cindex quitting | 932 | @cindex quitting |
| 933 | @kindex C-x C-c | ||
| 934 | @kindex x | ||
| 850 | 935 | ||
| 851 | You may now wish to exit @command{emacs} entirely. Use @kbd{C-x C-c} | 936 | You may now wish to exit @command{emacs} entirely. Use @kbd{C-x C-c} |
| 852 | to exit @command{emacs}. If you exited without running @kbd{x} in the | 937 | to exit @command{emacs}. If you exited without running @kbd{x} in the |
| @@ -855,6 +940,9 @@ to exit @command{emacs}. If you exited without running @kbd{x} in the | |||
| 855 | perform any refiles and deletes that you did there. | 940 | perform any refiles and deletes that you did there. |
| 856 | 941 | ||
| 857 | @findex mh-rmail | 942 | @findex mh-rmail |
| 943 | @kindex C-x b | ||
| 944 | @kindex C-x k | ||
| 945 | @kindex M-x mh-rmail | ||
| 858 | @kindex q | 946 | @kindex q |
| 859 | 947 | ||
| 860 | If you don't want to leave Emacs, you can type @kbd{q} to bury (hide) | 948 | If you don't want to leave Emacs, you can type @kbd{q} to bury (hide) |
| @@ -886,57 +974,58 @@ to find out how you can: | |||
| 886 | 974 | ||
| 887 | @itemize @bullet | 975 | @itemize @bullet |
| 888 | @item | 976 | @item |
| 889 | Print your messages (@ref{Printing}). | 977 | Print your messages (@pxref{Printing}). |
| 890 | @c ------------------------- | 978 | @c ------------------------- |
| 891 | @item | 979 | @item |
| 892 | Edit messages and include your signature (@ref{Editing Drafts}). | 980 | Edit messages and include your signature (@pxref{Editing Drafts}). |
| 893 | @c ------------------------- | 981 | @c ------------------------- |
| 894 | @item | 982 | @item |
| 895 | Forward messages (@ref{Forwarding}). | 983 | Forward messages (@pxref{Forwarding}). |
| 896 | @c ------------------------- | 984 | @c ------------------------- |
| 897 | @item | 985 | @item |
| 898 | Read digests (@ref{Digests}). | 986 | Read digests (@pxref{Digests}). |
| 899 | @c ------------------------- | 987 | @c ------------------------- |
| 900 | @item | 988 | @item |
| 901 | Edit bounced messages (@ref{Editing Again}). | 989 | Edit bounced messages (@pxref{Editing Again}). |
| 902 | @c ------------------------- | 990 | @c ------------------------- |
| 903 | @item | 991 | @item |
| 904 | Send multimedia messages (@ref{Adding Attachments}). | 992 | Send multimedia messages (@pxref{Adding Attachments}). |
| 905 | @c ------------------------- | 993 | @c ------------------------- |
| 906 | @item | 994 | @item |
| 907 | Read HTML messages (@ref{HTML}). | 995 | Read HTML messages (@pxref{HTML}). |
| 908 | @c ------------------------- | 996 | @c ------------------------- |
| 909 | @item | 997 | @item |
| 910 | Use @ref{Aliases} and @ref{Identities}. | 998 | Use aliases and identities (see @ref{Aliases}, @pxref{Identities}). |
| 911 | @c ------------------------- | 999 | @c ------------------------- |
| 912 | @item | 1000 | @item |
| 913 | Create different views of your mail (@ref{Threading} and @ref{Limits}). | 1001 | Create different views of your mail (see @ref{Threading}, @pxref{Limits}). |
| 914 | @c ------------------------- | 1002 | @c ------------------------- |
| 915 | @item | 1003 | @item |
| 916 | Deal with junk mail (@ref{Junk}). | 1004 | Deal with junk mail (@pxref{Junk}). |
| 917 | @c ------------------------- | 1005 | @c ------------------------- |
| 918 | @item | 1006 | @item |
| 919 | Handle signed and encrypted messages (@ref{Reading PGP} and | 1007 | Handle signed and encrypted messages (see @ref{Reading PGP}, |
| 920 | @ref{Sending PGP}). | 1008 | @pxref{Sending PGP}). |
| 921 | @c ------------------------- | 1009 | @c ------------------------- |
| 922 | @item | 1010 | @item |
| 923 | Process mail that was sent with @command{shar} or @command{uuencode} | 1011 | Process mail that was sent with @command{shar} or @command{uuencode} |
| 924 | (@ref{Files and Pipes}). | 1012 | (@pxref{Files and Pipes}). |
| 925 | @c ------------------------- | 1013 | @c ------------------------- |
| 926 | @item | 1014 | @item |
| 927 | Use sequences conveniently (@ref{Sequences}). | 1015 | Use sequences conveniently (@pxref{Sequences}). |
| 928 | @c ------------------------- | 1016 | @c ------------------------- |
| 929 | @item | 1017 | @item |
| 930 | Use the @ref{Speedbar}, @ref{Tool Bar}, and @ref{Menu Bar}. | 1018 | Use the speedbar, tool bar, and menu bar (see @ref{Speedbar}, see @ref{Tool |
| 1019 | Bar}, @pxref{Menu Bar}). | ||
| 931 | @c ------------------------- | 1020 | @c ------------------------- |
| 932 | @item | 1021 | @item |
| 933 | Show header fields in different fonts (@ref{Reading Mail}). | 1022 | Show header fields in different fonts (@pxref{Reading Mail}). |
| 934 | @c ------------------------- | 1023 | @c ------------------------- |
| 935 | @item | 1024 | @item |
| 936 | Find previously refiled messages (@ref{Searching}). | 1025 | Find previously refiled messages (@pxref{Searching}). |
| 937 | @c ------------------------- | 1026 | @c ------------------------- |
| 938 | @item | 1027 | @item |
| 939 | Place messages in a file (@ref{Files and Pipes}). | 1028 | Place messages in a file (@pxref{Files and Pipes}). |
| 940 | @end itemize | 1029 | @end itemize |
| 941 | 1030 | ||
| 942 | Remember that you can also use MH commands when you're not running | 1031 | Remember that you can also use MH commands when you're not running |
| @@ -956,6 +1045,10 @@ about every MH-E command and option. | |||
| 956 | @findex mh-help | 1045 | @findex mh-help |
| 957 | @kindex ? | 1046 | @kindex ? |
| 958 | @kindex C-c ? | 1047 | @kindex C-c ? |
| 1048 | @kindex C-h C-h | ||
| 1049 | @kindex C-h C-k i | ||
| 1050 | @kindex C-h i | ||
| 1051 | @kindex C-h m | ||
| 959 | 1052 | ||
| 960 | There are many commands, but don't get intimidated. There are command | 1053 | There are many commands, but don't get intimidated. There are command |
| 961 | summaries at the beginning of each chapter. In case you have or would | 1054 | summaries at the beginning of each chapter. In case you have or would |
| @@ -986,7 +1079,8 @@ possible. That way you will get the same behavior inside and outside | |||
| 986 | GNU Emacs. Note that MH-E does not provide hooks for customizations | 1079 | GNU Emacs. Note that MH-E does not provide hooks for customizations |
| 987 | that can be done in MH; this omission is intentional. | 1080 | that can be done in MH; this omission is intentional. |
| 988 | 1081 | ||
| 989 | @cindex Emacs, Emacs Lisp manual | 1082 | @cindex Emacs Lisp Manual |
| 1083 | @cindex Emacs, Emacs Lisp Manual | ||
| 990 | @cindex Emacs, info | 1084 | @cindex Emacs, info |
| 991 | @cindex Emacs, online help | 1085 | @cindex Emacs, online help |
| 992 | @cindex info | 1086 | @cindex info |
| @@ -1065,8 +1159,15 @@ mh-lpr-command-format @key{RET}}. In the buffer that appears, modify | |||
| 1065 | the string to the right of the variable. For example, you may change | 1159 | the string to the right of the variable. For example, you may change |
| 1066 | the @command{lpr} command with @samp{nenscript -G -r -2 -i'%s'}. Then | 1160 | the @command{lpr} command with @samp{nenscript -G -r -2 -i'%s'}. Then |
| 1067 | use the @samp{State} combo box and select @samp{Save for Future | 1161 | use the @samp{State} combo box and select @samp{Save for Future |
| 1068 | Sessions}. @ref{Printing} talks more about this option. | 1162 | Sessions}. To read more about @code{mh-lpr-command-format}, see |
| 1069 | 1163 | @ref{Printing}. | |
| 1164 | |||
| 1165 | @cindex nil | ||
| 1166 | @cindex off, option | ||
| 1167 | @cindex on, option | ||
| 1168 | @cindex option, turning on and off | ||
| 1169 | @cindex t | ||
| 1170 | @findex customize-option | ||
| 1070 | @vindex mh-bury-show-buffer-flag, example | 1171 | @vindex mh-bury-show-buffer-flag, example |
| 1071 | 1172 | ||
| 1072 | Options can also hold boolean values. In Emacs Lisp, the boolean | 1173 | Options can also hold boolean values. In Emacs Lisp, the boolean |
| @@ -1082,14 +1183,16 @@ the @samp{Erase Customization} menu item to reset the option to the | |||
| 1082 | default, which places the MH-Show buffer at the bottom of the buffer | 1183 | default, which places the MH-Show buffer at the bottom of the buffer |
| 1083 | stack. | 1184 | stack. |
| 1084 | 1185 | ||
| 1186 | @vindex mh-mhl-format-file, example | ||
| 1187 | |||
| 1085 | The text usually says to turn on an option by setting it to a | 1188 | The text usually says to turn on an option by setting it to a |
| 1086 | @emph{non-@code{nil}} value, because sometimes values other than | 1189 | @emph{non-@code{nil}} value, because sometimes values other than |
| 1087 | @samp{on} are meaningful (for example, see @code{mh-mhl-format-file}, | 1190 | @samp{on} are meaningful. An example of this is the variable |
| 1088 | described in @ref{Viewing}). Other options, such as hooks, involve a | 1191 | @code{mh-mhl-format-file} (@pxref{Viewing}). Other options, such as |
| 1089 | little more Emacs Lisp programming expertise. | 1192 | hooks, involve a little more Emacs Lisp programming expertise. |
| 1090 | 1193 | ||
| 1091 | @cindex @samp{mh} customization group | ||
| 1092 | @cindex customization group, @samp{mh} | 1194 | @cindex customization group, @samp{mh} |
| 1195 | @cindex @samp{mh} customization group | ||
| 1093 | @findex customize-group | 1196 | @findex customize-group |
| 1094 | @findex mh-customize | 1197 | @findex mh-customize |
| 1095 | 1198 | ||
| @@ -1104,14 +1207,16 @@ customization group is to use @kbd{M-x mh-customize @key{RET}}. | |||
| 1104 | 1207 | ||
| 1105 | @c Sync with mh-folder-mode docstring. | 1208 | @c Sync with mh-folder-mode docstring. |
| 1106 | 1209 | ||
| 1107 | @cindex ranges | ||
| 1108 | @cindex message abbreviations | 1210 | @cindex message abbreviations |
| 1109 | @cindex message ranges | 1211 | @cindex message ranges |
| 1212 | @cindex ranges | ||
| 1110 | 1213 | ||
| 1111 | Many commands that operate on individual messages, such as | 1214 | Many commands that operate on individual messages, such as |
| 1112 | @code{mh-forward} or @code{mh-refile-msg} take a @code{RANGE} | 1215 | @code{mh-forward} or @code{mh-refile-msg} take a @code{RANGE} |
| 1113 | argument. This argument can be used in several ways. | 1216 | argument. This argument can be used in several ways. |
| 1114 | 1217 | ||
| 1218 | @kindex C-u, with ranges | ||
| 1219 | |||
| 1115 | If you provide the prefix argument @kbd{C-u} to these commands, then | 1220 | If you provide the prefix argument @kbd{C-u} to these commands, then |
| 1116 | you will be prompted for the message range. This can be any valid MH | 1221 | you will be prompted for the message range. This can be any valid MH |
| 1117 | range which can include messages, sequences (@pxref{Sequences}), and | 1222 | range which can include messages, sequences (@pxref{Sequences}), and |
| @@ -1143,9 +1248,9 @@ For example, a range that shows all of these things is @samp{1 2 3 | |||
| 1143 | 1248 | ||
| 1144 | @vindex transient-mark-mode | 1249 | @vindex transient-mark-mode |
| 1145 | 1250 | ||
| 1146 | If the option @code{transient-mark-mode} is set to @code{t} and you | 1251 | If the option @code{transient-mark-mode} is turned on and you set a |
| 1147 | set a region in the MH-Folder buffer, then the MH-E command will | 1252 | region in the MH-Folder buffer, then the MH-E command will perform the |
| 1148 | perform the operation on all messages in that region. | 1253 | operation on all messages in that region. |
| 1149 | 1254 | ||
| 1150 | @cindex @samp{mh-range} customization group | 1255 | @cindex @samp{mh-range} customization group |
| 1151 | @cindex customization group, @samp{mh-range} | 1256 | @cindex customization group, @samp{mh-range} |
| @@ -1158,6 +1263,8 @@ affects how ranges are interpreted. | |||
| 1158 | On means interpret a number as a range (default: @samp{on}). | 1263 | On means interpret a number as a range (default: @samp{on}). |
| 1159 | @end vtable | 1264 | @end vtable |
| 1160 | 1265 | ||
| 1266 | @vindex mh-interpret-number-as-range-flag | ||
| 1267 | |||
| 1161 | Since one of the most frequent ranges used is @samp{last:N}, MH-E will | 1268 | Since one of the most frequent ranges used is @samp{last:N}, MH-E will |
| 1162 | interpret input such as @samp{200} as @samp{last:200} if the | 1269 | interpret input such as @samp{200} as @samp{last:200} if the |
| 1163 | @code{mh-interpret-number-as-range-flag} option is on (which is the | 1270 | @code{mh-interpret-number-as-range-flag} option is on (which is the |
| @@ -1167,6 +1274,8 @@ default). If you need to scan just the message 200, then use the range | |||
| 1167 | @node Folder Selection, , Ranges, Using This Manual | 1274 | @node Folder Selection, , Ranges, Using This Manual |
| 1168 | @section Folder Selection | 1275 | @section Folder Selection |
| 1169 | 1276 | ||
| 1277 | @cindex completion, folders | ||
| 1278 | @cindex folders, completion | ||
| 1170 | @cindex folders, selecting | 1279 | @cindex folders, selecting |
| 1171 | 1280 | ||
| 1172 | When you choose a folder in MH-E via a command such as @kbd{o} | 1281 | When you choose a folder in MH-E via a command such as @kbd{o} |
| @@ -1182,8 +1291,8 @@ Completion} in @cite{The GNU Emacs Manual}). | |||
| 1182 | In addition, MH-E has several ways of choosing a suitable default so | 1291 | In addition, MH-E has several ways of choosing a suitable default so |
| 1183 | that the folder can often be selected with a single @key{RET} key. | 1292 | that the folder can often be selected with a single @key{RET} key. |
| 1184 | 1293 | ||
| 1185 | @cindex @samp{mh-folder-selection} customization group | ||
| 1186 | @cindex customization group, @samp{mh-folder-selection} | 1294 | @cindex customization group, @samp{mh-folder-selection} |
| 1295 | @cindex @samp{mh-folder-selection} customization group | ||
| 1187 | 1296 | ||
| 1188 | The @samp{mh-folder-selection} customization group contains some | 1297 | The @samp{mh-folder-selection} customization group contains some |
| 1189 | options which are used to help with this. | 1298 | options which are used to help with this. |
| @@ -1204,6 +1313,8 @@ On means guessed folder name must exist to be used (default: | |||
| 1204 | Prefix used for folder names generated from aliases (default: @code{""}). | 1313 | Prefix used for folder names generated from aliases (default: @code{""}). |
| 1205 | @end vtable | 1314 | @end vtable |
| 1206 | 1315 | ||
| 1316 | @vindex mh-default-folder-for-message-function | ||
| 1317 | |||
| 1207 | You can set the option @code{mh-default-folder-for-message-function} | 1318 | You can set the option @code{mh-default-folder-for-message-function} |
| 1208 | to a function that provides a default folder for the message to be | 1319 | to a function that provides a default folder for the message to be |
| 1209 | refiled. When this function is called, the current buffer contains the | 1320 | refiled. When this function is called, the current buffer contains the |
| @@ -1217,6 +1328,7 @@ Otherwise, the name of the destination folder is derived from the | |||
| 1217 | sender as follows: | 1328 | sender as follows: |
| 1218 | 1329 | ||
| 1219 | @enumerate | 1330 | @enumerate |
| 1331 | @vindex mh-default-folder-list | ||
| 1220 | @item | 1332 | @item |
| 1221 | The folder name associated with the first address found in the list | 1333 | The folder name associated with the first address found in the list |
| 1222 | @code{mh-default-folder-list} is used. Each element in this list | 1334 | @code{mh-default-folder-list} is used. Each element in this list |
| @@ -1224,12 +1336,15 @@ contains a @samp{Check Recipient} item. If this item is turned on, | |||
| 1224 | then the address is checked against the recipient instead of the | 1336 | then the address is checked against the recipient instead of the |
| 1225 | sender. This is useful for mailing lists. | 1337 | sender. This is useful for mailing lists. |
| 1226 | @c ------------------------- | 1338 | @c ------------------------- |
| 1339 | @vindex mh-default-folder-prefix | ||
| 1227 | @item | 1340 | @item |
| 1228 | An alias prefixed by @code{mh-default-folder-prefix} corresponding to | 1341 | An alias prefixed by @code{mh-default-folder-prefix} corresponding to |
| 1229 | the address is used. The prefix is used to prevent clutter in your | 1342 | the address is used. The prefix is used to prevent clutter in your |
| 1230 | mail directory. @xref{Aliases}. | 1343 | mail directory. @xref{Aliases}. |
| 1231 | @end enumerate | 1344 | @end enumerate |
| 1232 | 1345 | ||
| 1346 | @vindex mh-default-folder-must-exist-flag | ||
| 1347 | |||
| 1233 | If the derived folder does not exist, and | 1348 | If the derived folder does not exist, and |
| 1234 | @code{mh-default-folder-must-exist-flag} is @code{t}, then the last | 1349 | @code{mh-default-folder-must-exist-flag} is @code{t}, then the last |
| 1235 | folder name used is suggested. This is useful if you get mail from | 1350 | folder name used is suggested. This is useful if you get mail from |
| @@ -1239,7 +1354,9 @@ same project folder. | |||
| 1239 | @node Incorporating Mail, Reading Mail, Using This Manual, Top | 1354 | @node Incorporating Mail, Reading Mail, Using This Manual, Top |
| 1240 | @chapter Incorporating Your Mail | 1355 | @chapter Incorporating Your Mail |
| 1241 | 1356 | ||
| 1357 | @cindex @samp{Folder} menu | ||
| 1242 | @cindex incorporating | 1358 | @cindex incorporating |
| 1359 | @cindex menu, @samp{Folder} | ||
| 1243 | 1360 | ||
| 1244 | This chapter talks about getting mail from your system mailbox into | 1361 | This chapter talks about getting mail from your system mailbox into |
| 1245 | your MH @samp{+inbox} folder. The following command accomplishes that | 1362 | your MH @samp{+inbox} folder. The following command accomplishes that |
| @@ -1262,7 +1379,7 @@ used. | |||
| 1262 | 1379 | ||
| 1263 | @vtable @code | 1380 | @vtable @code |
| 1264 | @item mh-inc-prog | 1381 | @item mh-inc-prog |
| 1265 | Program to incorporate mail (default: @samp{"inc"}). | 1382 | Program to incorporate mail (default: @code{"inc"}). |
| 1266 | @c ------------------------- | 1383 | @c ------------------------- |
| 1267 | @item mh-inc-spool-list | 1384 | @item mh-inc-spool-list |
| 1268 | Alternate spool files (default: @code{nil}). | 1385 | Alternate spool files (default: @code{nil}). |
| @@ -1271,11 +1388,16 @@ Alternate spool files (default: @code{nil}). | |||
| 1271 | The following hook is available. | 1388 | The following hook is available. |
| 1272 | 1389 | ||
| 1273 | @vtable @code | 1390 | @vtable @code |
| 1391 | @findex mh-inc-folder | ||
| 1274 | @item mh-inc-folder-hook | 1392 | @item mh-inc-folder-hook |
| 1275 | Hook run by @samp{mh-inc-folder} after incorporating mail into a | 1393 | Hook run by @code{mh-inc-folder} after incorporating mail into a |
| 1276 | folder (default: @code{nil}). | 1394 | folder (default: @code{nil}). |
| 1277 | @end vtable | 1395 | @end vtable |
| 1278 | 1396 | ||
| 1397 | @cindex @samp{+inbox} | ||
| 1398 | @findex mh-inc-folder | ||
| 1399 | @kindex i | ||
| 1400 | |||
| 1279 | If at any time you receive new mail, incorporate the new mail into | 1401 | If at any time you receive new mail, incorporate the new mail into |
| 1280 | your @samp{+inbox} buffer with @kbd{i} (@code{mh-inc-folder}). Note | 1402 | your @samp{+inbox} buffer with @kbd{i} (@code{mh-inc-folder}). Note |
| 1281 | that @kbd{i} will display the @samp{+inbox} buffer, even if there | 1403 | that @kbd{i} will display the @samp{+inbox} buffer, even if there |
| @@ -1292,7 +1414,7 @@ example, @kbd{C-u i ~/mbox @key{RET} +tmp @key{RET}}). | |||
| 1292 | 1414 | ||
| 1293 | Emacs can notify you when you have new mail by displaying @samp{Mail} | 1415 | Emacs can notify you when you have new mail by displaying @samp{Mail} |
| 1294 | in the mode line. To enable this behavior, and to have a clock in the | 1416 | in the mode line. To enable this behavior, and to have a clock in the |
| 1295 | mode line besides, add the following to @file{~/.emacs}: | 1417 | mode line as well, add the following to @file{~/.emacs}: |
| 1296 | 1418 | ||
| 1297 | @findex display-time | 1419 | @findex display-time |
| 1298 | 1420 | ||
| @@ -1301,12 +1423,13 @@ mode line besides, add the following to @file{~/.emacs}: | |||
| 1301 | @end lisp | 1423 | @end lisp |
| 1302 | 1424 | ||
| 1303 | @cindex @command{inc} | 1425 | @cindex @command{inc} |
| 1304 | @cindex MH commands, @command{inc} | ||
| 1305 | @cindex incorporating | 1426 | @cindex incorporating |
| 1427 | @cindex MH commands, @command{inc} | ||
| 1428 | @vindex mh-inc-prog | ||
| 1306 | @vindex mh-progs | 1429 | @vindex mh-progs |
| 1307 | 1430 | ||
| 1308 | The name of the program that incorporates new mail is stored in | 1431 | The name of the program that incorporates new mail is stored in |
| 1309 | @code{mh-inc-prog}; it is @samp{"inc"} by default. This program | 1432 | @code{mh-inc-prog}; it is @code{"inc"} by default. This program |
| 1310 | generates a one-line summary for each of the new messages. Unless it | 1433 | generates a one-line summary for each of the new messages. Unless it |
| 1311 | is an absolute pathname, the file is assumed to be in the | 1434 | is an absolute pathname, the file is assumed to be in the |
| 1312 | @code{mh-progs} directory (@pxref{Getting Started}). You may also link | 1435 | @code{mh-progs} directory (@pxref{Getting Started}). You may also link |
| @@ -1317,6 +1440,8 @@ prev} and @uref{@value{MH-BOOK-HOME}/mhstr.htm, MH Format Strings} in | |||
| 1317 | the MH book). You'll then need to modify several variables | 1440 | the MH book). You'll then need to modify several variables |
| 1318 | appropriately (@pxref{Scan Line Formats}). | 1441 | appropriately (@pxref{Scan Line Formats}). |
| 1319 | 1442 | ||
| 1443 | @vindex mh-inc-spool-list | ||
| 1444 | |||
| 1320 | You can use the @code{mh-inc-spool-list} variable to direct MH-E to | 1445 | You can use the @code{mh-inc-spool-list} variable to direct MH-E to |
| 1321 | retrieve mail from arbitrary spool files other than your system | 1446 | retrieve mail from arbitrary spool files other than your system |
| 1322 | mailbox, file it in folders other than your @samp{+inbox}, and assign | 1447 | mailbox, file it in folders other than your @samp{+inbox}, and assign |
| @@ -1338,6 +1463,9 @@ MAILDIR=$HOME/mail | |||
| 1338 | mh-e | 1463 | mh-e |
| 1339 | @end smallexample | 1464 | @end smallexample |
| 1340 | 1465 | ||
| 1466 | @findex mh-inc-spool-* | ||
| 1467 | @kindex I * | ||
| 1468 | |||
| 1341 | In order to incorporate @file{~/mail/mh-e} into @samp{+mh-e} with an | 1469 | In order to incorporate @file{~/mail/mh-e} into @samp{+mh-e} with an |
| 1342 | @kbd{I m} (@code{mh-inc-spool-mh-e}) command, customize this option, | 1470 | @kbd{I m} (@code{mh-inc-spool-mh-e}) command, customize this option, |
| 1343 | and click on the @samp{INS} button. Enter a @samp{Spool File} of | 1471 | and click on the @samp{INS} button. Enter a @samp{Spool File} of |
| @@ -1367,6 +1495,10 @@ box ~/mail/mh-e | |||
| 1367 | In XEmacs, the command @command{gnuclient} is used in a similar | 1495 | In XEmacs, the command @command{gnuclient} is used in a similar |
| 1368 | fashion. | 1496 | fashion. |
| 1369 | 1497 | ||
| 1498 | @findex mh-inc-folder | ||
| 1499 | @kindex i | ||
| 1500 | @vindex mh-inc-folder-hook | ||
| 1501 | |||
| 1370 | You can set the hook @code{mh-inc-folder-hook}, which is called after | 1502 | You can set the hook @code{mh-inc-folder-hook}, which is called after |
| 1371 | new mail is incorporated by the @kbd{i} (@code{mh-inc-folder}) | 1503 | new mail is incorporated by the @kbd{i} (@code{mh-inc-folder}) |
| 1372 | command. A good use of this hook is to rescan the whole folder either | 1504 | command. A good use of this hook is to rescan the whole folder either |
| @@ -1397,13 +1529,16 @@ the message numbers from outside of MH-E. | |||
| 1397 | @node Reading Mail, Folders, Incorporating Mail, Top | 1529 | @node Reading Mail, Folders, Incorporating Mail, Top |
| 1398 | @chapter Reading Your Mail | 1530 | @chapter Reading Your Mail |
| 1399 | 1531 | ||
| 1532 | @cindex @samp{+inbox} | ||
| 1400 | @cindex MH-Folder mode | 1533 | @cindex MH-Folder mode |
| 1401 | @cindex MH-Show mode | 1534 | @cindex MH-Show mode |
| 1402 | @cindex modes, MH-Folder | 1535 | @cindex modes, MH-Folder |
| 1403 | @cindex modes, MH-Show | 1536 | @cindex modes, MH-Show |
| 1404 | @cindex reading mail | 1537 | @cindex reading mail |
| 1405 | @cindex scan lines | ||
| 1406 | @findex mh-rmail | 1538 | @findex mh-rmail |
| 1539 | @kindex M-x mh-rmail | ||
| 1540 | @kindex F r | ||
| 1541 | @kindex F v | ||
| 1407 | 1542 | ||
| 1408 | The MH-E entry point for reading mail is @kbd{M-x mh-rmail}. This | 1543 | The MH-E entry point for reading mail is @kbd{M-x mh-rmail}. This |
| 1409 | command incorporates your mail and creates a buffer called | 1544 | command incorporates your mail and creates a buffer called |
| @@ -1414,6 +1549,12 @@ into MH-E. Or, give a prefix argument to @code{mh-rmail} so it will | |||
| 1414 | prompt you for folder to visit like @kbd{F v} (for example, @kbd{C-u | 1549 | prompt you for folder to visit like @kbd{F v} (for example, @kbd{C-u |
| 1415 | M-x mh-rmail @key{RET} bob @key{RET}}). @xref{Folders}.}. | 1550 | M-x mh-rmail @key{RET} bob @key{RET}}). @xref{Folders}.}. |
| 1416 | 1551 | ||
| 1552 | @cindex @command{scan} | ||
| 1553 | @cindex @samp{Message} menu | ||
| 1554 | @cindex MH commands, @command{scan} | ||
| 1555 | @cindex menu, @samp{Message} | ||
| 1556 | @cindex scan lines | ||
| 1557 | |||
| 1417 | The @samp{+inbox} buffer contains @dfn{scan lines}, which are one-line | 1558 | The @samp{+inbox} buffer contains @dfn{scan lines}, which are one-line |
| 1418 | summaries of each incorporated message. You can perform most MH | 1559 | summaries of each incorporated message. You can perform most MH |
| 1419 | commands on these messages via one- or two-letter commands in either | 1560 | commands on these messages via one- or two-letter commands in either |
| @@ -1714,7 +1855,7 @@ On means non-reversible commands do not prompt for confirmation | |||
| 1714 | @c ------------------------- | 1855 | @c ------------------------- |
| 1715 | @item mh-fetch-x-image-url | 1856 | @item mh-fetch-x-image-url |
| 1716 | Control fetching of @samp{X-Image-URL:} header field image (default: | 1857 | Control fetching of @samp{X-Image-URL:} header field image (default: |
| 1717 | @code{Never Fetch}). | 1858 | @samp{Never Fetch}). |
| 1718 | @c ------------------------- | 1859 | @c ------------------------- |
| 1719 | @item mh-graphical-smileys-flag | 1860 | @item mh-graphical-smileys-flag |
| 1720 | On means graphical smileys are displayed (default: @samp{on}). | 1861 | On means graphical smileys are displayed (default: @samp{on}). |
| @@ -1733,14 +1874,14 @@ here). | |||
| 1733 | Additional header fields to hide (default: @code{nil}). | 1874 | Additional header fields to hide (default: @code{nil}). |
| 1734 | @c ------------------------- | 1875 | @c ------------------------- |
| 1735 | @item mh-lpr-command-format | 1876 | @item mh-lpr-command-format |
| 1736 | Command used to print (default: @samp{"lpr -J '%s'"}). | 1877 | Command used to print (default: @code{"lpr -J '%s'"}). |
| 1737 | @c ------------------------- | 1878 | @c ------------------------- |
| 1738 | @item mh-max-inline-image-height | 1879 | @item mh-max-inline-image-height |
| 1739 | Maximum inline image height if \"Content-Disposition:\" is not | 1880 | Maximum inline image height if @samp{Content-Disposition:} is not |
| 1740 | present (default: 0). | 1881 | present (default: 0). |
| 1741 | @c ------------------------- | 1882 | @c ------------------------- |
| 1742 | @item mh-max-inline-image-width | 1883 | @item mh-max-inline-image-width |
| 1743 | Maximum inline image width if \"Content-Disposition:\" is not | 1884 | Maximum inline image width if @samp{Content-Disposition:} is not |
| 1744 | present(default: 0). | 1885 | present(default: 0). |
| 1745 | @c ------------------------- | 1886 | @c ------------------------- |
| 1746 | @item mh-mhl-format-file | 1887 | @item mh-mhl-format-file |
| @@ -1754,12 +1895,16 @@ Default directory to use for @kbd{K a}. | |||
| 1754 | On means messages should be printed in the background (default: | 1895 | On means messages should be printed in the background (default: |
| 1755 | @samp{off}). | 1896 | @samp{off}). |
| 1756 | @c ------------------------- | 1897 | @c ------------------------- |
| 1898 | @item mh-show-buffer-mode-line-buffer-id | ||
| 1899 | Format string to produce @code{mode-line-buffer-identification} for | ||
| 1900 | show buffers (default: @code{" @{show-%s@} %d"}). | ||
| 1901 | @c ------------------------- | ||
| 1757 | @item mh-show-maximum-size | 1902 | @item mh-show-maximum-size |
| 1758 | Maximum size of message (in bytes) to display automatically (default: | 1903 | Maximum size of message (in bytes) to display automatically (default: |
| 1759 | 0). | 1904 | 0). |
| 1760 | @c ------------------------- | 1905 | @c ------------------------- |
| 1761 | @item mh-show-use-xface-flag | 1906 | @item mh-show-use-xface-flag |
| 1762 | On means display face images in MH-Show buffers (default: @code{on}). | 1907 | On means display face images in MH-Show buffers (default: @samp{on}). |
| 1763 | @c ------------------------- | 1908 | @c ------------------------- |
| 1764 | @item mh-store-default-directory | 1909 | @item mh-store-default-directory |
| 1765 | Default directory for @kbd{X s} (default: @samp{Current}). | 1910 | Default directory for @kbd{X s} (default: @samp{Current}). |
| @@ -1863,6 +2008,8 @@ header fields that mailers add to a message, but if you wish to see | |||
| 1863 | all of them, use the command @kbd{,} (comma; | 2008 | all of them, use the command @kbd{,} (comma; |
| 1864 | @code{mh-header-display}). | 2009 | @code{mh-header-display}). |
| 1865 | 2010 | ||
| 2011 | @vindex mh-show-maximum-size | ||
| 2012 | |||
| 1866 | The option @code{mh-show-maximum-size} provides an opportunity to skip | 2013 | The option @code{mh-show-maximum-size} provides an opportunity to skip |
| 1867 | over large messages which may be slow to load. The default value of 0 | 2014 | over large messages which may be slow to load. The default value of 0 |
| 1868 | means that all message are shown regardless of size. | 2015 | means that all message are shown regardless of size. |
| @@ -1884,8 +2031,8 @@ interesting, header fields. | |||
| 1884 | 2031 | ||
| 1885 | @cindex regular expressions, @code{mh-invisible-header-fields} | 2032 | @cindex regular expressions, @code{mh-invisible-header-fields} |
| 1886 | @vindex mh-clean-message-header-flag | 2033 | @vindex mh-clean-message-header-flag |
| 1887 | @vindex mh-invisible-header-fields-default | ||
| 1888 | @vindex mh-invisible-header-fields | 2034 | @vindex mh-invisible-header-fields |
| 2035 | @vindex mh-invisible-header-fields-default | ||
| 1889 | 2036 | ||
| 1890 | Normally messages are delivered with a handful of uninteresting header | 2037 | Normally messages are delivered with a handful of uninteresting header |
| 1891 | fields. These are hidden by turning on the option | 2038 | fields. These are hidden by turning on the option |
| @@ -1901,12 +2048,12 @@ entire class of fields that start with the same prefix. If you think a | |||
| 1901 | header field should be generally ignored, report a bug (@pxref{Bug | 2048 | header field should be generally ignored, report a bug (@pxref{Bug |
| 1902 | Reports}). | 2049 | Reports}). |
| 1903 | 2050 | ||
| 1904 | @cindex @samp{Face:} header field | ||
| 1905 | @cindex @samp{X-Face:} header field | ||
| 1906 | @cindex @samp{X-Image-URL:} header field | ||
| 1907 | @cindex header field, @samp{Face:} | 2051 | @cindex header field, @samp{Face:} |
| 1908 | @cindex header field, @samp{X-Face:} | 2052 | @cindex header field, @samp{X-Face:} |
| 1909 | @cindex header field, @samp{X-Image-URL:} | 2053 | @cindex header field, @samp{X-Image-URL:} |
| 2054 | @cindex @samp{Face:} header field | ||
| 2055 | @cindex @samp{X-Face:} header field | ||
| 2056 | @cindex @samp{X-Image-URL:} header field | ||
| 1910 | @vindex mh-show-use-xface-flag | 2057 | @vindex mh-show-use-xface-flag |
| 1911 | 2058 | ||
| 1912 | MH-E can display the content of @samp{Face:}, @samp{X-Face:}, and | 2059 | MH-E can display the content of @samp{Face:}, @samp{X-Face:}, and |
| @@ -2005,9 +2152,9 @@ parse the header. Note that @command{mhl} is always used for printing | |||
| 2005 | and forwarding; in this case, the value of @code{mh-mhl-format-file} | 2152 | and forwarding; in this case, the value of @code{mh-mhl-format-file} |
| 2006 | is consulted if you have specified a format file. | 2153 | is consulted if you have specified a format file. |
| 2007 | 2154 | ||
| 2008 | @vindex mh-highlight-citation-style | ||
| 2009 | @cindex citations, highlighting | 2155 | @cindex citations, highlighting |
| 2010 | @cindex highlighting citations | 2156 | @cindex highlighting citations |
| 2157 | @vindex mh-highlight-citation-style | ||
| 2011 | 2158 | ||
| 2012 | If the sender of the message has cited other messages in his message, | 2159 | If the sender of the message has cited other messages in his message, |
| 2013 | then MH-E will highlight these citations to emphasize the sender's | 2160 | then MH-E will highlight these citations to emphasize the sender's |
| @@ -2030,9 +2177,9 @@ highlighting of citations entirely, choose @samp{None}. | |||
| 2030 | Email addresses and URLs in the message are highlighted if the option | 2177 | Email addresses and URLs in the message are highlighted if the option |
| 2031 | @code{goto-address-highlight-p} is on, which it is by default. To view | 2178 | @code{goto-address-highlight-p} is on, which it is by default. To view |
| 2032 | the web page for a highlighted URL or to send a message using a | 2179 | the web page for a highlighted URL or to send a message using a |
| 2033 | highlighted email address, use @kbd{Mouse-2} or @kbd{C-c @key{RET}}. | 2180 | highlighted email address, use @kbd{Mouse-2} or @kbd{C-c @key{RET}} |
| 2034 | See @ref{Sending Mail}, to see how to configure Emacs to send the | 2181 | (@code{goto-address-at-point}). @xref{Sending Mail}, to see how to |
| 2035 | message using MH-E. | 2182 | configure Emacs to send the message using MH-E. |
| 2036 | 2183 | ||
| 2037 | @cindex boldface, showing | 2184 | @cindex boldface, showing |
| 2038 | @cindex emphasis | 2185 | @cindex emphasis |
| @@ -2074,7 +2221,7 @@ list. Both of these options are disabled if the option | |||
| 2074 | 2221 | ||
| 2075 | MH-E normally renders signatures and vCards in italics so that the | 2222 | MH-E normally renders signatures and vCards in italics so that the |
| 2076 | body of the message stands out more. MH-E depends on the presence of | 2223 | body of the message stands out more. MH-E depends on the presence of |
| 2077 | the @dfn{signature separator} (@samp{"-- "}) to do this. You can also | 2224 | the @dfn{signature separator} (@code{"-- "}) to do this. You can also |
| 2078 | customize the face @code{mh-show-signature} so the appearance of the | 2225 | customize the face @code{mh-show-signature} so the appearance of the |
| 2079 | signature block is more to your liking. | 2226 | signature block is more to your liking. |
| 2080 | 2227 | ||
| @@ -2089,16 +2236,16 @@ thing called after messages are displayed. It's used to affect the | |||
| 2089 | behavior of MH-E in general or when @code{mh-show-mode-hook} is too | 2236 | behavior of MH-E in general or when @code{mh-show-mode-hook} is too |
| 2090 | early. | 2237 | early. |
| 2091 | 2238 | ||
| 2092 | @vindex mh-show-buffer-mode-line-buffer-id | ||
| 2093 | @cindex MH-Show mode | 2239 | @cindex MH-Show mode |
| 2094 | @cindex modes, MH-Show | 2240 | @cindex modes, MH-Show |
| 2241 | @vindex mh-show-buffer-mode-line-buffer-id | ||
| 2095 | 2242 | ||
| 2096 | For those who like to modify their mode lines, use | 2243 | For those who like to modify their mode lines, use |
| 2097 | @code{mh-show-buffer-mode-line-buffer-id} to modify the mode line in | 2244 | @code{mh-show-buffer-mode-line-buffer-id} to modify the mode line in |
| 2098 | the MH-Show buffers. Place the two escape strings @samp{%s} and | 2245 | the MH-Show buffers. Place the two escape strings @samp{%s} and |
| 2099 | @samp{%d}, which will display the folder name and the message number, | 2246 | @samp{%d}, which will display the folder name and the message number, |
| 2100 | respectively, somewhere in the string in that order. The default value | 2247 | respectively, somewhere in the string in that order. The default value |
| 2101 | of @samp{"@{show-%s@} %d"} yields a mode line of | 2248 | of @code{"@{show-%s@} %d"} yields a mode line of |
| 2102 | 2249 | ||
| 2103 | @smallexample | 2250 | @smallexample |
| 2104 | -----@{show-+inbox@} 4 (MH-Show)--Bot-------------------------------- | 2251 | -----@{show-+inbox@} 4 (MH-Show)--Bot-------------------------------- |
| @@ -2107,13 +2254,13 @@ of @samp{"@{show-%s@} %d"} yields a mode line of | |||
| 2107 | @node Viewing Attachments, HTML, Viewing, Reading Mail | 2254 | @node Viewing Attachments, HTML, Viewing, Reading Mail |
| 2108 | @section Viewing Attachments | 2255 | @section Viewing Attachments |
| 2109 | 2256 | ||
| 2257 | @cindex attachments | ||
| 2258 | @cindex body parts | ||
| 2110 | @cindex @command{mhshow} | 2259 | @cindex @command{mhshow} |
| 2111 | @cindex @command{show} | 2260 | @cindex @command{show} |
| 2112 | @cindex MH commands, @command{mhshow} | 2261 | @cindex MH commands, @command{mhshow} |
| 2113 | @cindex MH commands, @command{show} | 2262 | @cindex MH commands, @command{show} |
| 2114 | @cindex MIME | 2263 | @cindex MIME |
| 2115 | @cindex attachments | ||
| 2116 | @cindex body parts | ||
| 2117 | @cindex multimedia mail | 2264 | @cindex multimedia mail |
| 2118 | 2265 | ||
| 2119 | MH has the ability to display @dfn{@sc{mime}} (Multipurpose Internet | 2266 | MH has the ability to display @dfn{@sc{mime}} (Multipurpose Internet |
| @@ -2147,21 +2294,22 @@ option also controls the display of quoted-printable messages and | |||
| 2147 | other graphical widgets. @xref{Viewing}. | 2294 | other graphical widgets. @xref{Viewing}. |
| 2148 | 2295 | ||
| 2149 | @cindex buttons | 2296 | @cindex buttons |
| 2150 | @kindex Mouse-1 | ||
| 2151 | @kindex Mouse-2 | ||
| 2152 | @kindex @key{RET} | ||
| 2153 | @findex mh-press-button | ||
| 2154 | @findex mh-next-button | ||
| 2155 | @findex mh-prev-button | ||
| 2156 | @kindex K @key{TAB} | ||
| 2157 | @kindex K S-@key{TAB} | ||
| 2158 | 2297 | ||
| 2159 | Attachments in MH-E are indicated by buttons like this: | 2298 | Attachments in MH-E are indicated by @dfn{buttons} like this: |
| 2160 | 2299 | ||
| 2161 | @example | 2300 | @example |
| 2162 | [1. image/jpeg; foo.jpg]... | 2301 | [1. image/jpeg; foo.jpg]... |
| 2163 | @end example | 2302 | @end example |
| 2164 | 2303 | ||
| 2304 | @findex mh-next-button | ||
| 2305 | @findex mh-press-button | ||
| 2306 | @findex mh-prev-button | ||
| 2307 | @kindex @key{RET} | ||
| 2308 | @kindex K @key{TAB} | ||
| 2309 | @kindex K S-@key{TAB} | ||
| 2310 | @kindex Mouse-1 | ||
| 2311 | @kindex Mouse-2 | ||
| 2312 | |||
| 2165 | To view the contents of the button, use either @kbd{Mouse-1} or | 2313 | To view the contents of the button, use either @kbd{Mouse-1} or |
| 2166 | @kbd{Mouse-2} on the button or @key{RET} (@code{mh-press-button}) when | 2314 | @kbd{Mouse-2} on the button or @key{RET} (@code{mh-press-button}) when |
| 2167 | the cursor is over the button. This command is a toggle so if you use | 2315 | the cursor is over the button. This command is a toggle so if you use |
| @@ -2214,7 +2362,6 @@ default for the viewer by calling the Emacs function | |||
| 2214 | 2362 | ||
| 2215 | @cindex attachments, saving | 2363 | @cindex attachments, saving |
| 2216 | @cindex saving attachments | 2364 | @cindex saving attachments |
| 2217 | |||
| 2218 | @findex mh-folder-save-mime-part | 2365 | @findex mh-folder-save-mime-part |
| 2219 | @kindex K o | 2366 | @kindex K o |
| 2220 | 2367 | ||
| @@ -2244,6 +2391,8 @@ directory. These directories may be superseded by MH profile | |||
| 2244 | components, since this function calls on @command{mhstore} | 2391 | components, since this function calls on @command{mhstore} |
| 2245 | (@command{mhn}) to do the work. | 2392 | (@command{mhn}) to do the work. |
| 2246 | 2393 | ||
| 2394 | @vindex mh-mime-save-parts-default-directory | ||
| 2395 | |||
| 2247 | The default value for the option | 2396 | The default value for the option |
| 2248 | @code{mh-mime-save-parts-default-directory} is @samp{Prompt Always} so | 2397 | @code{mh-mime-save-parts-default-directory} is @samp{Prompt Always} so |
| 2249 | that you are always prompted for the directory in which to save the | 2398 | that you are always prompted for the directory in which to save the |
| @@ -2275,9 +2424,9 @@ permanently by turning on the option | |||
| 2275 | MH-E cannot display all attachments inline however. It can display | 2424 | MH-E cannot display all attachments inline however. It can display |
| 2276 | text (including @sc{html}) and images. | 2425 | text (including @sc{html}) and images. |
| 2277 | 2426 | ||
| 2278 | @cindex @samp{Content-Disposition:} header field | ||
| 2279 | @cindex header field, @samp{Content-Disposition:} | 2427 | @cindex header field, @samp{Content-Disposition:} |
| 2280 | @cindex inline images | 2428 | @cindex inline images |
| 2429 | @cindex @samp{Content-Disposition:} header field | ||
| 2281 | @vindex mh-max-inline-image-height | 2430 | @vindex mh-max-inline-image-height |
| 2282 | @vindex mh-max-inline-image-width | 2431 | @vindex mh-max-inline-image-width |
| 2283 | 2432 | ||
| @@ -2331,7 +2480,6 @@ in the @cite{The Gnus Manual}. | |||
| 2331 | 2480 | ||
| 2332 | @cindex HTML | 2481 | @cindex HTML |
| 2333 | @cindex Gnus | 2482 | @cindex Gnus |
| 2334 | @vindex mm-text-html-renderer | ||
| 2335 | 2483 | ||
| 2336 | MH-E can display messages that have been sent in HTML@footnote{This | 2484 | MH-E can display messages that have been sent in HTML@footnote{This |
| 2337 | feature depends on a version of Gnus that is at least 5.10.}. The | 2485 | feature depends on a version of Gnus that is at least 5.10.}. The |
| @@ -2344,8 +2492,10 @@ then you'll see a button like this: | |||
| 2344 | [1. text/html; foo.html]... | 2492 | [1. text/html; foo.html]... |
| 2345 | @end example | 2493 | @end example |
| 2346 | 2494 | ||
| 2347 | See @ref{Viewing Attachments} to see how to read the contents of this | 2495 | To see how to read the contents of this body part, see @ref{Viewing |
| 2348 | body part. | 2496 | Attachments}. |
| 2497 | |||
| 2498 | @vindex mm-text-html-renderer | ||
| 2349 | 2499 | ||
| 2350 | The browser that MH-E uses is determined by the option | 2500 | The browser that MH-E uses is determined by the option |
| 2351 | @code{mm-text-html-renderer}. The default setting is set automatically | 2501 | @code{mm-text-html-renderer}. The default setting is set automatically |
| @@ -2356,12 +2506,17 @@ how to use it. In particular, find and disable the option to render | |||
| 2356 | images as this can tip off spammers that the email address they have | 2506 | images as this can tip off spammers that the email address they have |
| 2357 | used is valid. | 2507 | used is valid. |
| 2358 | 2508 | ||
| 2509 | @vindex mm-text-html-renderer | ||
| 2510 | |||
| 2359 | If you're confused about which @code{mm-text-html-renderer} to use, | 2511 | If you're confused about which @code{mm-text-html-renderer} to use, |
| 2360 | here's a brief description of each, sorted by popularity, that | 2512 | here's a brief description of each, sorted by popularity, that |
| 2361 | includes the results of a quick poll of MH-E users from 2005-12-23. | 2513 | includes the results of a quick poll of MH-E users from 2005-12-23. |
| 2362 | 2514 | ||
| 2363 | @table @asis | 2515 | @table @asis |
| 2364 | 2516 | @cindex browser, @samp{w3m} | |
| 2517 | @cindex @samp{w3m} | ||
| 2518 | @kindex Mouse-2 | ||
| 2519 | @kindex S-Mouse-2 | ||
| 2365 | @item @samp{w3m} 7 | 2520 | @item @samp{w3m} 7 |
| 2366 | The @samp{w3m} browser requires an external program. It's quick, | 2521 | The @samp{w3m} browser requires an external program. It's quick, |
| 2367 | produces pretty nice output, and best of all, it's the only browser | 2522 | produces pretty nice output, and best of all, it's the only browser |
| @@ -2372,6 +2527,8 @@ handles tables well and actually respects the table's width parameter | |||
| 2372 | (which can cause text to wrap if the author didn't anticipate that the | 2527 | (which can cause text to wrap if the author didn't anticipate that the |
| 2373 | page would be viewed in Emacs). | 2528 | page would be viewed in Emacs). |
| 2374 | @c ------------------------- | 2529 | @c ------------------------- |
| 2530 | @cindex browser, @samp{w3m-standalone} | ||
| 2531 | @cindex @samp{w3m-standalone} | ||
| 2375 | @item @samp{w3m-standalone} 3 | 2532 | @item @samp{w3m-standalone} 3 |
| 2376 | This browser, along with @samp{nil} for the external browser, are the | 2533 | This browser, along with @samp{nil} for the external browser, are the |
| 2377 | only choices that work without having to download a separate lisp | 2534 | only choices that work without having to download a separate lisp |
| @@ -2381,6 +2538,8 @@ wider than the Emacs frame. This browser was the only one not to | |||
| 2381 | handle the escape @samp{–} (it printed a @samp{?}), but it did | 2538 | handle the escape @samp{–} (it printed a @samp{?}), but it did |
| 2382 | render @samp{®}. | 2539 | render @samp{®}. |
| 2383 | @c ------------------------- | 2540 | @c ------------------------- |
| 2541 | @cindex browser, @samp{links} | ||
| 2542 | @cindex @samp{links} | ||
| 2384 | @item @samp{links} 1 | 2543 | @item @samp{links} 1 |
| 2385 | The @samp{links} browser requires an external program. It's quick, and | 2544 | The @samp{links} browser requires an external program. It's quick, and |
| 2386 | produces nicer output than @samp{lynx} on single column mails in | 2545 | produces nicer output than @samp{lynx} on single column mails in |
| @@ -2389,6 +2548,8 @@ on multi-column tables as some lines wrap. At least it fits in 80 | |||
| 2389 | columns and thus seems better than @samp{w3} and | 2548 | columns and thus seems better than @samp{w3} and |
| 2390 | @samp{w3m-standalone}. Converts escapes such as @samp{®} to (R). | 2549 | @samp{w3m-standalone}. Converts escapes such as @samp{®} to (R). |
| 2391 | @c ------------------------- | 2550 | @c ------------------------- |
| 2551 | @cindex browser, @samp{lynx} | ||
| 2552 | @cindex @samp{lynx} | ||
| 2392 | @item @samp{lynx} 1 | 2553 | @item @samp{lynx} 1 |
| 2393 | The @samp{lynx} browser requires an external program. It's quick and | 2554 | The @samp{lynx} browser requires an external program. It's quick and |
| 2394 | produces pretty decent output but it doesn't show links. It doesn't | 2555 | produces pretty decent output but it doesn't show links. It doesn't |
| @@ -2402,6 +2563,8 @@ This choice obviously requires an external browser. Like | |||
| 2402 | HTML messages have a button for the body part which you can view with | 2563 | HTML messages have a button for the body part which you can view with |
| 2403 | @kbd{K v} (@code{mh-folder-toggle-mime-part}). | 2564 | @kbd{K v} (@code{mh-folder-toggle-mime-part}). |
| 2404 | @c ------------------------- | 2565 | @c ------------------------- |
| 2566 | @cindex browser, @samp{w3} | ||
| 2567 | @cindex @samp{w3} | ||
| 2405 | @item @samp{w3} 0 | 2568 | @item @samp{w3} 0 |
| 2406 | This choice does not require an external program as all of the | 2569 | This choice does not require an external program as all of the |
| 2407 | rendering is done in lisp. You do need to get the package separately. | 2570 | rendering is done in lisp. You do need to get the package separately. |
| @@ -2414,6 +2577,8 @@ can follow links, but you have to find them first as they are not | |||
| 2414 | highlighted. Performs well on single-column tables and handles escapes | 2577 | highlighted. Performs well on single-column tables and handles escapes |
| 2415 | such as @samp{®}. | 2578 | such as @samp{®}. |
| 2416 | @c ------------------------- | 2579 | @c ------------------------- |
| 2580 | @cindex browser, @samp{html2text} | ||
| 2581 | @cindex @samp{html2text} | ||
| 2417 | @item @samp{html2text} 0 | 2582 | @item @samp{html2text} 0 |
| 2418 | The @samp{html2text} browser requires an external program. I noticed | 2583 | The @samp{html2text} browser requires an external program. I noticed |
| 2419 | that it can do some nasty things with simple HTML mails (like filling | 2584 | that it can do some nasty things with simple HTML mails (like filling |
| @@ -2422,6 +2587,8 @@ On another message, it displayed half of the HTML tags for some | |||
| 2422 | reason. | 2587 | reason. |
| 2423 | @end table | 2588 | @end table |
| 2424 | 2589 | ||
| 2590 | @vindex mm-text-html-renderer | ||
| 2591 | |||
| 2425 | For a couple more sources of information about | 2592 | For a couple more sources of information about |
| 2426 | @code{mm-text-html-renderer}, | 2593 | @code{mm-text-html-renderer}, |
| 2427 | @ifinfo | 2594 | @ifinfo |
| @@ -2442,10 +2609,10 @@ documentation for the Gnus command @kbd{W h} (see section | |||
| 2442 | @cindex digests | 2609 | @cindex digests |
| 2443 | @findex mh-page-digest | 2610 | @findex mh-page-digest |
| 2444 | @findex mh-page-digest-backwards | 2611 | @findex mh-page-digest-backwards |
| 2445 | @kindex @key{BS} | ||
| 2446 | @kindex @key{SPC} | ||
| 2447 | @kindex D @key{BS} | 2612 | @kindex D @key{BS} |
| 2448 | @kindex D @key{SPC} | 2613 | @kindex D @key{SPC} |
| 2614 | @kindex @key{BS} | ||
| 2615 | @kindex @key{SPC} | ||
| 2449 | 2616 | ||
| 2450 | A digest is a message that contains other messages. Special MH-E | 2617 | A digest is a message that contains other messages. Special MH-E |
| 2451 | commands let you read digests conveniently. You can use @key{SPC} and | 2618 | commands let you read digests conveniently. You can use @key{SPC} and |
| @@ -2459,8 +2626,8 @@ use @kbd{D @key{BS}} (@code{mh-page-digest-backwards}). | |||
| 2459 | @cindex MH-Folder Show mode | 2626 | @cindex MH-Folder Show mode |
| 2460 | @cindex modes, MH-Folder Show | 2627 | @cindex modes, MH-Folder Show |
| 2461 | @findex mh-burst-digest | 2628 | @findex mh-burst-digest |
| 2462 | @kindex D b | ||
| 2463 | @kindex d | 2629 | @kindex d |
| 2630 | @kindex D b | ||
| 2464 | @kindex t | 2631 | @kindex t |
| 2465 | 2632 | ||
| 2466 | Another handy command is @kbd{D b} (@code{mh-burst-digest}). This | 2633 | Another handy command is @kbd{D b} (@code{mh-burst-digest}). This |
| @@ -2622,6 +2789,8 @@ See | |||
| 2622 | @findex mh-ps-print-msg-file | 2789 | @findex mh-ps-print-msg-file |
| 2623 | @kindex P f | 2790 | @kindex P f |
| 2624 | @kindex P p | 2791 | @kindex P p |
| 2792 | @vindex mh-lpr-command-format | ||
| 2793 | @vindex mh-print-background-flag | ||
| 2625 | 2794 | ||
| 2626 | To print messages in MH-E, use the command @kbd{P p} | 2795 | To print messages in MH-E, use the command @kbd{P p} |
| 2627 | (@code{mh-ps-print-msg}). You can print all the messages in a range | 2796 | (@code{mh-ps-print-msg}). You can print all the messages in a range |
| @@ -2677,6 +2846,9 @@ formatted with @command{mhl}@footnote{See the section | |||
| 2677 | @uref{@value{MH-BOOK-HOME}/shomes.htm#Usisho, Using mhl} in the MH | 2846 | @uref{@value{MH-BOOK-HOME}/shomes.htm#Usisho, Using mhl} in the MH |
| 2678 | book.} and printed with the @command{lpr} command. | 2847 | book.} and printed with the @command{lpr} command. |
| 2679 | 2848 | ||
| 2849 | @kindex P f | ||
| 2850 | @kindex P l | ||
| 2851 | @kindex P p | ||
| 2680 | @vindex mh-lpr-command-format | 2852 | @vindex mh-lpr-command-format |
| 2681 | @vindex mh-print-background-flag | 2853 | @vindex mh-print-background-flag |
| 2682 | 2854 | ||
| @@ -2685,7 +2857,7 @@ The command @kbd{P l} uses two options. The option | |||
| 2685 | performs the actual printing. The string can contain one escape, | 2857 | performs the actual printing. The string can contain one escape, |
| 2686 | @samp{%s}, which is replaced by the name of the folder and the message | 2858 | @samp{%s}, which is replaced by the name of the folder and the message |
| 2687 | number and is useful for print job names. The default setting is | 2859 | number and is useful for print job names. The default setting is |
| 2688 | @samp{"lpr -J '%s'"}. I use @samp{"mpage -h'%s' -b Letter -H1of -mlrtb | 2860 | @code{"lpr -J '%s'"}. I use @code{"mpage -h'%s' -b Letter -H1of -mlrtb |
| 2689 | -P"} which produces a nice header and adds a bit of margin so the text | 2861 | -P"} which produces a nice header and adds a bit of margin so the text |
| 2690 | fits within my printer's margins. Normally messages are printed in the | 2862 | fits within my printer's margins. Normally messages are printed in the |
| 2691 | foreground. If this is slow on your system, you may elect to turn on | 2863 | foreground. If this is slow on your system, you may elect to turn on |
| @@ -2699,11 +2871,10 @@ commands @kbd{P p} or @kbd{P f}. | |||
| 2699 | 2871 | ||
| 2700 | @cindex files | 2872 | @cindex files |
| 2701 | @cindex pipes | 2873 | @cindex pipes |
| 2702 | |||
| 2703 | @findex mh-refile-or-write-again | 2874 | @findex mh-refile-or-write-again |
| 2704 | @findex mh-write-msg-to-file | 2875 | @findex mh-write-msg-to-file |
| 2705 | @kindex ! | ||
| 2706 | @kindex > | 2876 | @kindex > |
| 2877 | @kindex ! | ||
| 2707 | 2878 | ||
| 2708 | MH-E does offer a couple of commands that are not a part of MH@. The | 2879 | MH-E does offer a couple of commands that are not a part of MH@. The |
| 2709 | first one, @kbd{>} (@code{mh-write-msg-to-file}), writes a message to | 2880 | first one, @kbd{>} (@code{mh-write-msg-to-file}), writes a message to |
| @@ -2716,6 +2887,7 @@ can be made with the command @kbd{!} | |||
| 2716 | 2887 | ||
| 2717 | @findex mh-pipe-msg | 2888 | @findex mh-pipe-msg |
| 2718 | @kindex | | 2889 | @kindex | |
| 2890 | @kindex l | ||
| 2719 | 2891 | ||
| 2720 | You can also pipe the message through a Unix shell command with the | 2892 | You can also pipe the message through a Unix shell command with the |
| 2721 | command @kbd{|} (@code{mh-pipe-msg}). You are prompted for the Unix | 2893 | command @kbd{|} (@code{mh-pipe-msg}). You are prompted for the Unix |
| @@ -2744,6 +2916,8 @@ like to change the initial default directory, customize the option | |||
| 2744 | directory for storing the content of these messages. | 2916 | directory for storing the content of these messages. |
| 2745 | 2917 | ||
| 2746 | @findex mh-store-buffer | 2918 | @findex mh-store-buffer |
| 2919 | @kindex @key{RET} | ||
| 2920 | @kindex X s | ||
| 2747 | 2921 | ||
| 2748 | By the way, @kbd{X s} calls the Emacs Lisp function | 2922 | By the way, @kbd{X s} calls the Emacs Lisp function |
| 2749 | @code{mh-store-buffer}. I mention this because you can use it directly | 2923 | @code{mh-store-buffer}. I mention this because you can use it directly |
| @@ -2764,11 +2938,11 @@ typing @kbd{M-x mh-store-buffer @key{RET} ~ @key{RET}}. | |||
| 2764 | @findex mh-next-unread-msg | 2938 | @findex mh-next-unread-msg |
| 2765 | @findex mh-previous-undeleted-msg | 2939 | @findex mh-previous-undeleted-msg |
| 2766 | @findex mh-previous-unread-msg | 2940 | @findex mh-previous-unread-msg |
| 2941 | @kindex g | ||
| 2767 | @kindex M-< | 2942 | @kindex M-< |
| 2768 | @kindex M-> | 2943 | @kindex M-> |
| 2769 | @kindex M-n | 2944 | @kindex M-n |
| 2770 | @kindex M-p | 2945 | @kindex M-p |
| 2771 | @kindex g | ||
| 2772 | @kindex n | 2946 | @kindex n |
| 2773 | @kindex p | 2947 | @kindex p |
| 2774 | 2948 | ||
| @@ -2792,6 +2966,7 @@ message with @kbd{M-<} (@code{mh-first-msg}) and @kbd{M->} | |||
| 2792 | @findex previous-line | 2966 | @findex previous-line |
| 2793 | @kindex C-n | 2967 | @kindex C-n |
| 2794 | @kindex C-p | 2968 | @kindex C-p |
| 2969 | @kindex @key{RET} | ||
| 2795 | 2970 | ||
| 2796 | You can also use the Emacs commands @kbd{C-p} (@code{previous-line}) | 2971 | You can also use the Emacs commands @kbd{C-p} (@code{previous-line}) |
| 2797 | and @kbd{C-n} (@code{next-line}) to move up and down the scan lines in | 2972 | and @kbd{C-n} (@code{next-line}) to move up and down the scan lines in |
| @@ -2801,6 +2976,8 @@ the MH-Folder window. These commands can be used in conjunction with | |||
| 2801 | @cindex deleting messages | 2976 | @cindex deleting messages |
| 2802 | @findex mh-delete-msg | 2977 | @findex mh-delete-msg |
| 2803 | @kindex d | 2978 | @kindex d |
| 2979 | @kindex n | ||
| 2980 | @kindex p | ||
| 2804 | 2981 | ||
| 2805 | To mark a message for deletion, use the command @kbd{d} | 2982 | To mark a message for deletion, use the command @kbd{d} |
| 2806 | (@code{mh-delete-msg}). A @samp{D} is placed by the message in the | 2983 | (@code{mh-delete-msg}). A @samp{D} is placed by the message in the |
| @@ -2822,7 +2999,11 @@ the message. | |||
| 2822 | 2999 | ||
| 2823 | @findex mh-delete-subject | 3000 | @findex mh-delete-subject |
| 2824 | @findex mh-delete-subject-or-thread | 3001 | @findex mh-delete-subject-or-thread |
| 3002 | @findex mh-thread-delete | ||
| 3003 | @findex mh-undo | ||
| 2825 | @kindex k | 3004 | @kindex k |
| 3005 | @kindex T d | ||
| 3006 | @kindex u | ||
| 2826 | 3007 | ||
| 2827 | And to delete more messages faster, you can use @kbd{k} | 3008 | And to delete more messages faster, you can use @kbd{k} |
| 2828 | (@code{mh-delete-subject-or-thread}) to delete all the messages with | 3009 | (@code{mh-delete-subject-or-thread}) to delete all the messages with |
| @@ -2861,6 +3042,8 @@ the command @kbd{M} (@code{mh-modify}). It displays the raw message in | |||
| 2861 | an editable buffer. When you are done editing, save and kill the | 3042 | an editable buffer. When you are done editing, save and kill the |
| 2862 | buffer as you would any other. | 3043 | buffer as you would any other. |
| 2863 | 3044 | ||
| 3045 | @findex mh-kill-folder | ||
| 3046 | @findex mh-pack-folder | ||
| 2864 | @vindex mh-do-not-confirm-flag | 3047 | @vindex mh-do-not-confirm-flag |
| 2865 | 3048 | ||
| 2866 | Commands such as @code{mh-pack-folder} prompt to confirm whether to | 3049 | Commands such as @code{mh-pack-folder} prompt to confirm whether to |
| @@ -2960,7 +3143,11 @@ original configuration is displayed. | |||
| 2960 | @node Folders, Sending Mail, Reading Mail, Top | 3143 | @node Folders, Sending Mail, Reading Mail, Top |
| 2961 | @chapter Organizing Your Mail with Folders | 3144 | @chapter Organizing Your Mail with Folders |
| 2962 | 3145 | ||
| 3146 | @cindex @samp{Folder} menu | ||
| 3147 | @cindex @samp{Message} menu | ||
| 2963 | @cindex folders | 3148 | @cindex folders |
| 3149 | @cindex menu, @samp{Folder} | ||
| 3150 | @cindex menu, @samp{Message} | ||
| 2964 | @cindex using folders | 3151 | @cindex using folders |
| 2965 | 3152 | ||
| 2966 | This chapter discusses the things you can do with folders within MH-E. | 3153 | This chapter discusses the things you can do with folders within MH-E. |
| @@ -3214,6 +3401,8 @@ Ticked message face. | |||
| 3214 | @samp{To:} face. | 3401 | @samp{To:} face. |
| 3215 | @end vtable | 3402 | @end vtable |
| 3216 | 3403 | ||
| 3404 | @vindex mh-folder-mode-hook | ||
| 3405 | |||
| 3217 | The hook @code{mh-folder-mode-hook} is called when visiting a new | 3406 | The hook @code{mh-folder-mode-hook} is called when visiting a new |
| 3218 | folder in MH-Folder mode. This could be used to set your own key | 3407 | folder in MH-Folder mode. This could be used to set your own key |
| 3219 | bindings, for example: | 3408 | bindings, for example: |
| @@ -3268,15 +3457,20 @@ create folders. If you specify a folder that does not exist, you will | |||
| 3268 | be prompted to create it. The hook @code{mh-refile-msg-hook} is called | 3457 | be prompted to create it. The hook @code{mh-refile-msg-hook} is called |
| 3269 | after a message is marked to be refiled. | 3458 | after a message is marked to be refiled. |
| 3270 | 3459 | ||
| 3460 | @findex mh-write-msg-to-file | ||
| 3461 | @kindex ! | ||
| 3462 | |||
| 3271 | If you are refiling several messages into the same folder, you can use | 3463 | If you are refiling several messages into the same folder, you can use |
| 3272 | the command @kbd{!} (@code{mh-refile-or-write-again}) to repeat the | 3464 | the command @kbd{!} (@code{mh-refile-or-write-again}) to repeat the |
| 3273 | last refile or write (see the description of @kbd{>} | 3465 | last refile or write (for the description of @kbd{>} |
| 3274 | (@code{mh-write-msg-to-file} in @ref{Files and Pipes}). You can use a | 3466 | (@code{mh-write-msg-to-file}), @pxref{Files and Pipes}). You can use a |
| 3275 | range in either case (for example, @kbd{C-u o 1 3 5-7 last:5 frombob | 3467 | range in either case (for example, @kbd{C-u o 1 3 5-7 last:5 frombob |
| 3276 | @key{RET}}, @pxref{Ranges}). | 3468 | @key{RET}}, @pxref{Ranges}). |
| 3277 | 3469 | ||
| 3278 | @cindex expunging refiles and deletes | 3470 | @cindex expunging refiles and deletes |
| 3279 | @cindex undoing refiles and deletes | 3471 | @cindex undoing refiles and deletes |
| 3472 | @findex mh-undo | ||
| 3473 | @kindex u | ||
| 3280 | 3474 | ||
| 3281 | If you've deleted a message or refiled it, but changed your mind, you | 3475 | If you've deleted a message or refiled it, but changed your mind, you |
| 3282 | can cancel the action before you've executed it. Use @kbd{u} | 3476 | can cancel the action before you've executed it. Use @kbd{u} |
| @@ -3284,9 +3478,15 @@ can cancel the action before you've executed it. Use @kbd{u} | |||
| 3284 | You can also undo refiles and deletes for messages that are found in a | 3478 | You can also undo refiles and deletes for messages that are found in a |
| 3285 | given range (@pxref{Ranges}). | 3479 | given range (@pxref{Ranges}). |
| 3286 | 3480 | ||
| 3481 | @findex mh-undo-folder | ||
| 3482 | @kindex F u | ||
| 3483 | |||
| 3287 | Alternatively, you can use @kbd{F u} (@code{mh-undo-folder}) to undo | 3484 | Alternatively, you can use @kbd{F u} (@code{mh-undo-folder}) to undo |
| 3288 | all refiles and deletes in the current folder. | 3485 | all refiles and deletes in the current folder. |
| 3289 | 3486 | ||
| 3487 | @findex mh-execute-commands | ||
| 3488 | @kindex x | ||
| 3489 | |||
| 3290 | If you've marked messages to be deleted or refiled and you want to go | 3490 | If you've marked messages to be deleted or refiled and you want to go |
| 3291 | ahead and delete or refile the messages, use @kbd{x} | 3491 | ahead and delete or refile the messages, use @kbd{x} |
| 3292 | (@code{mh-execute-commands}). Many MH-E commands that may affect the | 3492 | (@code{mh-execute-commands}). Many MH-E commands that may affect the |
| @@ -3295,6 +3495,10 @@ you want to process refiles or deletes first and then either run | |||
| 3295 | @kbd{x} for you or undo the pending refiles and deletes, which are | 3495 | @kbd{x} for you or undo the pending refiles and deletes, which are |
| 3296 | lost. | 3496 | lost. |
| 3297 | 3497 | ||
| 3498 | @kindex x | ||
| 3499 | @vindex mh-after-commands-processed-hook | ||
| 3500 | @vindex mh-before-commands-processed-hook | ||
| 3501 | |||
| 3298 | The command @kbd{x} runs @code{mh-before-commands-processed-hook} | 3502 | The command @kbd{x} runs @code{mh-before-commands-processed-hook} |
| 3299 | before the commands are processed and | 3503 | before the commands are processed and |
| 3300 | @code{mh-after-commands-processed-hook} after the commands are | 3504 | @code{mh-after-commands-processed-hook} after the commands are |
| @@ -3306,6 +3510,10 @@ hook include @code{mh-folders-changed}, which lists which folders were | |||
| 3306 | affected by deletes and refiles. This list will always include the | 3510 | affected by deletes and refiles. This list will always include the |
| 3307 | current folder @code{mh-current-folder}. | 3511 | current folder @code{mh-current-folder}. |
| 3308 | 3512 | ||
| 3513 | @findex mh-copy-msg | ||
| 3514 | @kindex c | ||
| 3515 | @kindex o | ||
| 3516 | |||
| 3309 | If you wish to copy a message to another folder, you can use the | 3517 | If you wish to copy a message to another folder, you can use the |
| 3310 | command @kbd{c} (@code{mh-copy-msg}) (see the @option{-link} argument | 3518 | command @kbd{c} (@code{mh-copy-msg}) (see the @option{-link} argument |
| 3311 | to @command{refile}(1)). Like the command @kbd{o}, this command | 3519 | to @command{refile}(1)). Like the command @kbd{o}, this command |
| @@ -3314,12 +3522,14 @@ range (@pxref{Ranges}). Note that unlike the command @kbd{o}, the copy | |||
| 3314 | takes place immediately. The original copy remains in the current | 3522 | takes place immediately. The original copy remains in the current |
| 3315 | folder. | 3523 | folder. |
| 3316 | 3524 | ||
| 3317 | @cindex MH-Folder Show mode | ||
| 3318 | @cindex MH-Folder mode | ||
| 3319 | @cindex junk mail | 3525 | @cindex junk mail |
| 3526 | @cindex MH-Folder mode | ||
| 3527 | @cindex MH-Folder Show mode | ||
| 3320 | @cindex modes, MH-Folder | 3528 | @cindex modes, MH-Folder |
| 3321 | @cindex modes, MH-Folder Show | 3529 | @cindex modes, MH-Folder Show |
| 3322 | @cindex spam | 3530 | @cindex spam |
| 3531 | @findex mh-toggle-showing | ||
| 3532 | @kindex t | ||
| 3323 | 3533 | ||
| 3324 | The command @kbd{t} (@code{mh-toggle-showing}) switches between | 3534 | The command @kbd{t} (@code{mh-toggle-showing}) switches between |
| 3325 | MH-Folder mode and MH-Folder Show mode@footnote{For you Emacs wizards, | 3535 | MH-Folder mode and MH-Folder Show mode@footnote{For you Emacs wizards, |
| @@ -3334,6 +3544,7 @@ folder for later examination. | |||
| 3334 | @cindex modes, MH-Folder | 3544 | @cindex modes, MH-Folder |
| 3335 | @cindex modes, MH-Show | 3545 | @cindex modes, MH-Show |
| 3336 | @cindex moving between messages | 3546 | @cindex moving between messages |
| 3547 | @kindex t | ||
| 3337 | @vindex mh-recenter-summary-flag | 3548 | @vindex mh-recenter-summary-flag |
| 3338 | 3549 | ||
| 3339 | When you use @kbd{t} to toggle between show mode and scan mode, the | 3550 | When you use @kbd{t} to toggle between show mode and scan mode, the |
| @@ -3343,6 +3554,10 @@ causes the toggle to display as many scan lines as possible, with the | |||
| 3343 | cursor at the middle. The effect of @code{mh-recenter-summary-flag} is | 3554 | cursor at the middle. The effect of @code{mh-recenter-summary-flag} is |
| 3344 | rather useful, but it can be annoying on a slow network connection. | 3555 | rather useful, but it can be annoying on a slow network connection. |
| 3345 | 3556 | ||
| 3557 | @findex mh-visit-folder | ||
| 3558 | @kindex F v | ||
| 3559 | @vindex mh-large-folder | ||
| 3560 | |||
| 3346 | When you want to read the messages that you have refiled into folders, | 3561 | When you want to read the messages that you have refiled into folders, |
| 3347 | use the command @kbd{F v} (@code{mh-visit-folder}) to visit the | 3562 | use the command @kbd{F v} (@code{mh-visit-folder}) to visit the |
| 3348 | folder. You are prompted for the folder name. The folder buffer will | 3563 | folder. You are prompted for the folder name. The folder buffer will |
| @@ -3356,15 +3571,18 @@ to specify the range and @code{mh-large-folder} is ignored. Note that | |||
| 3356 | this command can also be used to create folders. If you specify a | 3571 | this command can also be used to create folders. If you specify a |
| 3357 | folder that does not exist, you will be prompted to create it. | 3572 | folder that does not exist, you will be prompted to create it. |
| 3358 | 3573 | ||
| 3574 | @findex mh-search | ||
| 3575 | @kindex F s | ||
| 3576 | |||
| 3359 | If you forget where you've refiled your messages, you can find them | 3577 | If you forget where you've refiled your messages, you can find them |
| 3360 | using @kbd{F s} (@code{mh-search}). @xref{Searching}. | 3578 | using @kbd{F s} (@code{mh-search}). @xref{Searching}. |
| 3361 | 3579 | ||
| 3362 | @cindex @command{procmail} | 3580 | @cindex @command{procmail} |
| 3363 | @cindex @command{rcvstore} | 3581 | @cindex @command{rcvstore} |
| 3364 | @cindex @samp{unseen} sequence | ||
| 3365 | @cindex MH commands, @command{rcvstore} | 3582 | @cindex MH commands, @command{rcvstore} |
| 3366 | @cindex Unix commands, @command{procmail} | 3583 | @cindex @samp{unseen} sequence |
| 3367 | @cindex sequence, @samp{unseen} | 3584 | @cindex sequence, @samp{unseen} |
| 3585 | @cindex Unix commands, @command{procmail} | ||
| 3368 | @cindex unseen messages, viewing | 3586 | @cindex unseen messages, viewing |
| 3369 | @findex mh-index-new-messages | 3587 | @findex mh-index-new-messages |
| 3370 | @kindex F n | 3588 | @kindex F n |
| @@ -3382,6 +3600,9 @@ folders, or nothing to search all folders. | |||
| 3382 | @cindex @samp{tick} sequence | 3600 | @cindex @samp{tick} sequence |
| 3383 | @cindex sequence, @samp{tick} | 3601 | @cindex sequence, @samp{tick} |
| 3384 | @cindex ticked messages, viewing | 3602 | @cindex ticked messages, viewing |
| 3603 | @findex mh-index-ticked-messages | ||
| 3604 | @kindex F ' | ||
| 3605 | @vindex mh-ticked-messages-folders | ||
| 3385 | 3606 | ||
| 3386 | If you have ticked messages (@pxref{Sequences}), you can display them | 3607 | If you have ticked messages (@pxref{Sequences}), you can display them |
| 3387 | using the command @kbd{F '} (@code{mh-index-ticked-messages}). All | 3608 | using the command @kbd{F '} (@code{mh-index-ticked-messages}). All |
| @@ -3400,14 +3621,28 @@ You can display messages in any sequence with the command @kbd{F q} | |||
| 3400 | With a prefix argument, enter a space-separated list of folders at the | 3621 | With a prefix argument, enter a space-separated list of folders at the |
| 3401 | prompt, or nothing to search all folders. | 3622 | prompt, or nothing to search all folders. |
| 3402 | 3623 | ||
| 3624 | @vindex mh-new-messages-folders | ||
| 3625 | @vindex mh-recursive-folders-flag | ||
| 3626 | @vindex mh-ticked-messages-folders | ||
| 3627 | |||
| 3403 | Set the options @code{mh-new-messages-folders} and | 3628 | Set the options @code{mh-new-messages-folders} and |
| 3404 | @code{mh-ticked-messages-folders} to @samp{Inbox} to search the | 3629 | @code{mh-ticked-messages-folders} to @samp{Inbox} to search the |
| 3405 | @samp{+inbox} folder or @samp{All} to search all of the top level | 3630 | @samp{+inbox} folder or @samp{All} to search all of the top level |
| 3406 | folders. Otherwise, list the folders that should be searched with the | 3631 | folders. Otherwise, list the folders that should be searched with the |
| 3407 | @samp{Choose Folders} menu item. See @code{mh-recursive-folders-flag}. | 3632 | @samp{Choose Folders} menu item. See @code{mh-recursive-folders-flag}. |
| 3408 | 3633 | ||
| 3409 | @cindex @samp{*MH-E Folders*} | ||
| 3410 | @cindex buffers, @samp{*MH-E Folders*} | 3634 | @cindex buffers, @samp{*MH-E Folders*} |
| 3635 | @cindex @samp{*MH-E Folders*} | ||
| 3636 | @findex mh-kill-folder | ||
| 3637 | @findex mh-list-folders | ||
| 3638 | @findex mh-pack-folder | ||
| 3639 | @findex mh-rescan-folder | ||
| 3640 | @findex mh-sort-folder | ||
| 3641 | @kindex F k | ||
| 3642 | @kindex F l | ||
| 3643 | @kindex F p | ||
| 3644 | @kindex F r | ||
| 3645 | @kindex F S | ||
| 3411 | 3646 | ||
| 3412 | Other commands you can perform on folders include: @kbd{F l} | 3647 | Other commands you can perform on folders include: @kbd{F l} |
| 3413 | (@code{mh-list-folders}), to place a listing of all the folders in | 3648 | (@code{mh-list-folders}), to place a listing of all the folders in |
| @@ -3422,11 +3657,16 @@ to rescan the folder, which is useful to grab all messages in your | |||
| 3422 | you don't want to rescan the entire folder, the commands @kbd{F r} or | 3657 | you don't want to rescan the entire folder, the commands @kbd{F r} or |
| 3423 | @kbd{F p} will accept a range (@pxref{Ranges}). | 3658 | @kbd{F p} will accept a range (@pxref{Ranges}). |
| 3424 | 3659 | ||
| 3660 | @kindex @key{TAB} | ||
| 3661 | @vindex mh-recursive-folders-flag | ||
| 3662 | |||
| 3425 | By default, operations on folders work only one level at a time. Set | 3663 | By default, operations on folders work only one level at a time. Set |
| 3426 | @code{mh-recursive-folders-flag} to non-@code{nil} to operate on all | 3664 | @code{mh-recursive-folders-flag} to non-@code{nil} to operate on all |
| 3427 | folders. This mostly means that you'll be able to see all your folders | 3665 | folders. This mostly means that you'll be able to see all your folders |
| 3428 | when you press @key{TAB} when prompted for a folder name. | 3666 | when you press @key{TAB} when prompted for a folder name. |
| 3429 | 3667 | ||
| 3668 | @findex mh-search-p | ||
| 3669 | @kindex k | ||
| 3430 | @vindex mh-kill-folder-suppress-prompt-hooks | 3670 | @vindex mh-kill-folder-suppress-prompt-hooks |
| 3431 | 3671 | ||
| 3432 | The hook @code{mh-kill-folder-suppress-prompt-hooks} is an abnormal | 3672 | The hook @code{mh-kill-folder-suppress-prompt-hooks} is an abnormal |
| @@ -3449,10 +3689,12 @@ Use this hook with care. If there is a bug in your hook which returns | |||
| 3449 | 3689 | ||
| 3450 | @cindex @command{sortm} | 3690 | @cindex @command{sortm} |
| 3451 | @cindex @file{.mh_profile} | 3691 | @cindex @file{.mh_profile} |
| 3452 | @cindex @samp{sortm:} MH profile component | 3692 | @cindex files, @file{.mh_profile} |
| 3453 | @cindex MH commands, @command{sortm} | 3693 | @cindex MH commands, @command{sortm} |
| 3454 | @cindex MH profile component, @samp{sortm:} | 3694 | @cindex MH profile component, @samp{sortm:} |
| 3455 | @cindex files, @file{.mh_profile} | 3695 | @cindex @samp{sortm:} MH profile component |
| 3696 | @kindex F S | ||
| 3697 | @vindex mh-sortm-args | ||
| 3456 | 3698 | ||
| 3457 | The option @code{mh-sortm-args} holds extra arguments to pass on to | 3699 | The option @code{mh-sortm-args} holds extra arguments to pass on to |
| 3458 | the command @command{sortm}@footnote{See the section | 3700 | the command @command{sortm}@footnote{See the section |
| @@ -3464,7 +3706,8 @@ This option may be used to provide an alternate view. For example, | |||
| 3464 | 3706 | ||
| 3465 | @cindex exiting | 3707 | @cindex exiting |
| 3466 | @cindex quitting | 3708 | @cindex quitting |
| 3467 | @findex mh-rmail | 3709 | @findex mh-quit |
| 3710 | @kindex q | ||
| 3468 | 3711 | ||
| 3469 | When you want to quit using MH-E and go back to editing, you can use | 3712 | When you want to quit using MH-E and go back to editing, you can use |
| 3470 | the @kbd{q} (@code{mh-quit}) command. This buries the buffers of the | 3713 | the @kbd{q} (@code{mh-quit}) command. This buries the buffers of the |
| @@ -3475,18 +3718,20 @@ buffers whose name begins with @samp{ *mh-} or @samp{*MH-E } | |||
| 3475 | selecting the @samp{+inbox} buffer or by running @kbd{M-x mh-rmail} | 3718 | selecting the @samp{+inbox} buffer or by running @kbd{M-x mh-rmail} |
| 3476 | again. | 3719 | again. |
| 3477 | 3720 | ||
| 3721 | @findex mh-execute-commands | ||
| 3722 | @kindex q | ||
| 3478 | @vindex mh-before-quit-hook | 3723 | @vindex mh-before-quit-hook |
| 3479 | @vindex mh-quit-hook | 3724 | @vindex mh-quit-hook |
| 3480 | 3725 | ||
| 3481 | The two hooks @code{mh-before-quit-hook} and @code{mh-quit-hook} are | 3726 | The two hooks @code{mh-before-quit-hook} and @code{mh-quit-hook} are |
| 3482 | called by @kbd{q} (@code{mh-quit}). The former one is called before | 3727 | called by @kbd{q}. The former one is called before the quit occurs, so |
| 3483 | the quit occurs, so you might use it to perform any MH-E operations; | 3728 | you might use it to perform any MH-E operations; you could perform |
| 3484 | you could perform some query and abort the quit or call | 3729 | some query and abort the quit or call @code{mh-execute-commands}, for |
| 3485 | @code{mh-execute-commands}, for example. The latter is not run in an | 3730 | example. The latter is not run in an MH-E context, so you might use it |
| 3486 | MH-E context, so you might use it to modify the window setup. For | 3731 | to modify the window setup. For example, if the window configuration |
| 3487 | example, if the window configuration was saved as in the example in | 3732 | was saved as in the example in @ref{Miscellaneous Commands and |
| 3488 | @ref{Miscellaneous Commands and Options}, you would also want to set | 3733 | Options}, you would also want to set @code{mh-quit-hook} to the |
| 3489 | @code{mh-quit-hook} to the following: | 3734 | following: |
| 3490 | 3735 | ||
| 3491 | @c XXX Replace this with my example for killing the mail buffers. | 3736 | @c XXX Replace this with my example for killing the mail buffers. |
| 3492 | 3737 | ||
| @@ -3508,8 +3753,8 @@ example, if the window configuration was saved as in the example in | |||
| 3508 | 3753 | ||
| 3509 | @cindex folders, renaming | 3754 | @cindex folders, renaming |
| 3510 | @cindex renaming folders | 3755 | @cindex renaming folders |
| 3756 | @findex dired | ||
| 3511 | @findex dired-do-rename | 3757 | @findex dired-do-rename |
| 3512 | @kindex R | ||
| 3513 | 3758 | ||
| 3514 | You can use dired to manipulate the folders themselves. For example, I | 3759 | You can use dired to manipulate the folders themselves. For example, I |
| 3515 | renamed my @samp{+out} folder to the more common @samp{+outbox} by | 3760 | renamed my @samp{+out} folder to the more common @samp{+outbox} by |
| @@ -3522,6 +3767,7 @@ moving my cursor to @samp{out} and using the command @kbd{R} | |||
| 3522 | 3767 | ||
| 3523 | @cindex sending mail | 3768 | @cindex sending mail |
| 3524 | @findex mh-smail | 3769 | @findex mh-smail |
| 3770 | @kindex M-x mh-smail | ||
| 3525 | 3771 | ||
| 3526 | You can send a mail message in several ways. You can call @kbd{M-x | 3772 | You can send a mail message in several ways. You can call @kbd{M-x |
| 3527 | mh-smail} directly, or from the command line like this: | 3773 | mh-smail} directly, or from the command line like this: |
| @@ -3540,6 +3786,9 @@ There are some commands that need to send a mail message, such as | |||
| 3540 | commands use MH-E by setting the option @code{mail-user-agent} to | 3786 | commands use MH-E by setting the option @code{mail-user-agent} to |
| 3541 | @samp{Emacs interface to MH}. | 3787 | @samp{Emacs interface to MH}. |
| 3542 | 3788 | ||
| 3789 | @cindex @samp{Message} menu | ||
| 3790 | @cindex menu, @samp{Message} | ||
| 3791 | |||
| 3543 | From within MH-E's MH-Folder mode, other methods of sending mail are | 3792 | From within MH-E's MH-Folder mode, other methods of sending mail are |
| 3544 | available as well. These can also be found in the @samp{Message} menu. | 3793 | available as well. These can also be found in the @samp{Message} menu. |
| 3545 | 3794 | ||
| @@ -3616,7 +3865,7 @@ On means prompt for header fields when composing a new draft (default: | |||
| 3616 | @samp{off}). | 3865 | @samp{off}). |
| 3617 | @c ------------------------- | 3866 | @c ------------------------- |
| 3618 | @item mh-forward-subject-format | 3867 | @item mh-forward-subject-format |
| 3619 | Format string for forwarded message subject (default: @samp{"%s: | 3868 | Format string for forwarded message subject (default: @code{"%s: |
| 3620 | %s"}). | 3869 | %s"}). |
| 3621 | @c ------------------------- | 3870 | @c ------------------------- |
| 3622 | @item mh-insert-x-mailer-flag | 3871 | @item mh-insert-x-mailer-flag |
| @@ -3671,6 +3920,8 @@ in the following sections. | |||
| 3671 | @cindex sending mail | 3920 | @cindex sending mail |
| 3672 | @findex mh-smail | 3921 | @findex mh-smail |
| 3673 | @findex mh-smail-other-window | 3922 | @findex mh-smail-other-window |
| 3923 | @kindex M-x mh-smail | ||
| 3924 | @kindex M-x mh-smail-other-window | ||
| 3674 | 3925 | ||
| 3675 | Outside of an MH-Folder buffer, you must call either @kbd{M-x | 3926 | Outside of an MH-Folder buffer, you must call either @kbd{M-x |
| 3676 | mh-smail} or @kbd{M-x mh-smail-other-window} to compose a new message. | 3927 | mh-smail} or @kbd{M-x mh-smail-other-window} to compose a new message. |
| @@ -3684,25 +3935,24 @@ following key bindings to @file{~/.emacs} useful: | |||
| 3684 | (global-set-key "\C-x4m" 'mh-smail-other-window) | 3935 | (global-set-key "\C-x4m" 'mh-smail-other-window) |
| 3685 | @end smalllisp | 3936 | @end smalllisp |
| 3686 | 3937 | ||
| 3687 | @cindex MH-Letter mode | ||
| 3688 | @cindex draft folder | 3938 | @cindex draft folder |
| 3939 | @cindex MH-Letter mode | ||
| 3689 | @cindex modes, MH-Letter | 3940 | @cindex modes, MH-Letter |
| 3690 | @findex mh-send | 3941 | @findex mh-send |
| 3691 | @kindex m | 3942 | @kindex m |
| 3692 | 3943 | ||
| 3693 | From within a MH-Folder buffer, you can simply use the command @kbd{m} | 3944 | From within a MH-Folder buffer, you can simply use the command @kbd{m} |
| 3694 | (@code{mh-send}). However you invoke @code{mh-send}, your letter | 3945 | (@code{mh-send}). However you invoke @code{mh-send}, your letter |
| 3695 | appears in an Emacs buffer whose mode is MH-Letter (see the Figure in | 3946 | appears in an Emacs buffer whose mode is MH-Letter (to see what the |
| 3696 | @ref{Sending Mail Tour} to see what the buffer looks like). MH-Letter | 3947 | buffer looks like, @pxref{Sending Mail Tour}). MH-Letter mode allows |
| 3697 | mode allows you to edit your message, to check the validity of the | 3948 | you to edit your message, to check the validity of the recipients, to |
| 3698 | recipients, to insert attachments and other messages into your | 3949 | insert attachments and other messages into your message, and to send |
| 3699 | message, and to send the message. We'll go more into depth about | 3950 | the message. We'll go more into depth about editing a |
| 3700 | editing a @dfn{draft}@footnote{I highly recommend that you use a | 3951 | @dfn{draft}@footnote{I highly recommend that you use a @dfn{draft |
| 3701 | @dfn{draft folder} so that you can edit several drafts in parallel. To | 3952 | folder} so that you can edit several drafts in parallel. To do so, |
| 3702 | do so, create a folder named @samp{+drafts} for example, and add the | 3953 | create a folder named @samp{+drafts} for example, and add the profile |
| 3703 | profile component @samp{Draft-Folder: drafts} (see | 3954 | component @samp{Draft-Folder: drafts} (see @code{mh-profile}(5)).} (a |
| 3704 | @code{mh-profile}(5)).} (a message you're composing) in just a moment | 3955 | message you're composing) in just a moment (@pxref{Editing Drafts}). |
| 3705 | (@pxref{Editing Drafts}). | ||
| 3706 | 3956 | ||
| 3707 | @vindex mh-compose-prompt-flag | 3957 | @vindex mh-compose-prompt-flag |
| 3708 | 3958 | ||
| @@ -3710,8 +3960,8 @@ If you prefer to be prompted for the recipient and subject fields | |||
| 3710 | before the MH-Letter buffer appears, turn on the option | 3960 | before the MH-Letter buffer appears, turn on the option |
| 3711 | @code{mh-compose-prompt-flag}. | 3961 | @code{mh-compose-prompt-flag}. |
| 3712 | 3962 | ||
| 3713 | @cindex @samp{X-Mailer:} header field | ||
| 3714 | @cindex header field, @samp{X-Mailer:} | 3963 | @cindex header field, @samp{X-Mailer:} |
| 3964 | @cindex @samp{X-Mailer:} header field | ||
| 3715 | @vindex mh-insert-x-mailer-flag | 3965 | @vindex mh-insert-x-mailer-flag |
| 3716 | 3966 | ||
| 3717 | MH-E adds an @samp{X-Mailer:} header field to the header that includes | 3967 | MH-E adds an @samp{X-Mailer:} header field to the header that includes |
| @@ -3722,8 +3972,10 @@ participate in our marketing, you can turn off the option | |||
| 3722 | @cindex @command{repl} | 3972 | @cindex @command{repl} |
| 3723 | @cindex @file{components} | 3973 | @cindex @file{components} |
| 3724 | @cindex MH commands, @command{repl} | 3974 | @cindex MH commands, @command{repl} |
| 3975 | @cindex MH-Letter mode | ||
| 3725 | @cindex Mail mode | 3976 | @cindex Mail mode |
| 3726 | @cindex files, @file{components} | 3977 | @cindex files, @file{components} |
| 3978 | @cindex modes, MH-Letter | ||
| 3727 | @cindex modes, Mail | 3979 | @cindex modes, Mail |
| 3728 | @vindex mail-mode-hook | 3980 | @vindex mail-mode-hook |
| 3729 | @vindex mh-letter-mode-hook | 3981 | @vindex mh-letter-mode-hook |
| @@ -3738,9 +3990,7 @@ order) before @code{mh-letter-mode-hook}.}. For example, you may wish | |||
| 3738 | to modify the header after @command{repl} has done its work, or you | 3990 | to modify the header after @command{repl} has done its work, or you |
| 3739 | may have a complicated @file{components} file and need to tell MH-E | 3991 | may have a complicated @file{components} file and need to tell MH-E |
| 3740 | where the cursor should go. Here's an example of how you would use | 3992 | where the cursor should go. Here's an example of how you would use |
| 3741 | this hook. You can add the hook using @code{add-hook} or by running | 3993 | this hook. |
| 3742 | @kbd{M-x customize-option @key{RET} mh-letter-mode-hook | ||
| 3743 | @key{RET}}---all of the other hooks are set in a similar fashion. | ||
| 3744 | 3994 | ||
| 3745 | @findex mh-insert-signature, example | 3995 | @findex mh-insert-signature, example |
| 3746 | 3996 | ||
| @@ -3764,8 +4014,6 @@ this hook. You can add the hook using @code{add-hook} or by running | |||
| 3764 | (goto-char (point-max)) ; @r{go to end of message to} | 4014 | (goto-char (point-max)) ; @r{go to end of message to} |
| 3765 | (mh-insert-signature))) ; @r{insert signature} | 4015 | (mh-insert-signature))) ; @r{insert signature} |
| 3766 | 4016 | ||
| 3767 | (add-hook 'mh-letter-mode-hook 'my-mh-letter-mode-hook) | ||
| 3768 | |||
| 3769 | @i{Prepare draft for editing via mh-letter-mode-hook} | 4017 | @i{Prepare draft for editing via mh-letter-mode-hook} |
| 3770 | 4018 | ||
| 3771 | @end group | 4019 | @end group |
| @@ -3775,6 +4023,7 @@ The function, @code{add-enriched-text} is defined in the example in | |||
| 3775 | @ref{Adding Attachments}. | 4023 | @ref{Adding Attachments}. |
| 3776 | 4024 | ||
| 3777 | @vindex mh-compose-letter-function | 4025 | @vindex mh-compose-letter-function |
| 4026 | @vindex mh-letter-mode-hook | ||
| 3778 | 4027 | ||
| 3779 | The second hook, a function really, is | 4028 | The second hook, a function really, is |
| 3780 | @code{mh-compose-letter-function}. Like @code{mh-letter-mode-hook}, it | 4029 | @code{mh-compose-letter-function}. Like @code{mh-letter-mode-hook}, it |
| @@ -3853,6 +4102,8 @@ no effect. | |||
| 3853 | Another way to include the message automatically in your draft is to | 4102 | Another way to include the message automatically in your draft is to |
| 3854 | use @samp{repl: -filter repl.filter} in your MH profile. | 4103 | use @samp{repl: -filter repl.filter} in your MH profile. |
| 3855 | 4104 | ||
| 4105 | @vindex mh-reply-show-message-flag | ||
| 4106 | |||
| 3856 | If you include the message automatically, you can hide the MH-Show | 4107 | If you include the message automatically, you can hide the MH-Show |
| 3857 | buffer by turning off the option @code{mh-reply-show-message-flag}. | 4108 | buffer by turning off the option @code{mh-reply-show-message-flag}. |
| 3858 | 4109 | ||
| @@ -3872,9 +4123,9 @@ recipients in the draft. | |||
| 3872 | @section Forwarding Mail | 4123 | @section Forwarding Mail |
| 3873 | 4124 | ||
| 3874 | @cindex @command{forw} | 4125 | @cindex @command{forw} |
| 3875 | @cindex MH commands, @command{forw} | ||
| 3876 | @cindex draft | 4126 | @cindex draft |
| 3877 | @cindex forwarding | 4127 | @cindex forwarding |
| 4128 | @cindex MH commands, @command{forw} | ||
| 3878 | @findex mh-forward | 4129 | @findex mh-forward |
| 3879 | @kindex f | 4130 | @kindex f |
| 3880 | @vindex mh-forward-hook | 4131 | @vindex mh-forward-hook |
| @@ -3890,9 +4141,9 @@ All of the messages in the range are inserted into your draft. The | |||
| 3890 | hook @code{mh-forward-hook} is called on the draft. | 4141 | hook @code{mh-forward-hook} is called on the draft. |
| 3891 | 4142 | ||
| 3892 | @cindex @file{.mh_profile} | 4143 | @cindex @file{.mh_profile} |
| 3893 | @cindex @samp{forw:} MH profile component | ||
| 3894 | @cindex MH profile component, @samp{forw:} | ||
| 3895 | @cindex files, @file{.mh_profile} | 4144 | @cindex files, @file{.mh_profile} |
| 4145 | @cindex MH profile component, @samp{forw:} | ||
| 4146 | @cindex @samp{forw:} MH profile component | ||
| 3896 | @vindex mh-compose-forward-as-mime-flag | 4147 | @vindex mh-compose-forward-as-mime-flag |
| 3897 | 4148 | ||
| 3898 | By default, the option @code{mh-compose-forward-as-mime-flag} is on | 4149 | By default, the option @code{mh-compose-forward-as-mime-flag} is on |
| @@ -3912,7 +4163,7 @@ is controlled by the option @code{mh-forward-subject-format}. This | |||
| 3912 | option is a string which includes two escapes (@samp{%s}). The first | 4163 | option is a string which includes two escapes (@samp{%s}). The first |
| 3913 | @samp{%s} is replaced with the sender of the original message, and the | 4164 | @samp{%s} is replaced with the sender of the original message, and the |
| 3914 | second one is replaced with the original @samp{Subject:}. The default | 4165 | second one is replaced with the original @samp{Subject:}. The default |
| 3915 | value of @samp{"%s: %s"} takes a message with the header: | 4166 | value of @code{"%s: %s"} takes a message with the header: |
| 3916 | 4167 | ||
| 3917 | @smallexample | 4168 | @smallexample |
| 3918 | @group | 4169 | @group |
| @@ -3943,6 +4194,9 @@ does it add your name to the @samp{From:} header field. It appears to | |||
| 3943 | the recipient as if the message had come from the original sender. | 4194 | the recipient as if the message had come from the original sender. |
| 3944 | When you run this command, you are prompted for the recipients. | 4195 | When you run this command, you are prompted for the recipients. |
| 3945 | 4196 | ||
| 4197 | @findex mh-edit-again | ||
| 4198 | @kindex e | ||
| 4199 | |||
| 3946 | For more information on redistributing messages, see | 4200 | For more information on redistributing messages, see |
| 3947 | @command{dist}(1). Also investigate the command @kbd{e} | 4201 | @command{dist}(1). Also investigate the command @kbd{e} |
| 3948 | (@code{mh-edit-again}) for another way to redistribute messages | 4202 | (@code{mh-edit-again}) for another way to redistribute messages |
| @@ -3969,7 +4223,9 @@ a message that has been redistributed before, turn off this option. | |||
| 3969 | @cindex files, @file{draft} | 4223 | @cindex files, @file{draft} |
| 3970 | @cindex re-editing drafts | 4224 | @cindex re-editing drafts |
| 3971 | @findex mh-edit-again | 4225 | @findex mh-edit-again |
| 4226 | @kindex F v drafts | ||
| 3972 | @kindex e | 4227 | @kindex e |
| 4228 | @kindex n | ||
| 3973 | 4229 | ||
| 3974 | If you don't complete a draft for one reason or another, and if the | 4230 | If you don't complete a draft for one reason or another, and if the |
| 3975 | draft buffer is no longer available, you can pick your draft up again | 4231 | draft buffer is no longer available, you can pick your draft up again |
| @@ -3979,11 +4235,14 @@ folders, you'll need to visit the draft folder with @kbd{F v drafts | |||
| 3979 | @key{RET}}, use @kbd{n} to move to the appropriate message, and then | 4235 | @key{RET}}, use @kbd{n} to move to the appropriate message, and then |
| 3980 | use @kbd{e} to prepare the message for editing. | 4236 | use @kbd{e} to prepare the message for editing. |
| 3981 | 4237 | ||
| 4238 | @kindex e | ||
| 4239 | |||
| 3982 | The @kbd{e} command can also be used to take messages that were sent | 4240 | The @kbd{e} command can also be used to take messages that were sent |
| 3983 | to you and to send them to more people. | 4241 | to you and to send them to more people. |
| 3984 | 4242 | ||
| 3985 | @cindex Mailer-Daemon | 4243 | @cindex Mailer-Daemon |
| 3986 | @findex mh-extract-rejected-mail | 4244 | @findex mh-extract-rejected-mail |
| 4245 | @kindex C-c C-c | ||
| 3987 | @kindex E | 4246 | @kindex E |
| 3988 | 4247 | ||
| 3989 | Don't use @kbd{e} to re-edit a message from a @i{Mailer-Daemon} who | 4248 | Don't use @kbd{e} to re-edit a message from a @i{Mailer-Daemon} who |
| @@ -3996,9 +4255,11 @@ send the message again with @kbd{C-c C-c}. | |||
| 3996 | @node Editing Drafts, Aliases, Sending Mail, Top | 4255 | @node Editing Drafts, Aliases, Sending Mail, Top |
| 3997 | @chapter Editing a Draft | 4256 | @chapter Editing a Draft |
| 3998 | 4257 | ||
| 4258 | @cindex @samp{Letter} menu | ||
| 3999 | @cindex MH-Letter mode | 4259 | @cindex MH-Letter mode |
| 4000 | @cindex draft | 4260 | @cindex draft |
| 4001 | @cindex editing draft | 4261 | @cindex editing draft |
| 4262 | @cindex menu, @samp{Letter} | ||
| 4002 | @cindex modes, MH-Letter | 4263 | @cindex modes, MH-Letter |
| 4003 | 4264 | ||
| 4004 | When you edit a message that you want to send (called a @dfn{draft} in | 4265 | When you edit a message that you want to send (called a @dfn{draft} in |
| @@ -4310,11 +4571,11 @@ On means delete any window displaying the message (default: @samp{off}). | |||
| 4310 | @c ------------------------- | 4571 | @c ------------------------- |
| 4311 | @item mh-extract-from-attribution-verb | 4572 | @item mh-extract-from-attribution-verb |
| 4312 | Verb to use for attribution when a message is yanked by @kbd{C-c C-y} | 4573 | Verb to use for attribution when a message is yanked by @kbd{C-c C-y} |
| 4313 | (default: @samp{"wrote:"}). | 4574 | (default: @code{"wrote:"}). |
| 4314 | @c ------------------------- | 4575 | @c ------------------------- |
| 4315 | @item mh-ins-buf-prefix | 4576 | @item mh-ins-buf-prefix |
| 4316 | String to put before each line of a yanked or inserted message | 4577 | String to put before each line of a yanked or inserted message |
| 4317 | (default: @samp{"> "}). | 4578 | (default: @code{"> "}). |
| 4318 | @c ------------------------- | 4579 | @c ------------------------- |
| 4319 | @item mh-letter-complete-function | 4580 | @item mh-letter-complete-function |
| 4320 | Function to call when completing outside of address or folder fields | 4581 | Function to call when completing outside of address or folder fields |
| @@ -4328,7 +4589,7 @@ Default method to use in security tags (default: @samp{PGP (MIME)} if | |||
| 4328 | support for it is available; otherwise @samp{None}). | 4589 | support for it is available; otherwise @samp{None}). |
| 4329 | @c ------------------------- | 4590 | @c ------------------------- |
| 4330 | @item mh-signature-file-name | 4591 | @item mh-signature-file-name |
| 4331 | Source of user's signature (default: @samp{"~/.signature"}). | 4592 | Source of user's signature (default: @code{"~/.signature"}). |
| 4332 | @c ------------------------- | 4593 | @c ------------------------- |
| 4333 | @item mh-signature-separator-flag | 4594 | @item mh-signature-separator-flag |
| 4334 | On means a signature separator should be inserted (default: | 4595 | On means a signature separator should be inserted (default: |
| @@ -4336,7 +4597,7 @@ On means a signature separator should be inserted (default: | |||
| 4336 | @c ------------------------- | 4597 | @c ------------------------- |
| 4337 | @item mh-x-face-file | 4598 | @item mh-x-face-file |
| 4338 | File containing X-Face or Face header field to insert in outgoing mail. | 4599 | File containing X-Face or Face header field to insert in outgoing mail. |
| 4339 | (default: @samp{"~/.face"}). | 4600 | (default: @code{"~/.face"}). |
| 4340 | @c ------------------------- | 4601 | @c ------------------------- |
| 4341 | @item mh-yank-behavior | 4602 | @item mh-yank-behavior |
| 4342 | Controls which part of a message is yanked by @kbd{C-c C-y} (default: | 4603 | Controls which part of a message is yanked by @kbd{C-c C-y} (default: |
| @@ -4433,8 +4694,8 @@ draft. @xref{Folder Selection}. | |||
| 4433 | @findex indent-relative | 4694 | @findex indent-relative |
| 4434 | @findex mh-letter-next-header-field-or-indent | 4695 | @findex mh-letter-next-header-field-or-indent |
| 4435 | @findex mh-letter-previous-header-field | 4696 | @findex mh-letter-previous-header-field |
| 4436 | @kindex S-@key{TAB} | ||
| 4437 | @kindex @key{TAB} | 4697 | @kindex @key{TAB} |
| 4698 | @kindex S-@key{TAB} | ||
| 4438 | @vindex mh-compose-skipped-header-fields | 4699 | @vindex mh-compose-skipped-header-fields |
| 4439 | @vindex mh-letter-header-field | 4700 | @vindex mh-letter-header-field |
| 4440 | 4701 | ||
| @@ -4460,8 +4721,10 @@ take point to the last field from anywhere in the body. | |||
| 4460 | @findex mh-letter-complete-or-space | 4721 | @findex mh-letter-complete-or-space |
| 4461 | @findex mh-letter-confirm-address | 4722 | @findex mh-letter-confirm-address |
| 4462 | @kindex , (comma) | 4723 | @kindex , (comma) |
| 4463 | @kindex M-@key{TAB} | ||
| 4464 | @kindex @key{SPC} | 4724 | @kindex @key{SPC} |
| 4725 | @kindex M-@key{TAB} | ||
| 4726 | @vindex mh-alias-flash-on-comma | ||
| 4727 | @vindex mh-compose-space-does-completion-flag | ||
| 4465 | @vindex mh-letter-complete-function | 4728 | @vindex mh-letter-complete-function |
| 4466 | 4729 | ||
| 4467 | If the field contains addresses (for example, @samp{To:} or | 4730 | If the field contains addresses (for example, @samp{To:} or |
| @@ -4480,10 +4743,11 @@ press the comma, the command @code{mh-letter-confirm-address} flashes | |||
| 4480 | the alias expansion in the minibuffer if | 4743 | the alias expansion in the minibuffer if |
| 4481 | @code{mh-alias-flash-on-comma} is turned on. | 4744 | @code{mh-alias-flash-on-comma} is turned on. |
| 4482 | 4745 | ||
| 4483 | @kindex C-c C-t | ||
| 4484 | @findex mh-letter-toggle-header-field-display | ||
| 4485 | @c XXX Document the replacement for the inaccessible 'long argument. | 4746 | @c XXX Document the replacement for the inaccessible 'long argument. |
| 4486 | 4747 | ||
| 4748 | @findex mh-letter-toggle-header-field-display | ||
| 4749 | @kindex C-c C-t | ||
| 4750 | |||
| 4487 | Use the command @kbd{C-c C-t} | 4751 | Use the command @kbd{C-c C-t} |
| 4488 | @code{mh-letter-toggle-header-field-display} to display truncated | 4752 | @code{mh-letter-toggle-header-field-display} to display truncated |
| 4489 | header fields. This command is a toggle so entering it again will hide | 4753 | header fields. This command is a toggle so entering it again will hide |
| @@ -4566,6 +4830,7 @@ the first period in the paragraph above, the result would be this: | |||
| 4566 | @cindex yanking messages | 4830 | @cindex yanking messages |
| 4567 | @findex mh-yank-cur-msg | 4831 | @findex mh-yank-cur-msg |
| 4568 | @kindex C-c C-y | 4832 | @kindex C-c C-y |
| 4833 | @vindex mh-ins-buf-prefix | ||
| 4569 | 4834 | ||
| 4570 | It is often useful to insert a snippet of text from a letter that | 4835 | It is often useful to insert a snippet of text from a letter that |
| 4571 | someone mailed to provide some context for your reply. The command | 4836 | someone mailed to provide some context for your reply. The command |
| @@ -4592,9 +4857,11 @@ followed by the content of the option | |||
| 4592 | @samp{wrote:}, @samp{a écrit:}, and @samp{schrieb:}. You can also use | 4857 | @samp{wrote:}, @samp{a écrit:}, and @samp{schrieb:}. You can also use |
| 4593 | the @samp{Custom String} menu item to enter your own verb. | 4858 | the @samp{Custom String} menu item to enter your own verb. |
| 4594 | 4859 | ||
| 4860 | @vindex mail-citation-hook | ||
| 4595 | @vindex mh-ins-buf-prefix | 4861 | @vindex mh-ins-buf-prefix |
| 4862 | @vindex mh-yank-behavior | ||
| 4596 | 4863 | ||
| 4597 | The prefix @samp{"> "} is the default setting for the option | 4864 | The prefix @code{"> "} is the default setting for the option |
| 4598 | @code{mh-ins-buf-prefix}. I suggest that you not modify this option | 4865 | @code{mh-ins-buf-prefix}. I suggest that you not modify this option |
| 4599 | since it is used by many mailers and news readers: messages are far | 4866 | since it is used by many mailers and news readers: messages are far |
| 4600 | easier to read if several included messages have all been indented by | 4867 | easier to read if several included messages have all been indented by |
| @@ -4608,9 +4875,11 @@ You can also turn on the @code{mh-delete-yanked-msg-window-flag} | |||
| 4608 | option to delete the window containing the original message after | 4875 | option to delete the window containing the original message after |
| 4609 | yanking it to make more room on your screen for your reply. | 4876 | yanking it to make more room on your screen for your reply. |
| 4610 | 4877 | ||
| 4611 | @vindex mh-yank-behavior | ||
| 4612 | @cindex Emacs, packages, supercite | 4878 | @cindex Emacs, packages, supercite |
| 4613 | @cindex supercite package | 4879 | @cindex supercite package |
| 4880 | @kindex r | ||
| 4881 | @vindex mail-citation-hook | ||
| 4882 | @vindex mh-yank-behavior | ||
| 4614 | 4883 | ||
| 4615 | You can control how the message to which you are replying is yanked | 4884 | You can control how the message to which you are replying is yanked |
| 4616 | into your reply using @code{mh-yank-behavior}. To include the entire | 4885 | into your reply using @code{mh-yank-behavior}. To include the entire |
| @@ -4628,11 +4897,16 @@ Choose @samp{Invoke supercite}@footnote{@emph{Supercite} is a | |||
| 4628 | full-bodied, full-featured, citation package that comes standard with | 4897 | full-bodied, full-featured, citation package that comes standard with |
| 4629 | Emacs.} to pass the entire message and header through supercite. | 4898 | Emacs.} to pass the entire message and header through supercite. |
| 4630 | 4899 | ||
| 4900 | @vindex mh-extract-from-attribution-verb | ||
| 4901 | |||
| 4631 | If the @samp{Body With Attribution} setting is used, then the message | 4902 | If the @samp{Body With Attribution} setting is used, then the message |
| 4632 | minus the header is yanked and a simple attribution line is added at | 4903 | minus the header is yanked and a simple attribution line is added at |
| 4633 | the top using the value of the option | 4904 | the top using the value of the option |
| 4634 | @code{mh-extract-from-attribution-verb}. This is the default. | 4905 | @code{mh-extract-from-attribution-verb}. This is the default. |
| 4635 | 4906 | ||
| 4907 | @kindex C-c C-y | ||
| 4908 | @vindex mh-delete-yanked-msg-window-flag | ||
| 4909 | |||
| 4636 | If the @samp{Invoke supercite} or @samp{Body With Attribution} | 4910 | If the @samp{Invoke supercite} or @samp{Body With Attribution} |
| 4637 | settings are used, the @samp{-noformat} argument is passed to the | 4911 | settings are used, the @samp{-noformat} argument is passed to the |
| 4638 | @command{repl} program to override a @samp{-filter} or @samp{-format} | 4912 | @command{repl} program to override a @samp{-filter} or @samp{-format} |
| @@ -4644,12 +4918,16 @@ People who use the automatic variants tend to turn on the option | |||
| 4644 | @code{mh-delete-yanked-msg-window-flag} as well so that the show | 4918 | @code{mh-delete-yanked-msg-window-flag} as well so that the show |
| 4645 | window is never displayed. | 4919 | window is never displayed. |
| 4646 | 4920 | ||
| 4921 | @vindex mh-yank-behavior | ||
| 4922 | |||
| 4647 | If the show buffer has a region, the option @code{mh-yank-behavior} is | 4923 | If the show buffer has a region, the option @code{mh-yank-behavior} is |
| 4648 | ignored unless its value is one of @samp{Attribution} variants in | 4924 | ignored unless its value is one of @samp{Attribution} variants in |
| 4649 | which case the attribution is added to the yanked region. | 4925 | which case the attribution is added to the yanked region. |
| 4650 | 4926 | ||
| 4651 | @findex trivial-cite | 4927 | @findex trivial-cite |
| 4652 | @vindex mail-citation-hook | 4928 | @vindex mail-citation-hook |
| 4929 | @vindex mh-ins-buf-prefix | ||
| 4930 | @vindex mh-yank-behavior | ||
| 4653 | 4931 | ||
| 4654 | If this isn't enough, you can gain full control over the appearance of | 4932 | If this isn't enough, you can gain full control over the appearance of |
| 4655 | the included text by setting @code{mail-citation-hook} to a function | 4933 | the included text by setting @code{mail-citation-hook} to a function |
| @@ -4661,6 +4939,10 @@ and it should leave point and mark around the modified citation text | |||
| 4661 | for the next hook function. The standard prefix | 4939 | for the next hook function. The standard prefix |
| 4662 | @code{mh-ins-buf-prefix} is not added if this hook is set. | 4940 | @code{mh-ins-buf-prefix} is not added if this hook is set. |
| 4663 | 4941 | ||
| 4942 | @cindex Emacs, packages, trivial-cite | ||
| 4943 | @cindex trivial-cite package | ||
| 4944 | @vindex mh-yank-behavior | ||
| 4945 | |||
| 4664 | For example, if you use the hook function | 4946 | For example, if you use the hook function |
| 4665 | @uref{http://shasta.cs.uiuc.edu/~lrclause/tc.html, | 4947 | @uref{http://shasta.cs.uiuc.edu/~lrclause/tc.html, |
| 4666 | @code{trivial-cite}} (which is NOT part of Emacs), set | 4948 | @code{trivial-cite}} (which is NOT part of Emacs), set |
| @@ -4675,6 +4957,7 @@ For example, if you use the hook function | |||
| 4675 | @kindex C-c C-i | 4957 | @kindex C-c C-i |
| 4676 | @vindex mh-ins-buf-prefix | 4958 | @vindex mh-ins-buf-prefix |
| 4677 | @vindex mh-invisible-header-fields-compiled | 4959 | @vindex mh-invisible-header-fields-compiled |
| 4960 | @vindex mh-yank-behavior | ||
| 4678 | 4961 | ||
| 4679 | Messages can be inserted with @kbd{C-c C-i} (@code{mh-insert-letter}). | 4962 | Messages can be inserted with @kbd{C-c C-i} (@code{mh-insert-letter}). |
| 4680 | This command prompts you for the folder and message number, which | 4963 | This command prompts you for the folder and message number, which |
| @@ -4701,8 +4984,8 @@ letter and point after it. | |||
| 4701 | You can insert your signature at the current cursor location with the | 4984 | You can insert your signature at the current cursor location with the |
| 4702 | command @kbd{C-c C-s} (@code{mh-insert-signature}). | 4985 | command @kbd{C-c C-s} (@code{mh-insert-signature}). |
| 4703 | 4986 | ||
| 4704 | @cindex @file{.signature} | ||
| 4705 | @cindex files, @file{.signature} | 4987 | @cindex files, @file{.signature} |
| 4988 | @cindex @file{.signature} | ||
| 4706 | @cindex vCard | 4989 | @cindex vCard |
| 4707 | @vindex mh-signature-file-name | 4990 | @vindex mh-signature-file-name |
| 4708 | 4991 | ||
| @@ -4712,6 +4995,7 @@ option @code{mh-signature-file-name}. This file may contain a | |||
| 4712 | @dfn{vCard} in which case an attachment is added with the vCard. | 4995 | @dfn{vCard} in which case an attachment is added with the vCard. |
| 4713 | 4996 | ||
| 4714 | @findex mh-signature-separator-p | 4997 | @findex mh-signature-separator-p |
| 4998 | @vindex mh-signature-file-name | ||
| 4715 | @vindex mh-signature-separator | 4999 | @vindex mh-signature-separator |
| 4716 | @vindex mh-signature-separator-regexp | 5000 | @vindex mh-signature-separator-regexp |
| 4717 | 5001 | ||
| @@ -4727,7 +5011,7 @@ if the buffer contains a separator, may be useful as well. | |||
| 4727 | @cindex signature separator | 5011 | @cindex signature separator |
| 4728 | @vindex mh-signature-separator-flag | 5012 | @vindex mh-signature-separator-flag |
| 4729 | 5013 | ||
| 4730 | A signature separator (@samp{"-- "}) will be added if the signature | 5014 | A signature separator (@code{"-- "}) will be added if the signature |
| 4731 | block does not contain one and @code{mh-signature-separator-flag} is | 5015 | block does not contain one and @code{mh-signature-separator-flag} is |
| 4732 | on. It is not recommended that you change this option since various | 5016 | on. It is not recommended that you change this option since various |
| 4733 | mail user agents, including MH-E, use the separator to present the | 5017 | mail user agents, including MH-E, use the separator to present the |
| @@ -4735,6 +5019,7 @@ signature differently, and to suppress the signature when replying or | |||
| 4735 | yanking a letter into a draft. | 5019 | yanking a letter into a draft. |
| 4736 | 5020 | ||
| 4737 | @vindex mh-insert-signature-hook | 5021 | @vindex mh-insert-signature-hook |
| 5022 | @vindex mh-signature-file-name | ||
| 4738 | 5023 | ||
| 4739 | The hook @code{mh-insert-signature-hook} is run after the signature is | 5024 | The hook @code{mh-insert-signature-hook} is run after the signature is |
| 4740 | inserted. Hook functions may access the actual name of the file or the | 5025 | inserted. Hook functions may access the actual name of the file or the |
| @@ -4786,6 +5071,8 @@ resolution, color, @samp{Face:} header field. | |||
| 4786 | The URL of any image can be used for the @samp{X-Image-URL:} field and | 5071 | The URL of any image can be used for the @samp{X-Image-URL:} field and |
| 4787 | no processing of the image is required. | 5072 | no processing of the image is required. |
| 4788 | 5073 | ||
| 5074 | @vindex mh-x-face-file | ||
| 5075 | |||
| 4789 | To prevent the setting of any of these header fields, either set | 5076 | To prevent the setting of any of these header fields, either set |
| 4790 | @code{mh-x-face-file} to @code{nil}, or simply ensure that the file | 5077 | @code{mh-x-face-file} to @code{nil}, or simply ensure that the file |
| 4791 | defined by this option doesn't exist. | 5078 | defined by this option doesn't exist. |
| @@ -4810,6 +5097,8 @@ protocol@footnote{@sc{mime} is defined in | |||
| 4810 | binary files, and even commands that fetch a file with @samp{ftp} when | 5097 | binary files, and even commands that fetch a file with @samp{ftp} when |
| 4811 | your recipient reads the message! | 5098 | your recipient reads the message! |
| 4812 | 5099 | ||
| 5100 | @kindex C-c C-m | ||
| 5101 | |||
| 4813 | If you were to create a multimedia message with plain MH commands, you | 5102 | If you were to create a multimedia message with plain MH commands, you |
| 4814 | would insert @command{mhbuild} or @command{mhn} directives (henceforth | 5103 | would insert @command{mhbuild} or @command{mhn} directives (henceforth |
| 4815 | called @dfn{MH-style directives} into your draft and use the | 5104 | called @dfn{MH-style directives} into your draft and use the |
| @@ -4855,8 +5144,8 @@ whereas others require you to enter one. | |||
| 4855 | 5144 | ||
| 4856 | @cindex @command{file} | 5145 | @cindex @command{file} |
| 4857 | @cindex @file{/etc/mime.types} | 5146 | @cindex @file{/etc/mime.types} |
| 4858 | @cindex Unix commands, @command{file} | ||
| 4859 | @cindex files, @file{/etc/mime.types} | 5147 | @cindex files, @file{/etc/mime.types} |
| 5148 | @cindex Unix commands, @command{file} | ||
| 4860 | @findex mailcap-mime-types | 5149 | @findex mailcap-mime-types |
| 4861 | 5150 | ||
| 4862 | In the cases where MH-E can do so, it will determine the media type | 5151 | In the cases where MH-E can do so, it will determine the media type |
| @@ -4936,16 +5225,17 @@ You may also be interested in investigating @code{sgml-mode}. | |||
| 4936 | 5225 | ||
| 4937 | @subheading Including Files | 5226 | @subheading Including Files |
| 4938 | 5227 | ||
| 5228 | @cindex attachments, inserting | ||
| 5229 | @cindex images | ||
| 4939 | @cindex MIME, images | 5230 | @cindex MIME, images |
| 4940 | @cindex MIME, sound | 5231 | @cindex MIME, sound |
| 4941 | @cindex MIME, video | 5232 | @cindex MIME, video |
| 4942 | @cindex attachments, inserting | ||
| 4943 | @cindex images | ||
| 4944 | @cindex sound | 5233 | @cindex sound |
| 4945 | @cindex video | 5234 | @cindex video |
| 4946 | @findex mh-compose-insertion | 5235 | @findex mh-compose-insertion |
| 4947 | @kindex C-c C-m C-i | 5236 | @kindex C-c C-m C-i |
| 4948 | @kindex C-c C-m i | 5237 | @kindex C-c C-m i |
| 5238 | @vindex mh-compose-insertion | ||
| 4949 | 5239 | ||
| 4950 | Binaries, images, sound, and video can be inserted in your message | 5240 | Binaries, images, sound, and video can be inserted in your message |
| 4951 | with the command @kbd{C-c C-m C-i} (@code{mh-compose-insertion}). You | 5241 | with the command @kbd{C-c C-m C-i} (@code{mh-compose-insertion}). You |
| @@ -4988,7 +5278,9 @@ host and filename, the media type, and the content description. | |||
| 4988 | @cindex MIME, @command{tar} | 5278 | @cindex MIME, @command{tar} |
| 4989 | @cindex Unix commands, @command{ftp} | 5279 | @cindex Unix commands, @command{ftp} |
| 4990 | @cindex Unix commands, @command{tar} | 5280 | @cindex Unix commands, @command{tar} |
| 5281 | @findex mh-mh-compose-anon-ftp | ||
| 4991 | @findex mh-mh-compose-external-compressed-tar | 5282 | @findex mh-mh-compose-external-compressed-tar |
| 5283 | @kindex C-c C-m C-g | ||
| 4992 | @kindex C-c C-m C-t | 5284 | @kindex C-c C-m C-t |
| 4993 | @kindex C-c C-m t | 5285 | @kindex C-c C-m t |
| 4994 | 5286 | ||
| @@ -5049,6 +5341,9 @@ disposition=inline description="SETI@@home logo"> | |||
| 5049 | Typically, you send a message with attachments just like any other | 5341 | Typically, you send a message with attachments just like any other |
| 5050 | message (@pxref{Sending Message}). | 5342 | message (@pxref{Sending Message}). |
| 5051 | 5343 | ||
| 5344 | @findex mh-mml-to-mime | ||
| 5345 | @kindex C-c C-m C-m | ||
| 5346 | |||
| 5052 | However, you may take a sneak preview of the @sc{mime} encoding if you | 5347 | However, you may take a sneak preview of the @sc{mime} encoding if you |
| 5053 | wish by running the command @kbd{C-c C-m C-m} (@code{mh-mml-to-mime}). | 5348 | wish by running the command @kbd{C-c C-m C-m} (@code{mh-mml-to-mime}). |
| 5054 | The following screen shows the @sc{mime} encoding specified by the | 5349 | The following screen shows the @sc{mime} encoding specified by the |
| @@ -5081,15 +5376,19 @@ LyogWFBNICovCnN0YXRpYyBjaGFyICogc2V0aWF0aG9tZV94cG1bXSA9IHsKIjQ1IDQ1IDc2NCAy | |||
| 5081 | @end cartouche | 5376 | @end cartouche |
| 5082 | @i{MH-E @sc{mime} draft ready to send} | 5377 | @i{MH-E @sc{mime} draft ready to send} |
| 5083 | 5378 | ||
| 5379 | @cindex undo effects of mh-mml-to-mime | ||
| 5380 | |||
| 5084 | This action can be undone by running @kbd{C-_} (@code{undo}). | 5381 | This action can be undone by running @kbd{C-_} (@code{undo}). |
| 5085 | 5382 | ||
| 5086 | @cindex @command{mhbuild} | 5383 | @cindex @command{mhbuild} |
| 5087 | @cindex @command{mhn} | 5384 | @cindex @command{mhn} |
| 5088 | @cindex MH commands, @command{mhbuild} | 5385 | @cindex MH commands, @command{mhbuild} |
| 5089 | @cindex MH commands, @command{mhn} | 5386 | @cindex MH commands, @command{mhn} |
| 5387 | @cindex undo effects of mh-mh-to-mime | ||
| 5090 | @findex mh-mh-to-mime | 5388 | @findex mh-mh-to-mime |
| 5091 | @findex mh-mh-to-mime-undo | 5389 | @findex mh-mh-to-mime-undo |
| 5092 | @kindex C-c C-e | 5390 | @kindex C-c C-e |
| 5391 | @kindex C-c C-m C-m | ||
| 5093 | @kindex C-c C-m C-u | 5392 | @kindex C-c C-m C-u |
| 5094 | @kindex C-c C-m u | 5393 | @kindex C-c C-m u |
| 5095 | 5394 | ||
| @@ -5104,6 +5403,7 @@ file. You are prompted to confirm this action, but you can avoid the | |||
| 5104 | confirmation by adding an argument (for example, @kbd{C-u C-c C-m | 5403 | confirmation by adding an argument (for example, @kbd{C-u C-c C-m |
| 5105 | C-u}). | 5404 | C-u}). |
| 5106 | 5405 | ||
| 5406 | @kindex C-c C-e | ||
| 5107 | @vindex mh-mh-to-mime-args | 5407 | @vindex mh-mh-to-mime-args |
| 5108 | 5408 | ||
| 5109 | If you wish to pass additional arguments to @command{mhbuild} | 5409 | If you wish to pass additional arguments to @command{mhbuild} |
| @@ -5113,13 +5413,14 @@ check into the message by setting @code{mh-mh-to-mime-args} to | |||
| 5113 | @samp{-check}. The recipient of your message can then run | 5413 | @samp{-check}. The recipient of your message can then run |
| 5114 | @samp{mhbuild -check} on the message---@command{mhbuild} | 5414 | @samp{mhbuild -check} on the message---@command{mhbuild} |
| 5115 | (@command{mhn}) will complain if the message has been corrupted on the | 5415 | (@command{mhn}) will complain if the message has been corrupted on the |
| 5116 | way. The command @kbd{C-c C-e} (@code{mh-mh-to-mime}) only consults | 5416 | way. The command @kbd{C-c C-e} only consults this option when given a |
| 5117 | this option when given a prefix argument (as in @kbd{C-u C-c C-e}). | 5417 | prefix argument (as in @kbd{C-u C-c C-e}). |
| 5118 | 5418 | ||
| 5419 | @kindex C-c C-e | ||
| 5119 | @vindex mh-mh-to-mime-hook | 5420 | @vindex mh-mh-to-mime-hook |
| 5120 | 5421 | ||
| 5121 | The hook @code{mh-mh-to-mime-hook} is called after the message has | 5422 | The hook @code{mh-mh-to-mime-hook} is called after the message has |
| 5122 | been formatted by @kbd{C-c C-e} (@code{mh-mh-to-mime}) | 5423 | been formatted by @kbd{C-c C-e}. |
| 5123 | 5424 | ||
| 5124 | @node Sending PGP, Checking Recipients, Adding Attachments, Editing Drafts | 5425 | @node Sending PGP, Checking Recipients, Adding Attachments, Editing Drafts |
| 5125 | @section Signing and Encrypting Messages | 5426 | @section Signing and Encrypting Messages |
| @@ -5169,6 +5470,7 @@ following tag: | |||
| 5169 | @findex mh-mml-unsecure-message | 5470 | @findex mh-mml-unsecure-message |
| 5170 | @kindex C-c C-m C-n | 5471 | @kindex C-c C-m C-n |
| 5171 | @kindex C-c C-m n | 5472 | @kindex C-c C-m n |
| 5473 | @vindex mh-mml-method-default | ||
| 5172 | 5474 | ||
| 5173 | This is used to sign and encrypt your message. In each of these cases, | 5475 | This is used to sign and encrypt your message. In each of these cases, |
| 5174 | a proper multipart message is created for you when you send the | 5476 | a proper multipart message is created for you when you send the |
| @@ -5202,8 +5504,8 @@ See | |||
| 5202 | @cite{The PGG Manual}}. | 5504 | @cite{The PGG Manual}}. |
| 5203 | @end ifhtml | 5505 | @end ifhtml |
| 5204 | 5506 | ||
| 5205 | @cindex @samp{Fcc:} header field | ||
| 5206 | @cindex header field, @samp{Fcc:} | 5507 | @cindex header field, @samp{Fcc:} |
| 5508 | @cindex @samp{Fcc:} header field | ||
| 5207 | @vindex pgg-encrypt-for-me | 5509 | @vindex pgg-encrypt-for-me |
| 5208 | 5510 | ||
| 5209 | In particular, I turn on the option @code{pgg-encrypt-for-me} so that | 5511 | In particular, I turn on the option @code{pgg-encrypt-for-me} so that |
| @@ -5233,8 +5535,8 @@ whatnow Program} in the MH book.}. | |||
| 5233 | @node Sending Message, Killing Draft, Checking Recipients, Editing Drafts | 5535 | @node Sending Message, Killing Draft, Checking Recipients, Editing Drafts |
| 5234 | @section Sending a Message | 5536 | @section Sending a Message |
| 5235 | 5537 | ||
| 5236 | @cindex @samp{*MH-E Mail Delivery*} | ||
| 5237 | @cindex buffers, @samp{*MH-E Mail Delivery*} | 5538 | @cindex buffers, @samp{*MH-E Mail Delivery*} |
| 5539 | @cindex @samp{*MH-E Mail Delivery*} | ||
| 5238 | @cindex sending mail | 5540 | @cindex sending mail |
| 5239 | @findex mh-send-letter | 5541 | @findex mh-send-letter |
| 5240 | @kindex C-c C-c | 5542 | @kindex C-c C-c |
| @@ -5247,6 +5549,8 @@ Delivery*} (@pxref{Miscellaneous}). | |||
| 5247 | 5549 | ||
| 5248 | @cindex sending mail | 5550 | @cindex sending mail |
| 5249 | @cindex spell check | 5551 | @cindex spell check |
| 5552 | @findex ispell-message | ||
| 5553 | @kindex C-c C-c | ||
| 5250 | @vindex mh-before-send-letter-hook | 5554 | @vindex mh-before-send-letter-hook |
| 5251 | 5555 | ||
| 5252 | The hook @code{mh-before-send-letter-hook} is run at the beginning of | 5556 | The hook @code{mh-before-send-letter-hook} is run at the beginning of |
| @@ -5350,7 +5654,7 @@ If @samp{on}, local users are added to alias completion (default: | |||
| 5350 | @c ------------------------- | 5654 | @c ------------------------- |
| 5351 | @item mh-alias-local-users-prefix | 5655 | @item mh-alias-local-users-prefix |
| 5352 | String prefixed to the real names of users from the password file | 5656 | String prefixed to the real names of users from the password file |
| 5353 | (default: @samp{"local."}. | 5657 | (default: @code{"local."}. |
| 5354 | @c ------------------------- | 5658 | @c ------------------------- |
| 5355 | @item mh-alias-passwd-gecos-comma-separator-flag | 5659 | @item mh-alias-passwd-gecos-comma-separator-flag |
| 5356 | On means the GECOS field in the password file uses a comma separator | 5660 | On means the GECOS field in the password file uses a comma separator |
| @@ -5365,12 +5669,14 @@ Hook run by @code{mh-alias-reload} after loading aliases (default: | |||
| 5365 | @code{nil}). | 5669 | @code{nil}). |
| 5366 | @end vtable | 5670 | @end vtable |
| 5367 | 5671 | ||
| 5368 | @heading Adding Addresses to Draft | 5672 | @subheading Adding Addresses to Draft |
| 5369 | 5673 | ||
| 5370 | You can use aliases when you are adding recipients to a message. | 5674 | You can use aliases when you are adding recipients to a message. |
| 5371 | 5675 | ||
| 5372 | @findex minibuffer-complete | 5676 | @findex minibuffer-complete |
| 5373 | @kindex @key{TAB} | 5677 | @kindex @key{TAB} |
| 5678 | @vindex mh-alias-expand-aliases-flag | ||
| 5679 | @vindex mh-compose-prompt-flag | ||
| 5374 | 5680 | ||
| 5375 | In order to use minibuffer prompting for recipients and the subject | 5681 | In order to use minibuffer prompting for recipients and the subject |
| 5376 | line in the minibuffer, turn on the option | 5682 | line in the minibuffer, turn on the option |
| @@ -5380,10 +5686,17 @@ line in the minibuffer, turn on the option | |||
| 5380 | on the option @code{mh-alias-expand-aliases-flag} if you want these | 5686 | on the option @code{mh-alias-expand-aliases-flag} if you want these |
| 5381 | aliases to be expanded to their respective addresses in the draft. | 5687 | aliases to be expanded to their respective addresses in the draft. |
| 5382 | 5688 | ||
| 5689 | @findex mh-letter-complete | ||
| 5690 | @findex mh-letter-complete-or-space | ||
| 5691 | @kindex @key{SPC} | ||
| 5692 | @kindex M-@key{TAB} | ||
| 5693 | |||
| 5383 | Otherwise, you can complete aliases in the header of the draft with | 5694 | Otherwise, you can complete aliases in the header of the draft with |
| 5384 | @kbd{M-@key{TAB}} (@code{mh-letter-complete}) or @key{SPC} | 5695 | @kbd{M-@key{TAB}} (@code{mh-letter-complete}) or @key{SPC} |
| 5385 | (@code{mh-letter-complete-or-space}). | 5696 | (@code{mh-letter-complete-or-space}). |
| 5386 | 5697 | ||
| 5698 | @vindex mh-alias-completion-ignore-case-flag | ||
| 5699 | |||
| 5387 | As MH ignores case in the aliases, so too does MH-E. However, you may | 5700 | As MH ignores case in the aliases, so too does MH-E. However, you may |
| 5388 | turn off the option @code{mh-alias-completion-ignore-case-flag} to | 5701 | turn off the option @code{mh-alias-completion-ignore-case-flag} to |
| 5389 | make case significant which can be used to segregate completion of | 5702 | make case significant which can be used to segregate completion of |
| @@ -5402,6 +5715,11 @@ you'd get Mark's address. Note that this option affects completion | |||
| 5402 | only. If you were to enter @kbd{Mark.Baushke}, it would still be | 5715 | only. If you were to enter @kbd{Mark.Baushke}, it would still be |
| 5403 | identified with your @samp{mark.baushke} alias. | 5716 | identified with your @samp{mark.baushke} alias. |
| 5404 | 5717 | ||
| 5718 | @findex mh-alias-minibuffer-confirm-address | ||
| 5719 | @findex mh-letter-confirm-address | ||
| 5720 | @vindex mh-alias-flash-on-comma | ||
| 5721 | @vindex mh-compose-prompt-flag | ||
| 5722 | |||
| 5405 | To verify that the alias you've entered is valid, the alias will be | 5723 | To verify that the alias you've entered is valid, the alias will be |
| 5406 | displayed in the minibuffer when you type a comma | 5724 | displayed in the minibuffer when you type a comma |
| 5407 | (@code{mh-letter-confirm-address} or | 5725 | (@code{mh-letter-confirm-address} or |
| @@ -5415,7 +5733,7 @@ Alias}, and @samp{Don't Flash Nor Warn If No Alias}. | |||
| 5415 | For another way to verify the alias expansion, see @ref{Checking | 5733 | For another way to verify the alias expansion, see @ref{Checking |
| 5416 | Recipients}. | 5734 | Recipients}. |
| 5417 | 5735 | ||
| 5418 | @heading Loading Aliases | 5736 | @subheading Loading Aliases |
| 5419 | 5737 | ||
| 5420 | @cindex @command{ali} | 5738 | @cindex @command{ali} |
| 5421 | @cindex @file{/etc/nmh/MailAliases} | 5739 | @cindex @file{/etc/nmh/MailAliases} |
| @@ -5441,6 +5759,8 @@ These aliases have the form @samp{local.@var{first.last}} if a real | |||
| 5441 | name is present in the password file. Otherwise, the alias will have | 5759 | name is present in the password file. Otherwise, the alias will have |
| 5442 | the form @samp{local.@var{login}}. | 5760 | the form @samp{local.@var{login}}. |
| 5443 | 5761 | ||
| 5762 | @vindex mh-alias-local-users-prefix | ||
| 5763 | |||
| 5444 | The prefix @samp{local.} can be modified via the option | 5764 | The prefix @samp{local.} can be modified via the option |
| 5445 | @code{mh-alias-local-users-prefix}. This option can also be set to | 5765 | @code{mh-alias-local-users-prefix}. This option can also be set to |
| 5446 | @samp{Use Login}. | 5766 | @samp{Use Login}. |
| @@ -5451,6 +5771,8 @@ For example, consider the following password file entry: | |||
| 5451 | psg:x:1000:1000:Peter S Galbraith,,,:/home/psg:/bin/tcsh | 5771 | psg:x:1000:1000:Peter S Galbraith,,,:/home/psg:/bin/tcsh |
| 5452 | @end example | 5772 | @end example |
| 5453 | 5773 | ||
| 5774 | @vindex mh-alias-local-users-prefix | ||
| 5775 | |||
| 5454 | The following settings of option @code{mh-alias-local-users-prefix} | 5776 | The following settings of option @code{mh-alias-local-users-prefix} |
| 5455 | will produce the associated aliases: | 5777 | will produce the associated aliases: |
| 5456 | 5778 | ||
| @@ -5465,6 +5787,8 @@ peter.galbraith | |||
| 5465 | psg | 5787 | psg |
| 5466 | @end table | 5788 | @end table |
| 5467 | 5789 | ||
| 5790 | @vindex mh-alias-passwd-gecos-comma-separator-flag | ||
| 5791 | |||
| 5468 | In the example above, commas are used to separate different values | 5792 | In the example above, commas are used to separate different values |
| 5469 | within the so-called GECOS field. This is a fairly common usage. | 5793 | within the so-called GECOS field. This is a fairly common usage. |
| 5470 | However, in the rare case that the GECOS field in your password file | 5794 | However, in the rare case that the GECOS field in your password file |
| @@ -5472,8 +5796,9 @@ is not separated by commas and whose contents may contain commas, you | |||
| 5472 | can turn the option @code{mh-alias-passwd-gecos-comma-separator-flag} | 5796 | can turn the option @code{mh-alias-passwd-gecos-comma-separator-flag} |
| 5473 | off. | 5797 | off. |
| 5474 | 5798 | ||
| 5475 | @cindex @samp{ypcat passwd} | ||
| 5476 | @cindex NIS, obtaining local aliases from | 5799 | @cindex NIS, obtaining local aliases from |
| 5800 | @cindex @samp{ypcat passwd} | ||
| 5801 | @vindex mh-alias-local-users | ||
| 5477 | 5802 | ||
| 5478 | If you're on a system with thousands of users you don't know, and the | 5803 | If you're on a system with thousands of users you don't know, and the |
| 5479 | loading of local aliases slows MH-E down noticeably, then the local | 5804 | loading of local aliases slows MH-E down noticeably, then the local |
| @@ -5482,18 +5807,25 @@ alias feature can be disabled by turning off the option | |||
| 5482 | executed to generate the password file. For example, use @samp{ypcat | 5807 | executed to generate the password file. For example, use @samp{ypcat |
| 5483 | passwd} to obtain the NIS password file. | 5808 | passwd} to obtain the NIS password file. |
| 5484 | 5809 | ||
| 5810 | @findex mh-alias-reload | ||
| 5811 | @kindex M-x mh-alias-reload | ||
| 5812 | @vindex mh-alias-reloaded-hook | ||
| 5813 | |||
| 5485 | Since aliases are updated frequently, MH-E reloads aliases | 5814 | Since aliases are updated frequently, MH-E reloads aliases |
| 5486 | automatically whenever an alias lookup occurs if an alias source has | 5815 | automatically whenever an alias lookup occurs if an alias source has |
| 5487 | changed. However, you can reload your aliases manually by calling the | 5816 | changed. However, you can reload your aliases manually by calling the |
| 5488 | command @kbd{M-x mh-alias-reload} directly. This command runs | 5817 | command @kbd{M-x mh-alias-reload} directly. This command runs |
| 5489 | @code{mh-alias-reloaded-hook} after the aliases have been loaded. | 5818 | @code{mh-alias-reloaded-hook} after the aliases have been loaded. |
| 5490 | 5819 | ||
| 5491 | @heading Adding Aliases | 5820 | @subheading Adding Aliases |
| 5492 | 5821 | ||
| 5493 | In the past, you have manually added aliases to your alias file(s) | 5822 | In the past, you have manually added aliases to your alias file(s) |
| 5494 | listed in your @samp{Aliasfile:} profile component. MH-E provides | 5823 | listed in your @samp{Aliasfile:} profile component. MH-E provides |
| 5495 | other methods for maintaining your alias file(s). | 5824 | other methods for maintaining your alias file(s). |
| 5496 | 5825 | ||
| 5826 | @findex mh-alias-add-alias | ||
| 5827 | @kindex M-x mh-alias-add-alias | ||
| 5828 | |||
| 5497 | You can use the @kbd{M-x mh-alias-add-alias} command which will prompt | 5829 | You can use the @kbd{M-x mh-alias-add-alias} command which will prompt |
| 5498 | you for the alias and address that you would like to add. If the alias | 5830 | you for the alias and address that you would like to add. If the alias |
| 5499 | exists already, you will have the choice of inserting the new alias | 5831 | exists already, you will have the choice of inserting the new alias |
| @@ -5525,6 +5857,9 @@ Using prefixes instead of postfixes helps you explore aliases during | |||
| 5525 | completion. If you forget the name of an old dive buddy, you can enter | 5857 | completion. If you forget the name of an old dive buddy, you can enter |
| 5526 | @samp{div} and then @key{SPC} to get a listing of all your dive buddies. | 5858 | @samp{div} and then @key{SPC} to get a listing of all your dive buddies. |
| 5527 | 5859 | ||
| 5860 | @kindex M-x mh-alias-add-address-under-point | ||
| 5861 | @kindex M-x mh-alias-grab-from-field | ||
| 5862 | |||
| 5528 | An alias for the sender of the current message is added automatically | 5863 | An alias for the sender of the current message is added automatically |
| 5529 | by clicking on the @samp{Grab From alias} tool bar button or by running | 5864 | by clicking on the @samp{Grab From alias} tool bar button or by running |
| 5530 | the @kbd{M-x mh-alias-grab-from-field} command. Aliases for other | 5865 | the @kbd{M-x mh-alias-grab-from-field} command. Aliases for other |
| @@ -5532,24 +5867,33 @@ recipients of the current message are added by placing your cursor | |||
| 5532 | over the desired recipient and giving the @kbd{M-x | 5867 | over the desired recipient and giving the @kbd{M-x |
| 5533 | mh-alias-add-address-under-point} command. | 5868 | mh-alias-add-address-under-point} command. |
| 5534 | 5869 | ||
| 5870 | @vindex mh-alias-insert-file | ||
| 5871 | @vindex mh-alias-insertion-location | ||
| 5872 | |||
| 5535 | The options @code{mh-alias-insert-file} and | 5873 | The options @code{mh-alias-insert-file} and |
| 5536 | @code{mh-alias-insertion-location} controls how and where these aliases | 5874 | @code{mh-alias-insertion-location} controls how and where these aliases |
| 5537 | are inserted. | 5875 | are inserted. |
| 5538 | 5876 | ||
| 5539 | The default setting of this option is @samp{Use Aliasfile Profile | 5877 | @vindex mh-alias-insert-file |
| 5540 | Component}. This option can also hold the name of a file or a list a | 5878 | |
| 5541 | file names. If this option is set to a list of file names, or the | 5879 | The default setting of option @code{mh-alias-insert-file} is @samp{Use |
| 5542 | @samp{Aliasfile:} profile component contains more than one file name, | 5880 | Aliasfile Profile Component}. This option can also hold the name of a |
| 5543 | MH-E will prompt for one of them. | 5881 | file or a list a file names. If this option is set to a list of file |
| 5882 | names, or the @samp{Aliasfile:} profile component contains more than | ||
| 5883 | one file name, MH-E will prompt for one of them. | ||
| 5884 | |||
| 5885 | @vindex mh-alias-insertion-location | ||
| 5544 | 5886 | ||
| 5545 | The option @code{mh-alias-insertion-location} is set to | 5887 | The option @code{mh-alias-insertion-location} is set to |
| 5546 | @samp{Alphabetical} by default. If you organize your alias file in | 5888 | @samp{Alphabetical} by default. If you organize your alias file in |
| 5547 | other ways, then the settings @samp{Top} and @samp{Bottom} might be | 5889 | other ways, then the settings @samp{Top} and @samp{Bottom} might be |
| 5548 | more appropriate. | 5890 | more appropriate. |
| 5549 | 5891 | ||
| 5550 | @heading Querying Aliases | 5892 | @subheading Querying Aliases |
| 5551 | 5893 | ||
| 5552 | @cindex regular expressions, @code{mh-alias-apropos} | 5894 | @cindex regular expressions, @code{mh-alias-apropos} |
| 5895 | @findex mh-alias-apropos | ||
| 5896 | @kindex M-x mh-alias-apropos | ||
| 5553 | 5897 | ||
| 5554 | If you can't quite remember an alias, you can use @kbd{M-x | 5898 | If you can't quite remember an alias, you can use @kbd{M-x |
| 5555 | mh-alias-apropos} to show all aliases or addresses that match a | 5899 | mh-alias-apropos} to show all aliases or addresses that match a |
| @@ -5575,6 +5919,9 @@ MH-E supports the concept of multiple personalities or identities. | |||
| 5575 | This means that you can easily have a different header and signature | 5919 | This means that you can easily have a different header and signature |
| 5576 | at home and at work. | 5920 | at home and at work. |
| 5577 | 5921 | ||
| 5922 | @cindex @samp{Identity} menu | ||
| 5923 | @cindex menu, @samp{Identity} | ||
| 5924 | |||
| 5578 | A couple of commands are used to insert identities in MH-Letter mode | 5925 | A couple of commands are used to insert identities in MH-Letter mode |
| 5579 | which are also found in the @samp{Identity} menu. | 5926 | which are also found in the @samp{Identity} menu. |
| 5580 | 5927 | ||
| @@ -5623,6 +5970,8 @@ Some of the common header fields that people change depending on the | |||
| 5623 | context are the @samp{From:} and @samp{Organization:} fields, as well | 5970 | context are the @samp{From:} and @samp{Organization:} fields, as well |
| 5624 | as the signature. | 5971 | as the signature. |
| 5625 | 5972 | ||
| 5973 | @vindex mh-identity-list | ||
| 5974 | |||
| 5626 | This is done by customizing the option @code{mh-identity-list}. In the | 5975 | This is done by customizing the option @code{mh-identity-list}. In the |
| 5627 | customization buffer for this option, click on the @samp{INS} button | 5976 | customization buffer for this option, click on the @samp{INS} button |
| 5628 | and enter a label such as @samp{Home} or @samp{Work}. Then click on | 5977 | and enter a label such as @samp{Home} or @samp{Work}. Then click on |
| @@ -5666,18 +6015,21 @@ Specify a different key to sign or encrypt messages. | |||
| 5666 | 6015 | ||
| 5667 | @cindex Identity menu | 6016 | @cindex Identity menu |
| 5668 | @cindex menu, Identity | 6017 | @cindex menu, Identity |
| 6018 | @findex mh-insert-identity | ||
| 6019 | @kindex C-c C-d | ||
| 5669 | 6020 | ||
| 5670 | You can select the identities you have added via the menu called | 6021 | You can select the identities you have added via the menu called |
| 5671 | @samp{Identity} in the MH-Letter buffer. You can also use @kbd{C-c | 6022 | @samp{Identity} in the MH-Letter buffer. You can also use @kbd{C-c |
| 5672 | C-d} (@code{mh-insert-identity}). To clear the fields and signature | 6023 | C-d} (@code{mh-insert-identity}). To clear the fields and signature |
| 5673 | added by the identity, select the @samp{None} identity. | 6024 | added by the identity, select the @samp{None} identity. |
| 5674 | 6025 | ||
| 5675 | @cindex @samp{Identity > Save as Default} menu item | 6026 | @cindex menu item, @samp{Identity > Customize Identities} |
| 5676 | @cindex menu item, @samp{Identity > Save as Default} | 6027 | @cindex menu item, @samp{Identity > Save as Default} |
| 5677 | @cindex @samp{Identity > Set Default for Session} menu item | ||
| 5678 | @cindex menu item, @samp{Identity > Set Default for Session} | 6028 | @cindex menu item, @samp{Identity > Set Default for Session} |
| 5679 | @cindex @samp{Identity > Customize Identities} menu item | 6029 | @cindex @samp{Identity > Customize Identities} menu item |
| 5680 | @cindex menu item, @samp{Identity > Customize Identities} | 6030 | @cindex @samp{Identity > Save as Default} menu item |
| 6031 | @cindex @samp{Identity > Set Default for Session} menu item | ||
| 6032 | @vindex mh-identity-default | ||
| 5681 | 6033 | ||
| 5682 | The @samp{Identity} menu contains two other items to save you from | 6034 | The @samp{Identity} menu contains two other items to save you from |
| 5683 | having to set the identity on every message. The menu item @samp{Set | 6035 | having to set the identity on every message. The menu item @samp{Set |
| @@ -5690,6 +6042,7 @@ need to add another identity, the menu item @samp{Customize | |||
| 5690 | Identities} is available for your convenience. | 6042 | Identities} is available for your convenience. |
| 5691 | 6043 | ||
| 5692 | @cindex regular expressions, @code{mh-auto-fields-list} | 6044 | @cindex regular expressions, @code{mh-auto-fields-list} |
| 6045 | @vindex mh-auto-fields-list | ||
| 5693 | 6046 | ||
| 5694 | The option @code{mh-auto-fields-list} can also be used to set the | 6047 | The option @code{mh-auto-fields-list} can also be used to set the |
| 5695 | identity depending on the recipient to provide even more control. To | 6048 | identity depending on the recipient to provide even more control. To |
| @@ -5738,6 +6091,10 @@ reply. | |||
| 5738 | Other header fields may be added using this menu item. | 6091 | Other header fields may be added using this menu item. |
| 5739 | @end table | 6092 | @end table |
| 5740 | 6093 | ||
| 6094 | @findex mh-insert-auto-fields | ||
| 6095 | @kindex C-c M-d | ||
| 6096 | @vindex mh-auto-fields-prompt-flag | ||
| 6097 | |||
| 5741 | These fields can only be added after the recipient is known. Because | 6098 | These fields can only be added after the recipient is known. Because |
| 5742 | you can continue to add recipients as you edit the draft, MH-E waits | 6099 | you can continue to add recipients as you edit the draft, MH-E waits |
| 5743 | until the message is sent to perform the auto-insertions. This seems | 6100 | until the message is sent to perform the auto-insertions. This seems |
| @@ -5754,10 +6111,16 @@ the header contains one or more recipients, you may run the command | |||
| 5754 | manually. However, if you use this command, the automatic insertion | 6111 | manually. However, if you use this command, the automatic insertion |
| 5755 | when the message is sent is disabled. | 6112 | when the message is sent is disabled. |
| 5756 | 6113 | ||
| 6114 | @vindex mh-auto-fields-list | ||
| 6115 | @vindex mh-identity-list | ||
| 6116 | |||
| 5757 | You should avoid using the same header field in | 6117 | You should avoid using the same header field in |
| 5758 | @code{mh-auto-fields-list} and @code{mh-identity-list} definitions | 6118 | @code{mh-auto-fields-list} and @code{mh-identity-list} definitions |
| 5759 | that may apply to the same message as the result is undefined. | 6119 | that may apply to the same message as the result is undefined. |
| 5760 | 6120 | ||
| 6121 | @vindex mh-identity-handlers | ||
| 6122 | @vindex mh-identity-list | ||
| 6123 | |||
| 5761 | The option @code{mh-identity-handlers} is used to change the way that | 6124 | The option @code{mh-identity-handlers} is used to change the way that |
| 5762 | fields, signatures, and attributions in @code{mh-identity-list} are | 6125 | fields, signatures, and attributions in @code{mh-identity-list} are |
| 5763 | added. To customize @code{mh-identity-handlers}, replace the name of | 6126 | added. To customize @code{mh-identity-handlers}, replace the name of |
| @@ -5766,6 +6129,8 @@ change with the name of a function you have written. You can also | |||
| 5766 | click on an @samp{INS} button and insert a field of your choice and | 6129 | click on an @samp{INS} button and insert a field of your choice and |
| 5767 | the name of the function you have written to handle it. | 6130 | the name of the function you have written to handle it. |
| 5768 | 6131 | ||
| 6132 | @vindex mh-identity-list | ||
| 6133 | |||
| 5769 | The @samp{Field} field can be any field that you've used in your | 6134 | The @samp{Field} field can be any field that you've used in your |
| 5770 | @code{mh-identity-list}. The special fields @samp{:attribution-verb}, | 6135 | @code{mh-identity-list}. The special fields @samp{:attribution-verb}, |
| 5771 | @samp{:signature}, or @samp{:pgg-default-user-id} are used for the | 6136 | @samp{:signature}, or @samp{:pgg-default-user-id} are used for the |
| @@ -5786,6 +6151,10 @@ containing the value for the field is given. | |||
| 5786 | 6151 | ||
| 5787 | @cindex folder navigation | 6152 | @cindex folder navigation |
| 5788 | @cindex speedbar | 6153 | @cindex speedbar |
| 6154 | @findex mh-visit-folder | ||
| 6155 | @kindex F v | ||
| 6156 | @kindex M-x speedbar | ||
| 6157 | @kindex Mouse-2 | ||
| 5789 | 6158 | ||
| 5790 | You can also use the speedbar | 6159 | You can also use the speedbar |
| 5791 | @ifnothtml | 6160 | @ifnothtml |
| @@ -5832,6 +6201,10 @@ you've added or deleted a folder, or want to update the unseen message | |||
| 5832 | count before the next automatic update (@code{mh-speed-refresh}). | 6201 | count before the next automatic update (@code{mh-speed-refresh}). |
| 5833 | @end table | 6202 | @end table |
| 5834 | 6203 | ||
| 6204 | @findex delete-frame | ||
| 6205 | @kindex C-x 5 0 | ||
| 6206 | @kindex Mouse-3 | ||
| 6207 | |||
| 5835 | You can click on @kbd{Mouse-3} to bring up a context menu that | 6208 | You can click on @kbd{Mouse-3} to bring up a context menu that |
| 5836 | contains these items. Dismiss the speedbar with @kbd{C-x 5 0} | 6209 | contains these items. Dismiss the speedbar with @kbd{C-x 5 0} |
| 5837 | (@code{delete-frame}). | 6210 | (@code{delete-frame}). |
| @@ -5874,8 +6247,12 @@ Selected folder face when folder contains unread messages. | |||
| 5874 | @node Menu Bar, Tool Bar, Speedbar, Top | 6247 | @node Menu Bar, Tool Bar, Speedbar, Top |
| 5875 | @chapter The Menu Bar | 6248 | @chapter The Menu Bar |
| 5876 | 6249 | ||
| 5877 | @cindex menu bar | 6250 | @cindex @samp{Folder} menu |
| 5878 | 6251 | @cindex @samp{Identity} menu | |
| 6252 | @cindex @samp{Letter} menu | ||
| 6253 | @cindex @samp{Message} menu | ||
| 6254 | @cindex @samp{Search} menu | ||
| 6255 | @cindex @samp{Sequence} menu | ||
| 5879 | @cindex Folder menu | 6256 | @cindex Folder menu |
| 5880 | @cindex Identity menu | 6257 | @cindex Identity menu |
| 5881 | @cindex Letter menu | 6258 | @cindex Letter menu |
| @@ -5885,12 +6262,19 @@ Selected folder face when folder contains unread messages. | |||
| 5885 | @cindex Message menu | 6262 | @cindex Message menu |
| 5886 | @cindex Search menu | 6263 | @cindex Search menu |
| 5887 | @cindex Sequence menu | 6264 | @cindex Sequence menu |
| 6265 | @cindex menu bar | ||
| 5888 | @cindex menu, Folder | 6266 | @cindex menu, Folder |
| 5889 | @cindex menu, Identity | 6267 | @cindex menu, Identity |
| 5890 | @cindex menu, Letter | 6268 | @cindex menu, Letter |
| 5891 | @cindex menu, Message | 6269 | @cindex menu, Message |
| 5892 | @cindex menu, Search | 6270 | @cindex menu, Search |
| 5893 | @cindex menu, Sequence | 6271 | @cindex menu, Sequence |
| 6272 | @cindex menu, @samp{Folder} | ||
| 6273 | @cindex menu, @samp{Identity} | ||
| 6274 | @cindex menu, @samp{Letter} | ||
| 6275 | @cindex menu, @samp{Message} | ||
| 6276 | @cindex menu, @samp{Search} | ||
| 6277 | @cindex menu, @samp{Sequence} | ||
| 5894 | @cindex modes, MH-Folder | 6278 | @cindex modes, MH-Folder |
| 5895 | @cindex modes, MH-Letter | 6279 | @cindex modes, MH-Letter |
| 5896 | @cindex modes, MH-Search | 6280 | @cindex modes, MH-Search |
| @@ -5924,8 +6308,6 @@ and you can also browse all of the items under the index entry | |||
| 5924 | @chapter The Tool Bar | 6308 | @chapter The Tool Bar |
| 5925 | 6309 | ||
| 5926 | @cindex tool bar | 6310 | @cindex tool bar |
| 5927 | @cindex @samp{mh-tool-bar} customization group | ||
| 5928 | @cindex customization group, @samp{mh-tool-bar} | ||
| 5929 | 6311 | ||
| 5930 | Emacs also provides a graphical tool bar. For a description of the | 6312 | Emacs also provides a graphical tool bar. For a description of the |
| 5931 | tool bar, please | 6313 | tool bar, please |
| @@ -5938,6 +6320,9 @@ see the section | |||
| 5938 | Tool Bars} in @cite{The GNU Emacs Manual}. | 6320 | Tool Bars} in @cite{The GNU Emacs Manual}. |
| 5939 | @end ifhtml | 6321 | @end ifhtml |
| 5940 | 6322 | ||
| 6323 | @cindex @samp{mh-tool-bar} customization group | ||
| 6324 | @cindex customization group, @samp{mh-tool-bar} | ||
| 6325 | |||
| 5941 | MH-E adds several icons to this tool bar; you can modify the MH-E | 6326 | MH-E adds several icons to this tool bar; you can modify the MH-E |
| 5942 | aspects of the tool bar via the @samp{mh-tool-bar} customization group. | 6327 | aspects of the tool bar via the @samp{mh-tool-bar} customization group. |
| 5943 | 6328 | ||
| @@ -5965,6 +6350,9 @@ In GNU Emacs, icons for some of MH-E's functions are added to the tool | |||
| 5965 | bar. In XEmacs, you have the opportunity to create a separate tool bar for | 6350 | bar. In XEmacs, you have the opportunity to create a separate tool bar for |
| 5966 | the MH-E icons. | 6351 | the MH-E icons. |
| 5967 | 6352 | ||
| 6353 | @vindex mh-tool-bar-folder-buttons | ||
| 6354 | @vindex mh-tool-bar-letter-buttons | ||
| 6355 | |||
| 5968 | In either case, you can select which of these functions you'd like to | 6356 | In either case, you can select which of these functions you'd like to |
| 5969 | see by customizing the options @code{mh-tool-bar-folder-buttons} and | 6357 | see by customizing the options @code{mh-tool-bar-folder-buttons} and |
| 5970 | @code{mh-tool-bar-letter-buttons}. As you probably guessed, the former | 6358 | @code{mh-tool-bar-letter-buttons}. As you probably guessed, the former |
| @@ -5973,31 +6361,39 @@ mode. Both of these options present you with a list of functions; | |||
| 5973 | check the functions whose icons you want to see and clear the check | 6361 | check the functions whose icons you want to see and clear the check |
| 5974 | boxes for those you don't. | 6362 | boxes for those you don't. |
| 5975 | 6363 | ||
| 6364 | @findex mh-search | ||
| 6365 | @vindex mh-tool-bar-search-function | ||
| 6366 | |||
| 5976 | The function associated with the searching icon can be set via the | 6367 | The function associated with the searching icon can be set via the |
| 5977 | option @code{mh-tool-bar-search-function}. By default, this is set to | 6368 | option @code{mh-tool-bar-search-function}. By default, this is set to |
| 5978 | @code{mh-search}. @xref{Searching}. You can also choose @samp{Other | 6369 | @code{mh-search}. @xref{Searching}. You can also choose @samp{Other |
| 5979 | Function} from the @samp{Value Menu} and enter a function of your own | 6370 | Function} from the @samp{Value Menu} and enter a function of your own |
| 5980 | choosing. | 6371 | choosing. |
| 5981 | 6372 | ||
| 6373 | @vindex mh-xemacs-use-tool-bar-flag | ||
| 6374 | |||
| 5982 | XEmacs provides a couple of extra options. The first, | 6375 | XEmacs provides a couple of extra options. The first, |
| 5983 | @code{mh-xemacs-use-tool-bar-flag}, controls whether to show the MH-E | 6376 | @code{mh-xemacs-use-tool-bar-flag}, controls whether to show the MH-E |
| 5984 | icons at all. By default, this option is turned on if the window | 6377 | icons at all. By default, this option is turned on if the window |
| 5985 | system supports tool bars. If your system doesn't support tool bars, | 6378 | system supports tool bars. If your system doesn't support tool bars, |
| 5986 | then you won't be able to turn on this option. | 6379 | then you won't be able to turn on this option. |
| 5987 | 6380 | ||
| 6381 | @vindex mh-xemacs-tool-bar-position | ||
| 6382 | |||
| 5988 | The second extra option is @code{mh-xemacs-tool-bar-position} which | 6383 | The second extra option is @code{mh-xemacs-tool-bar-position} which |
| 5989 | controls the placement of the tool bar along the four edges of the | 6384 | controls the placement of the tool bar along the four edges of the |
| 5990 | frame. You can choose from one of @samp{Same As Default Tool Bar}, | 6385 | frame. You can choose from one of @samp{Same As Default Tool Bar}, |
| 5991 | @samp{Top}, @samp{Bottom}, @samp{Left}, or @samp{Right}. If this | 6386 | @samp{Top}, @samp{Bottom}, @samp{Left}, or @samp{Right}. If this |
| 5992 | variable is set to anything other than @samp{Same As Default Tool Bar} | 6387 | variable is set to anything other than @samp{Same As Default Tool Bar} |
| 5993 | and the default tool bar is in a different location, then two tool | 6388 | and the default tool bar is in a different location, then two tool |
| 5994 | bars will be displayed: the MH-E tool bar and the default tool bar." | 6389 | bars will be displayed: the MH-E tool bar and the default tool bar. |
| 5995 | 6390 | ||
| 5996 | @node Searching, Threading, Tool Bar, Top | 6391 | @node Searching, Threading, Tool Bar, Top |
| 5997 | @chapter Searching Through Messages | 6392 | @chapter Searching Through Messages |
| 5998 | 6393 | ||
| 6394 | @cindex @samp{Search} menu | ||
| 6395 | @cindex menu, @samp{Search} | ||
| 5999 | @cindex searching | 6396 | @cindex searching |
| 6000 | |||
| 6001 | @findex mh-search | 6397 | @findex mh-search |
| 6002 | @kindex F s | 6398 | @kindex F s |
| 6003 | 6399 | ||
| @@ -6141,12 +6537,18 @@ The following face is available. | |||
| 6141 | Folder heading face in MH-Folder buffers created by searches. | 6537 | Folder heading face in MH-Folder buffers created by searches. |
| 6142 | @end vtable | 6538 | @end vtable |
| 6143 | 6539 | ||
| 6540 | @findex mh-search-folder | ||
| 6541 | @kindex F s | ||
| 6542 | |||
| 6144 | The command @kbd{F s} (@code{mh-search-folder}) helps you find | 6543 | The command @kbd{F s} (@code{mh-search-folder}) helps you find |
| 6145 | messages in your entire corpus of mail. You can search for messages to | 6544 | messages in your entire corpus of mail. You can search for messages to |
| 6146 | or from a particular person or about a particular subject. In fact, | 6545 | or from a particular person or about a particular subject. In fact, |
| 6147 | you can also search for messages containing selected strings in any | 6546 | you can also search for messages containing selected strings in any |
| 6148 | arbitrary header field or any string found within the messages. | 6547 | arbitrary header field or any string found within the messages. |
| 6149 | 6548 | ||
| 6549 | @cindex @command{pick} | ||
| 6550 | @cindex MH commands, @command{pick} | ||
| 6551 | |||
| 6150 | Out of the box, MH-E uses @command{pick} to find messages. With a | 6552 | Out of the box, MH-E uses @command{pick} to find messages. With a |
| 6151 | little extra effort, you can set an indexing program which rewards you | 6553 | little extra effort, you can set an indexing program which rewards you |
| 6152 | with extremely quick results. The drawback is that sometimes the index | 6554 | with extremely quick results. The drawback is that sometimes the index |
| @@ -6213,26 +6615,25 @@ kosciusko | |||
| 6213 | @end group | 6615 | @end group |
| 6214 | @end smallexample | 6616 | @end smallexample |
| 6215 | 6617 | ||
| 6618 | @findex mh-to-field | ||
| 6619 | @kindex C-c C-f C-t | ||
| 6620 | |||
| 6216 | As with MH-Letter mode, MH-Search provides commands like @kbd{C-c C-f | 6621 | As with MH-Letter mode, MH-Search provides commands like @kbd{C-c C-f |
| 6217 | C-t} (@code{mh-to-field}) to help you fill in the blanks. | 6622 | C-t} (@code{mh-to-field}) to help you fill in the blanks. |
| 6218 | @xref{Editing Message}. | 6623 | @xref{Editing Message}. |
| 6219 | 6624 | ||
| 6625 | @kindex F s | ||
| 6626 | @vindex mh-search-mode-hook | ||
| 6627 | |||
| 6220 | If you find that you do the same thing over and over when editing the | 6628 | If you find that you do the same thing over and over when editing the |
| 6221 | search template, you may wish to bind some shortcuts to keys. This can | 6629 | search template, you may wish to bind some shortcuts to keys. This can |
| 6222 | be done with the variable @code{mh-search-mode-hook}, which is called | 6630 | be done with the variable @code{mh-search-mode-hook}, which is called |
| 6223 | when @kbd{F s} is run on a new pattern. | 6631 | when @kbd{F s} is run on a new pattern. |
| 6224 | 6632 | ||
| 6225 | @cindex @samp{+mhe-index} | ||
| 6226 | @cindex folders, @samp{+mhe-index} | ||
| 6227 | @findex mh-index-do-search | 6633 | @findex mh-index-do-search |
| 6228 | @findex mh-index-next-folder | ||
| 6229 | @findex mh-index-previous-folder | ||
| 6230 | @findex mh-pick-do-search | 6634 | @findex mh-pick-do-search |
| 6231 | @kindex @key{TAB} | ||
| 6232 | @kindex C-c C-c | 6635 | @kindex C-c C-c |
| 6233 | @kindex F s | 6636 | @kindex C-c C-p |
| 6234 | @kindex S-@key{TAB} | ||
| 6235 | @vindex mh-search-folder | ||
| 6236 | 6637 | ||
| 6237 | To perform the search, type @kbd{C-c C-c} (@code{mh-index-do-search}). | 6638 | To perform the search, type @kbd{C-c C-c} (@code{mh-index-do-search}). |
| 6238 | Sometimes you're searching for text that is either not indexed, or | 6639 | Sometimes you're searching for text that is either not indexed, or |
| @@ -6240,6 +6641,14 @@ hasn't been indexed yet. In this case you can override the default | |||
| 6240 | method with the pick method by running the command @kbd{C-c C-p} | 6641 | method with the pick method by running the command @kbd{C-c C-p} |
| 6241 | (@code{mh-pick-do-search}). | 6642 | (@code{mh-pick-do-search}). |
| 6242 | 6643 | ||
| 6644 | @cindex folders, @samp{+mhe-index} | ||
| 6645 | @cindex @samp{+mhe-index} | ||
| 6646 | @findex mh-index-next-folder | ||
| 6647 | @findex mh-index-previous-folder | ||
| 6648 | @kindex @key{TAB} | ||
| 6649 | @kindex S-@key{TAB} | ||
| 6650 | @vindex mh-search-folder | ||
| 6651 | |||
| 6243 | The messages that are found are put in a temporary sub-folder of | 6652 | The messages that are found are put in a temporary sub-folder of |
| 6244 | @samp{+mhe-index} and are displayed in an MH-Folder buffer. This | 6653 | @samp{+mhe-index} and are displayed in an MH-Folder buffer. This |
| 6245 | buffer is special because it displays messages from multiple folders; | 6654 | buffer is special because it displays messages from multiple folders; |
| @@ -6250,6 +6659,11 @@ headings using the commands @kbd{@key{TAB}} | |||
| 6250 | (@code{mh-index-next-folder}) and @kbd{S-@key{TAB}} | 6659 | (@code{mh-index-next-folder}) and @kbd{S-@key{TAB}} |
| 6251 | (@code{mh-index-previous-folder}). | 6660 | (@code{mh-index-previous-folder}). |
| 6252 | 6661 | ||
| 6662 | @findex mh-index-visit-folder | ||
| 6663 | @findex mh-rescan-folder | ||
| 6664 | @kindex F r | ||
| 6665 | @kindex v | ||
| 6666 | |||
| 6253 | In addition, the command @kbd{v} (@code{mh-index-visit-folder}) can be | 6667 | In addition, the command @kbd{v} (@code{mh-index-visit-folder}) can be |
| 6254 | used to visit the folder of the message at point. Initially, only the | 6668 | used to visit the folder of the message at point. Initially, only the |
| 6255 | messages that matched the search criteria are displayed in the folder. | 6669 | messages that matched the search criteria are displayed in the folder. |
| @@ -6259,10 +6673,15 @@ command @kbd{v} is useful to find the actual message number of an | |||
| 6259 | interesting message, or to view surrounding messages with the command | 6673 | interesting message, or to view surrounding messages with the command |
| 6260 | @kbd{F r} @code{mh-rescan-folder}. @xref{Folders}. | 6674 | @kbd{F r} @code{mh-rescan-folder}. @xref{Folders}. |
| 6261 | 6675 | ||
| 6676 | @findex mh-kill-folder | ||
| 6677 | @kindex F k | ||
| 6678 | |||
| 6262 | Because this folder is temporary, you'll probably get in the habit of | 6679 | Because this folder is temporary, you'll probably get in the habit of |
| 6263 | killing it when you're done with @kbd{F k} (@code{mh-kill-folder}). | 6680 | killing it when you're done with @kbd{F k} (@code{mh-kill-folder}). |
| 6264 | @xref{Folders}. | 6681 | @xref{Folders}. |
| 6265 | 6682 | ||
| 6683 | @kindex F s | ||
| 6684 | |||
| 6266 | You can regenerate the results by running @kbd{F s} with a prefix | 6685 | You can regenerate the results by running @kbd{F s} with a prefix |
| 6267 | argument. | 6686 | argument. |
| 6268 | 6687 | ||
| @@ -6418,7 +6837,7 @@ Use the following command line to generate the swish index. Run this | |||
| 6418 | daily from cron: | 6837 | daily from cron: |
| 6419 | 6838 | ||
| 6420 | @smallexample | 6839 | @smallexample |
| 6421 | swish-e -c /home/user/Mail/.swish/config | 6840 | swish-e -c /home/user/Mail/.swish/config |
| 6422 | @end smallexample | 6841 | @end smallexample |
| 6423 | 6842 | ||
| 6424 | @subsection mairix | 6843 | @subsection mairix |
| @@ -6520,6 +6939,10 @@ header field. Other ways to organize messages in a folder include | |||
| 6520 | limiting (@pxref{Limits}) or using full-text indexed searches | 6939 | limiting (@pxref{Limits}) or using full-text indexed searches |
| 6521 | (@pxref{Searching}). | 6940 | (@pxref{Searching}). |
| 6522 | 6941 | ||
| 6942 | @cindex root, in threads | ||
| 6943 | @cindex siblings, in threads | ||
| 6944 | @cindex ancestor, in threads | ||
| 6945 | |||
| 6523 | A thread begins with a single message called a @dfn{root}. All replies | 6946 | A thread begins with a single message called a @dfn{root}. All replies |
| 6524 | to the same message are @dfn{siblings} of each other. Any message that | 6947 | to the same message are @dfn{siblings} of each other. Any message that |
| 6525 | has replies to it is an @dfn{ancestor} of those replies. | 6948 | has replies to it is an @dfn{ancestor} of those replies. |
| @@ -6565,6 +6988,9 @@ Display previous sibling (@code{mh-thread-previous-sibling}). | |||
| 6565 | Display ancestor of current message (@code{mh-thread-ancestor}). | 6988 | Display ancestor of current message (@code{mh-thread-ancestor}). |
| 6566 | @end table | 6989 | @end table |
| 6567 | 6990 | ||
| 6991 | @cindex @samp{mh-thread} customization group | ||
| 6992 | @cindex customization group, @samp{mh-thread} | ||
| 6993 | |||
| 6568 | The @samp{mh-thread} customization group contains one option. | 6994 | The @samp{mh-thread} customization group contains one option. |
| 6569 | 6995 | ||
| 6570 | @vtable @code | 6996 | @vtable @code |
| @@ -6572,6 +6998,11 @@ The @samp{mh-thread} customization group contains one option. | |||
| 6572 | On means new folders start in threaded mode (default: @samp{off}). | 6998 | On means new folders start in threaded mode (default: @samp{off}). |
| 6573 | @end vtable | 6999 | @end vtable |
| 6574 | 7000 | ||
| 7001 | @findex mh-toggle-threads | ||
| 7002 | @kindex T t | ||
| 7003 | @vindex mh-large-folder | ||
| 7004 | @vindex mh-show-threads-flag | ||
| 7005 | |||
| 6575 | Threading large number of messages can be time consuming so the option | 7006 | Threading large number of messages can be time consuming so the option |
| 6576 | @code{mh-show-threads-flag} is turned off by default. If you turn on | 7007 | @code{mh-show-threads-flag} is turned off by default. If you turn on |
| 6577 | this option, then threading will be done only if the number of | 7008 | this option, then threading will be done only if the number of |
| @@ -6579,6 +7010,13 @@ messages being threaded is less than @code{mh-large-folder}. In any | |||
| 6579 | event, threading can be turned on (and off) with the command @kbd{T t} | 7010 | event, threading can be turned on (and off) with the command @kbd{T t} |
| 6580 | (@code{mh-toggle-threads}). | 7011 | (@code{mh-toggle-threads}). |
| 6581 | 7012 | ||
| 7013 | @findex mh-thread-ancestor | ||
| 7014 | @findex mh-thread-next-sibling | ||
| 7015 | @findex mh-thread-previous-sibling | ||
| 7016 | @kindex T n | ||
| 7017 | @kindex T p | ||
| 7018 | @kindex T u | ||
| 7019 | |||
| 6582 | There are a few commands to help you navigate threads. If you do not | 7020 | There are a few commands to help you navigate threads. If you do not |
| 6583 | care for the way a particular thread has turned, you can move up the | 7021 | care for the way a particular thread has turned, you can move up the |
| 6584 | chain of messages with the command @kbd{T u} | 7022 | chain of messages with the command @kbd{T u} |
| @@ -6588,6 +7026,13 @@ chain of messages with the command @kbd{T u} | |||
| 6588 | sibling, skipping the sub-threads. The command @kbd{T u} can also take | 7026 | sibling, skipping the sub-threads. The command @kbd{T u} can also take |
| 6589 | a prefix argument to jump to the message that started everything. | 7027 | a prefix argument to jump to the message that started everything. |
| 6590 | 7028 | ||
| 7029 | @findex mh-delete-subject-or-thread | ||
| 7030 | @findex mh-thread-delete | ||
| 7031 | @findex mh-thread-refile | ||
| 7032 | @kindex k | ||
| 7033 | @kindex T d | ||
| 7034 | @kindex T o | ||
| 7035 | |||
| 6591 | There are threaded equivalents for the commands that delete and refile | 7036 | There are threaded equivalents for the commands that delete and refile |
| 6592 | messages. For example, @kbd{T o} (@code{mh-thread-refile}) refiles the | 7037 | messages. For example, @kbd{T o} (@code{mh-thread-refile}) refiles the |
| 6593 | current message and all its children. Similarly, the command @kbd{T d} | 7038 | current message and all its children. Similarly, the command @kbd{T d} |
| @@ -6596,11 +7041,13 @@ children. These commands do not refile or delete sibling messages. | |||
| 6596 | @xref{Navigating}, for a description of the similar command @kbd{k} | 7041 | @xref{Navigating}, for a description of the similar command @kbd{k} |
| 6597 | (@code{mh-delete-subject-or-thread}). | 7042 | (@code{mh-delete-subject-or-thread}). |
| 6598 | 7043 | ||
| 7044 | @vindex mh-large-folder | ||
| 7045 | |||
| 6599 | If you find that threading is too slow, it may be that you have | 7046 | If you find that threading is too slow, it may be that you have |
| 6600 | @code{mh-large-folder} set too high. Threading is one of the few | 7047 | @code{mh-large-folder} set too high. Also, threading is one of the few |
| 6601 | features of MH-E that really benefits from compiling. If you haven't | 7048 | features of MH-E that really benefits from compiling. If you haven't |
| 6602 | compiled MH-E, I encourage you to do so@footnote{If you're not sure | 7049 | compiled MH-E, I encourage you to do so@footnote{If you're not sure if |
| 6603 | if MH-E has been byte-compiled, you could try running @samp{locate | 7050 | MH-E has been byte-compiled, you could try running @samp{locate |
| 6604 | mh-thread.elc} or otherwise find MH-E on your system and ensure that | 7051 | mh-thread.elc} or otherwise find MH-E on your system and ensure that |
| 6605 | @file{mh-thread.elc} exists. If you have multiple versions and you | 7052 | @file{mh-thread.elc} exists. If you have multiple versions and you |
| 6606 | find that one is compiled but the other is not, then go into your | 7053 | find that one is compiled but the other is not, then go into your |
| @@ -6679,18 +7126,32 @@ All of the limiting commands above refine the display in some way. | |||
| 6679 | 7126 | ||
| 6680 | @cindex @command{pick} | 7127 | @cindex @command{pick} |
| 6681 | @cindex MH commands, @command{pick} | 7128 | @cindex MH commands, @command{pick} |
| 7129 | @findex mh-narrow-to-cc | ||
| 7130 | @findex mh-narrow-to-from | ||
| 7131 | @findex mh-narrow-to-subject | ||
| 7132 | @findex mh-narrow-to-to | ||
| 7133 | @kindex / c | ||
| 7134 | @kindex / m | ||
| 7135 | @kindex / s | ||
| 7136 | @kindex / t | ||
| 6682 | 7137 | ||
| 6683 | The commands @kbd{/ c}, @code{/ m}, @code{/ s}, and @code{/ t} | 7138 | The commands @kbd{/ c} (@code{mh-narrow-to-cc}), @kbd{/ m} |
| 6684 | restrict the display to messages matching the content of the | 7139 | (@code{mh-narrow-to-from}), @kbd{/ s} (@code{mh-narrow-to-subject}), |
| 6685 | respective field in the current message. However, you can give any of | 7140 | and @kbd{/ t} (@code{mh-narrow-to-to}) restrict the display to |
| 6686 | these a prefix argument to edit the @command{pick} expression used to | 7141 | messages matching the content of the respective field in the current |
| 6687 | narrow the view@footnote{See @command{pick}(1) or the section | 7142 | message. However, you can give any of these a prefix argument to edit |
| 7143 | the @command{pick} expression used to narrow the view@footnote{See | ||
| 7144 | @command{pick}(1) or the section | ||
| 6688 | @uref{@value{MH-BOOK-HOME}/finpic.htm, Finding Messages with pick} in | 7145 | @uref{@value{MH-BOOK-HOME}/finpic.htm, Finding Messages with pick} in |
| 6689 | the MH book.}. | 7146 | the MH book.}. |
| 6690 | 7147 | ||
| 6691 | @cindex @samp{tick} sequence | 7148 | @cindex @samp{tick} sequence |
| 6692 | @cindex sequence, @samp{tick} | 7149 | @cindex sequence, @samp{tick} |
| 6693 | @cindex ticked messages, viewing | 7150 | @cindex ticked messages, viewing |
| 7151 | @findex mh-narrow-to-range | ||
| 7152 | @findex mh-narrow-to-tick | ||
| 7153 | @kindex / ' | ||
| 7154 | @kindex / g | ||
| 6694 | 7155 | ||
| 6695 | You can also limit the display to messages in the @samp{tick} sequence | 7156 | You can also limit the display to messages in the @samp{tick} sequence |
| 6696 | with the command @kbd{/ '} (@code{mh-narrow-to-tick}). | 7157 | with the command @kbd{/ '} (@code{mh-narrow-to-tick}). |
| @@ -6698,12 +7159,17 @@ with the command @kbd{/ '} (@code{mh-narrow-to-tick}). | |||
| 6698 | @samp{tick} sequence. Use the @kbd{/ g} (@code{mh-narrow-to-range}) | 7159 | @samp{tick} sequence. Use the @kbd{/ g} (@code{mh-narrow-to-range}) |
| 6699 | command to limit the display to messages in a range (@pxref{Ranges}). | 7160 | command to limit the display to messages in a range (@pxref{Ranges}). |
| 6700 | 7161 | ||
| 7162 | @findex mh-widen | ||
| 7163 | @kindex / w | ||
| 7164 | |||
| 6701 | Each limit can be undone in turn with the @kbd{/ w} (@code{mh-widen}) | 7165 | Each limit can be undone in turn with the @kbd{/ w} (@code{mh-widen}) |
| 6702 | command. Give this command a prefix argument to remove all limits. | 7166 | command. Give this command a prefix argument to remove all limits. |
| 6703 | 7167 | ||
| 6704 | @node Sequences, Junk, Limits, Top | 7168 | @node Sequences, Junk, Limits, Top |
| 6705 | @chapter Using Sequences | 7169 | @chapter Using Sequences |
| 6706 | 7170 | ||
| 7171 | @cindex @samp{Sequence} menu | ||
| 7172 | @cindex menu, @samp{Sequence} | ||
| 6707 | @cindex sequences | 7173 | @cindex sequences |
| 6708 | 7174 | ||
| 6709 | For the whole scoop on MH sequences, refer to | 7175 | For the whole scoop on MH sequences, refer to |
| @@ -6819,6 +7285,8 @@ Hook run after the unseen sequence has been updated (default: @code{nil}). | |||
| 6819 | 7285 | ||
| 6820 | @cindex @command{pick} | 7286 | @cindex @command{pick} |
| 6821 | @cindex MH commands, @command{pick} | 7287 | @cindex MH commands, @command{pick} |
| 7288 | @findex mh-put-msg-in-seq | ||
| 7289 | @kindex S p | ||
| 6822 | 7290 | ||
| 6823 | To place a message in a sequence, use @kbd{S p} | 7291 | To place a message in a sequence, use @kbd{S p} |
| 6824 | (@code{mh-put-msg-in-seq}). Give @kbd{S p} a range and you can add all | 7292 | (@code{mh-put-msg-in-seq}). Give @kbd{S p} a range and you can add all |
| @@ -6828,11 +7296,18 @@ S p SourceSequence @key{RET} DestSequence @key{RET}}, @pxref{Ranges}). | |||
| 6828 | @cindex @samp{tick} sequence | 7296 | @cindex @samp{tick} sequence |
| 6829 | @cindex sequence, @samp{tick} | 7297 | @cindex sequence, @samp{tick} |
| 6830 | @cindex ticking messages | 7298 | @cindex ticking messages |
| 7299 | @findex mh-index-ticked-messages | ||
| 7300 | @findex mh-toggle-tick | ||
| 7301 | @kindex ' | ||
| 7302 | @kindex F ' | ||
| 7303 | @kindex S p | ||
| 6831 | 7304 | ||
| 6832 | One specific use of the @kbd{S p} command is @kbd{'} | 7305 | One specific use of the @kbd{S p} command is @kbd{'} |
| 6833 | (@code{mh-toggle-tick}) which adds messages to the @samp{tick} | 7306 | (@code{mh-toggle-tick}) which adds messages to the @samp{tick} |
| 6834 | sequence. This sequence can be viewed later with the @kbd{F '} command | 7307 | sequence. This sequence can be viewed later with the @kbd{F '} |
| 6835 | (@pxref{Folders}). | 7308 | (@code{mh-index-ticked-messages}) command (@pxref{Folders}). |
| 7309 | |||
| 7310 | @vindex mh-tick-seq | ||
| 6836 | 7311 | ||
| 6837 | You can customize the option @code{mh-tick-seq} if you already use the | 7312 | You can customize the option @code{mh-tick-seq} if you already use the |
| 6838 | @samp{tick} sequence for your own use. You can also disable all of the | 7313 | @samp{tick} sequence for your own use. You can also disable all of the |
| @@ -6841,6 +7316,12 @@ there isn't much advantage to that. | |||
| 6841 | 7316 | ||
| 6842 | @cindex MH-Folder mode | 7317 | @cindex MH-Folder mode |
| 6843 | @cindex modes, MH-Folder | 7318 | @cindex modes, MH-Folder |
| 7319 | @findex mh-narrow-to-seq | ||
| 7320 | @findex mh-narrow-to-tick | ||
| 7321 | @findex mh-widen | ||
| 7322 | @kindex S ' | ||
| 7323 | @kindex S n | ||
| 7324 | @kindex S w | ||
| 6844 | 7325 | ||
| 6845 | Once you've placed some messages in a sequence, you may wish to narrow | 7326 | Once you've placed some messages in a sequence, you may wish to narrow |
| 6846 | the field of view to just those messages in the sequence you've | 7327 | the field of view to just those messages in the sequence you've |
| @@ -6853,8 +7334,12 @@ sequence, use @kbd{S '} (@code{mh-narrow-to-tick}). When you want to | |||
| 6853 | widen the view to all your messages again, use @kbd{S w} | 7334 | widen the view to all your messages again, use @kbd{S w} |
| 6854 | (@code{mh-widen}). | 7335 | (@code{mh-widen}). |
| 6855 | 7336 | ||
| 6856 | @cindex @samp{*MH-E Sequences*} | ||
| 6857 | @cindex buffers, @samp{*MH-E Sequences*} | 7337 | @cindex buffers, @samp{*MH-E Sequences*} |
| 7338 | @cindex @samp{*MH-E Sequences*} | ||
| 7339 | @findex mh-list-sequences | ||
| 7340 | @findex mh-msg-is-in-seq | ||
| 7341 | @kindex S l | ||
| 7342 | @kindex S s | ||
| 6858 | 7343 | ||
| 6859 | You can see which sequences in which a message appears with the | 7344 | You can see which sequences in which a message appears with the |
| 6860 | command @kbd{S s} (@code{mh-msg-is-in-seq}). Use a prefix argument to | 7345 | command @kbd{S s} (@code{mh-msg-is-in-seq}). Use a prefix argument to |
| @@ -6864,11 +7349,12 @@ folder (default is current folder) with @kbd{S l} | |||
| 6864 | (@code{mh-list-sequences}). The list appears in a buffer named | 7349 | (@code{mh-list-sequences}). The list appears in a buffer named |
| 6865 | @samp{*MH-E Sequences*} (@pxref{Miscellaneous}). | 7350 | @samp{*MH-E Sequences*} (@pxref{Miscellaneous}). |
| 6866 | 7351 | ||
| 6867 | @cindex @samp{Previous-Sequence:} MH profile component | ||
| 6868 | @cindex @samp{cur} sequence | ||
| 6869 | @cindex MH profile component, @samp{Previous-Sequence:} | 7352 | @cindex MH profile component, @samp{Previous-Sequence:} |
| 6870 | @cindex sequence, @samp{Previous-Sequence} | 7353 | @cindex @samp{cur} sequence |
| 7354 | @cindex @samp{Previous-Sequence:} MH profile component | ||
| 6871 | @cindex sequence, @samp{cur} | 7355 | @cindex sequence, @samp{cur} |
| 7356 | @cindex sequence, @samp{Previous-Sequence} | ||
| 7357 | @vindex mh-refile-preserves-sequences-flag | ||
| 6872 | 7358 | ||
| 6873 | If a message is in any sequence (except | 7359 | If a message is in any sequence (except |
| 6874 | @samp{Previous-Sequence:}@footnote{See @samp{mh-profile}(5)).} and | 7360 | @samp{Previous-Sequence:}@footnote{See @samp{mh-profile}(5)).} and |
| @@ -6876,6 +7362,12 @@ If a message is in any sequence (except | |||
| 6876 | sequences in the destination folder. If this behavior is not desired, | 7362 | sequences in the destination folder. If this behavior is not desired, |
| 6877 | then turn off the option @code{mh-refile-preserves-sequences-flag}. | 7363 | then turn off the option @code{mh-refile-preserves-sequences-flag}. |
| 6878 | 7364 | ||
| 7365 | @findex mh-delete-msg-from-seq | ||
| 7366 | @findex mh-delete-seq | ||
| 7367 | @kindex d | ||
| 7368 | @kindex S d | ||
| 7369 | @kindex S k | ||
| 7370 | |||
| 6879 | If you want to remove a message (or range, @pxref{Ranges}) from a | 7371 | If you want to remove a message (or range, @pxref{Ranges}) from a |
| 6880 | sequence, use @kbd{S d} (@code{mh-delete-msg-from-seq}). If you want | 7372 | sequence, use @kbd{S d} (@code{mh-delete-msg-from-seq}). If you want |
| 6881 | to delete an entire sequence, use @kbd{S k} (@code{mh-delete-seq}). In | 7373 | to delete an entire sequence, use @kbd{S k} (@code{mh-delete-seq}). In |
| @@ -6885,8 +7377,18 @@ you want to delete the messages, use @kbd{C-u d} (@pxref{Reading | |||
| 6885 | Mail}). | 7377 | Mail}). |
| 6886 | 7378 | ||
| 6887 | @cindex @samp{Unseen-Sequence:} MH profile component | 7379 | @cindex @samp{Unseen-Sequence:} MH profile component |
| 7380 | @cindex @samp{cur} sequence | ||
| 7381 | @cindex @samp{tick} sequence | ||
| 6888 | @cindex MH profile component, @samp{Unseen-Sequence:} | 7382 | @cindex MH profile component, @samp{Unseen-Sequence:} |
| 6889 | @cindex sequence, @samp{Unseen-Sequence} | 7383 | @cindex sequence, @samp{Unseen-Sequence} |
| 7384 | @cindex sequence, @samp{cur} | ||
| 7385 | @cindex sequence, @samp{tick} | ||
| 7386 | @findex mh-update-sequences | ||
| 7387 | @kindex M-x mh-update-sequences | ||
| 7388 | @kindex q | ||
| 7389 | @kindex x | ||
| 7390 | @vindex mh-tick-seq | ||
| 7391 | @vindex mh-update-sequences-after-mh-show-flag | ||
| 6890 | 7392 | ||
| 6891 | Three sequences are maintained internally by MH-E and pushed out to MH | 7393 | Three sequences are maintained internally by MH-E and pushed out to MH |
| 6892 | when a message is shown. They include the sequence specified by your | 7394 | when a message is shown. They include the sequence specified by your |
| @@ -6907,6 +7409,8 @@ from the unseen sequence. | |||
| 6907 | 7409 | ||
| 6908 | @cindex @command{mark} | 7410 | @cindex @command{mark} |
| 6909 | @cindex MH commands, @command{mark} | 7411 | @cindex MH commands, @command{mark} |
| 7412 | @kindex S n | ||
| 7413 | @kindex S w | ||
| 6910 | 7414 | ||
| 6911 | With the exceptions of @kbd{S n} and @kbd{S w}, the underlying MH | 7415 | With the exceptions of @kbd{S n} and @kbd{S w}, the underlying MH |
| 6912 | command dealing with sequences is @command{mark}@footnote{See the | 7416 | command dealing with sequences is @command{mark}@footnote{See the |
| @@ -6989,6 +7493,8 @@ away. This chapter describes briefly how to configure these programs | |||
| 6989 | to work well with MH-E and how to use MH-E's interface that provides | 7493 | to work well with MH-E and how to use MH-E's interface that provides |
| 6990 | continuing education for these programs. | 7494 | continuing education for these programs. |
| 6991 | 7495 | ||
| 7496 | @vindex mh-junk-program | ||
| 7497 | |||
| 6992 | The default setting of the option @code{mh-junk-program} is | 7498 | The default setting of the option @code{mh-junk-program} is |
| 6993 | @samp{Auto-detect} which means that MH-E will automatically choose one | 7499 | @samp{Auto-detect} which means that MH-E will automatically choose one |
| 6994 | of SpamAssassin, bogofilter, or SpamProbe in that order. If, for | 7500 | of SpamAssassin, bogofilter, or SpamProbe in that order. If, for |
| @@ -6996,6 +7502,10 @@ example, you have both SpamAssassin and bogofilter installed and you | |||
| 6996 | want to use bogofilter, then you can set this option to | 7502 | want to use bogofilter, then you can set this option to |
| 6997 | @samp{Bogofilter}. | 7503 | @samp{Bogofilter}. |
| 6998 | 7504 | ||
| 7505 | @findex mh-junk-blacklist | ||
| 7506 | @kindex J b | ||
| 7507 | @vindex mh-junk-disposition | ||
| 7508 | |||
| 6999 | The command @kbd{J b} (@code{mh-junk-blacklist}) trains the spam | 7509 | The command @kbd{J b} (@code{mh-junk-blacklist}) trains the spam |
| 7000 | program in use with the content of the range (@pxref{Ranges}) and then | 7510 | program in use with the content of the range (@pxref{Ranges}) and then |
| 7001 | handles the message(s) as specified by the option | 7511 | handles the message(s) as specified by the option |
| @@ -7003,11 +7513,16 @@ handles the message(s) as specified by the option | |||
| 7003 | @samp{Delete Spam} but you can also specify the name of the folder | 7513 | @samp{Delete Spam} but you can also specify the name of the folder |
| 7004 | which is useful for building a corpus of spam for training purposes. | 7514 | which is useful for building a corpus of spam for training purposes. |
| 7005 | 7515 | ||
| 7516 | @findex mh-junk-whitelist | ||
| 7517 | @kindex J w | ||
| 7518 | |||
| 7006 | In contrast, the command @kbd{J w} (@code{mh-junk-whitelist}) | 7519 | In contrast, the command @kbd{J w} (@code{mh-junk-whitelist}) |
| 7007 | reclassifies a range of messages (@pxref{Ranges}) as ham if it were | 7520 | reclassifies a range of messages (@pxref{Ranges}) as ham if it were |
| 7008 | incorrectly classified as spam. It then refiles the message into the | 7521 | incorrectly classified as spam. It then refiles the message into the |
| 7009 | @file{+inbox} folder. | 7522 | @file{+inbox} folder. |
| 7010 | 7523 | ||
| 7524 | @vindex mh-junk-background | ||
| 7525 | |||
| 7011 | By default, the programs are run in the foreground, but this can be | 7526 | By default, the programs are run in the foreground, but this can be |
| 7012 | slow when junking large numbers of messages. If you have enough memory | 7527 | slow when junking large numbers of messages. If you have enough memory |
| 7013 | or don't junk that many messages at the same time, you might try | 7528 | or don't junk that many messages at the same time, you might try |
| @@ -7019,7 +7534,10 @@ MH-E can work with. | |||
| 7019 | @cindex @file{.procmailrc} | 7534 | @cindex @file{.procmailrc} |
| 7020 | @cindex files, @file{.procmailrc} | 7535 | @cindex files, @file{.procmailrc} |
| 7021 | 7536 | ||
| 7022 | @heading SpamAssassin | 7537 | @subheading SpamAssassin |
| 7538 | |||
| 7539 | @cindex Spamassassin | ||
| 7540 | @cindex spam filters, Spamassassin | ||
| 7023 | 7541 | ||
| 7024 | SpamAssassin is one of the more popular spam filtering programs. Get | 7542 | SpamAssassin is one of the more popular spam filtering programs. Get |
| 7025 | it from your local distribution or from the | 7543 | it from your local distribution or from the |
| @@ -7059,7 +7577,7 @@ works best for you. | |||
| 7059 | First, run @samp{spamassassin -t} on every mail message in your | 7577 | First, run @samp{spamassassin -t} on every mail message in your |
| 7060 | archive and use @command{gnumeric} to verify that the average plus the | 7578 | archive and use @command{gnumeric} to verify that the average plus the |
| 7061 | standard deviation of good mail is under 5, the SpamAssassin default | 7579 | standard deviation of good mail is under 5, the SpamAssassin default |
| 7062 | for "spam". | 7580 | for ``spam''. |
| 7063 | 7581 | ||
| 7064 | Using @command{gnumeric}, sort the messages by score and view the | 7582 | Using @command{gnumeric}, sort the messages by score and view the |
| 7065 | messages with the highest score. Determine the score which encompasses | 7583 | messages with the highest score. Determine the score which encompasses |
| @@ -7072,6 +7590,11 @@ the @samp{+spam} folder for later review. The major weakness of | |||
| 7072 | rules-based filters is a plethora of false positives so it is | 7590 | rules-based filters is a plethora of false positives so it is |
| 7073 | worthwhile to check. | 7591 | worthwhile to check. |
| 7074 | 7592 | ||
| 7593 | @findex mh-junk-blacklist | ||
| 7594 | @findex mh-junk-whitelist | ||
| 7595 | @kindex J b | ||
| 7596 | @kindex J w | ||
| 7597 | |||
| 7075 | If SpamAssassin classifies a message incorrectly, or is unsure, you can | 7598 | If SpamAssassin classifies a message incorrectly, or is unsure, you can |
| 7076 | use the MH-E commands @kbd{J b} (@code{mh-junk-blacklist}) and | 7599 | use the MH-E commands @kbd{J b} (@code{mh-junk-blacklist}) and |
| 7077 | @kbd{J w} (@code{mh-junk-whitelist}). | 7600 | @kbd{J w} (@code{mh-junk-whitelist}). |
| @@ -7117,7 +7640,10 @@ done by adding the following to your @file{crontab}: | |||
| 7117 | 0 * * * * sa-learn --rebuild > /dev/null 2>&1 | 7640 | 0 * * * * sa-learn --rebuild > /dev/null 2>&1 |
| 7118 | @end smallexample | 7641 | @end smallexample |
| 7119 | 7642 | ||
| 7120 | @heading Bogofilter | 7643 | @subheading Bogofilter |
| 7644 | |||
| 7645 | @cindex bogofilter | ||
| 7646 | @cindex spam filters, bogofilter | ||
| 7121 | 7647 | ||
| 7122 | Bogofilter is a Bayesian spam filtering program. Get it from your | 7648 | Bogofilter is a Bayesian spam filtering program. Get it from your |
| 7123 | local distribution or from the | 7649 | local distribution or from the |
| @@ -7163,6 +7689,11 @@ spam/. | |||
| 7163 | spam/unsure/. | 7689 | spam/unsure/. |
| 7164 | @end smallexample | 7690 | @end smallexample |
| 7165 | 7691 | ||
| 7692 | @findex mh-junk-blacklist | ||
| 7693 | @findex mh-junk-whitelist | ||
| 7694 | @kindex J b | ||
| 7695 | @kindex J w | ||
| 7696 | |||
| 7166 | If bogofilter classifies a message incorrectly, or is unsure, you can | 7697 | If bogofilter classifies a message incorrectly, or is unsure, you can |
| 7167 | use the MH-E commands @kbd{J b} (@code{mh-junk-blacklist}) and @kbd{J | 7698 | use the MH-E commands @kbd{J b} (@code{mh-junk-blacklist}) and @kbd{J |
| 7168 | w} (@code{mh-junk-whitelist}) to update bogofilter's training. | 7699 | w} (@code{mh-junk-whitelist}) to update bogofilter's training. |
| @@ -7179,7 +7710,10 @@ mv wordlist.db.new wordlist.db | |||
| 7179 | The @cite{Bogofilter tuning HOWTO} describes how you can fine-tune | 7710 | The @cite{Bogofilter tuning HOWTO} describes how you can fine-tune |
| 7180 | bogofilter. | 7711 | bogofilter. |
| 7181 | 7712 | ||
| 7182 | @heading SpamProbe | 7713 | @subheading SpamProbe |
| 7714 | |||
| 7715 | @cindex SpamProbe | ||
| 7716 | @cindex spam filters, SpamProbe | ||
| 7183 | 7717 | ||
| 7184 | SpamProbe is a Bayesian spam filtering program. Get it from your local | 7718 | SpamProbe is a Bayesian spam filtering program. Get it from your local |
| 7185 | distribution or from the @uref{http://spamprobe.sourceforge.net, | 7719 | distribution or from the @uref{http://spamprobe.sourceforge.net, |
| @@ -7206,11 +7740,16 @@ SCORE=| spamprobe receive | |||
| 7206 | spam/. | 7740 | spam/. |
| 7207 | @end smallexample | 7741 | @end smallexample |
| 7208 | 7742 | ||
| 7743 | @findex mh-junk-blacklist | ||
| 7744 | @findex mh-junk-whitelist | ||
| 7745 | @kindex J b | ||
| 7746 | @kindex J w | ||
| 7747 | |||
| 7209 | If SpamProbe classifies a message incorrectly, you can use the MH-E | 7748 | If SpamProbe classifies a message incorrectly, you can use the MH-E |
| 7210 | commands @kbd{J b} (@code{mh-junk-blacklist}) and @kbd{J w} | 7749 | commands @kbd{J b} (@code{mh-junk-blacklist}) and @kbd{J w} |
| 7211 | (@code{mh-junk-whitelist}) to update SpamProbe's training. | 7750 | (@code{mh-junk-whitelist}) to update SpamProbe's training. |
| 7212 | 7751 | ||
| 7213 | @heading Other Things You Can Do | 7752 | @subheading Other Things You Can Do |
| 7214 | 7753 | ||
| 7215 | There are a couple of things that you can add to @file{~/.procmailrc} | 7754 | There are a couple of things that you can add to @file{~/.procmailrc} |
| 7216 | in order to filter out a lot of spam and viruses. The first is to | 7755 | in order to filter out a lot of spam and viruses. The first is to |
| @@ -7270,10 +7809,11 @@ Display version information about MH-E and the MH mail handling | |||
| 7270 | system. | 7809 | system. |
| 7271 | @end ftable | 7810 | @end ftable |
| 7272 | 7811 | ||
| 7273 | @cindex @samp{*MH-E Info*} | ||
| 7274 | @cindex MH-E version | ||
| 7275 | @cindex buffers, @samp{*MH-E Info*} | 7812 | @cindex buffers, @samp{*MH-E Info*} |
| 7813 | @cindex MH-E version | ||
| 7814 | @cindex @samp{*MH-E Info*} | ||
| 7276 | @cindex version | 7815 | @cindex version |
| 7816 | @kindex M-x mh-version | ||
| 7277 | 7817 | ||
| 7278 | One command worth noting is @kbd{M-x mh-version}. You can compare the | 7818 | One command worth noting is @kbd{M-x mh-version}. You can compare the |
| 7279 | version this command prints to the latest release (@pxref{Getting | 7819 | version this command prints to the latest release (@pxref{Getting |
| @@ -7281,7 +7821,7 @@ MH-E}). The output of @kbd{M-x mh-version}, found in a buffer named | |||
| 7281 | @samp{*MH-E Info*}, should usually be included with any bug report you | 7821 | @samp{*MH-E Info*}, should usually be included with any bug report you |
| 7282 | submit (@pxref{Bug Reports}). | 7822 | submit (@pxref{Bug Reports}). |
| 7283 | 7823 | ||
| 7284 | @heading MH-E Buffers | 7824 | @subheading MH-E Buffers |
| 7285 | 7825 | ||
| 7286 | Besides the MH-Folder, MH-Show, and MH-Letter buffers, MH-E creates | 7826 | Besides the MH-Folder, MH-Show, and MH-Letter buffers, MH-E creates |
| 7287 | several other buffers. They are: | 7827 | several other buffers. They are: |
| @@ -7338,7 +7878,7 @@ This buffer contains the output of @kbd{S l} | |||
| 7338 | @c ------------------------- | 7878 | @c ------------------------- |
| 7339 | @cindex @samp{*mh-temp*} | 7879 | @cindex @samp{*mh-temp*} |
| 7340 | @cindex buffers, @samp{*mh-temp*} | 7880 | @cindex buffers, @samp{*mh-temp*} |
| 7341 | @item *mh-temp | 7881 | @item *mh-temp* |
| 7342 | This is a scratch, ephemeral, buffer used by MH-E functions. Note that | 7882 | This is a scratch, ephemeral, buffer used by MH-E functions. Note that |
| 7343 | it is hidden because the first character in the name is a space. | 7883 | it is hidden because the first character in the name is a space. |
| 7344 | You'll generally not have any need for this buffer. | 7884 | You'll generally not have any need for this buffer. |
| @@ -7370,12 +7910,10 @@ Specifies the format file to pass to the scan program (default: | |||
| 7370 | @samp{Use MH-E scan Format}). | 7910 | @samp{Use MH-E scan Format}). |
| 7371 | @c ------------------------- | 7911 | @c ------------------------- |
| 7372 | @item mh-scan-prog | 7912 | @item mh-scan-prog |
| 7373 | Program used to scan messages (default: @samp{"scan"}). | 7913 | Program used to scan messages (default: @code{"scan"}). |
| 7374 | @end vtable | 7914 | @end vtable |
| 7375 | 7915 | ||
| 7376 | @findex mh-set-cmd-note | ||
| 7377 | @vindex mh-adaptive-cmd-note-flag | 7916 | @vindex mh-adaptive-cmd-note-flag |
| 7378 | @vindex mh-scan-format-file | ||
| 7379 | 7917 | ||
| 7380 | There are a couple of caveats when creating your own scan format file. | 7918 | There are a couple of caveats when creating your own scan format file. |
| 7381 | First, MH-E will not work if your scan lines do not include message | 7919 | First, MH-E will not work if your scan lines do not include message |
| @@ -7385,6 +7923,9 @@ the option @code{mh-adaptive-cmd-note-flag} or the threading features | |||
| 7385 | (@pxref{Threading}). | 7923 | (@pxref{Threading}). |
| 7386 | 7924 | ||
| 7387 | @cindex message numbers | 7925 | @cindex message numbers |
| 7926 | @findex mh-set-cmd-note | ||
| 7927 | @vindex mh-adaptive-cmd-note-flag | ||
| 7928 | @vindex mh-scan-format-file | ||
| 7388 | 7929 | ||
| 7389 | If you've created your own format to handle long message numbers, | 7930 | If you've created your own format to handle long message numbers, |
| 7390 | you'll be pleased to know you no longer need it since MH-E adapts its | 7931 | you'll be pleased to know you no longer need it since MH-E adapts its |
| @@ -7395,8 +7936,10 @@ and call @code{mh-set-cmd-note} with the width specified by your | |||
| 7395 | format file (see @code{mh-scan-format-file}). For example, the default | 7936 | format file (see @code{mh-scan-format-file}). For example, the default |
| 7396 | width is 4, so you would use @samp{(mh-set-cmd-note 4)}. | 7937 | width is 4, so you would use @samp{(mh-set-cmd-note 4)}. |
| 7397 | 7938 | ||
| 7398 | @vindex mh-scan-format-nmh | 7939 | @vindex mh-adaptive-cmd-note-flag |
| 7940 | @vindex mh-scan-format-file | ||
| 7399 | @vindex mh-scan-format-mh | 7941 | @vindex mh-scan-format-mh |
| 7942 | @vindex mh-scan-format-nmh | ||
| 7400 | 7943 | ||
| 7401 | The default setting for @code{mh-scan-format-file} is @samp{Use MH-E | 7944 | The default setting for @code{mh-scan-format-file} is @samp{Use MH-E |
| 7402 | scan Format}. This means that the format string will be taken from the | 7945 | scan Format}. This means that the format string will be taken from the |
| @@ -7409,6 +7952,10 @@ shell. If you have a format file that you want MH-E to use but not MH, | |||
| 7409 | you can set this option to @samp{Specify a scan Format File} and enter | 7952 | you can set this option to @samp{Specify a scan Format File} and enter |
| 7410 | the name of your format file. | 7953 | the name of your format file. |
| 7411 | 7954 | ||
| 7955 | @vindex mh-scan-format-file | ||
| 7956 | @vindex mh-scan-format-mh | ||
| 7957 | @vindex mh-scan-format-nmh | ||
| 7958 | |||
| 7412 | The scan format that MH-E uses when @code{mh-scan-format-file} is set | 7959 | The scan format that MH-E uses when @code{mh-scan-format-file} is set |
| 7413 | to its default of @samp{Use MH-E scan Format} is held in the variables | 7960 | to its default of @samp{Use MH-E scan Format} is held in the variables |
| 7414 | @code{mh-scan-format-nmh} and @code{mh-scan-format-mh} depending on | 7961 | @code{mh-scan-format-nmh} and @code{mh-scan-format-mh} depending on |
| @@ -7432,8 +7979,9 @@ The value of @code{mh-scan-format-nmh} is: | |||
| 7432 | "%(decode@{subject@})%<@{body@}<<%@{body@}%>") | 7979 | "%(decode@{subject@})%<@{body@}<<%@{body@}%>") |
| 7433 | @end smallexample | 7980 | @end smallexample |
| 7434 | 7981 | ||
| 7435 | @cindex RFC 2047, decoding | ||
| 7436 | @cindex decoding RFC 2047 | 7982 | @cindex decoding RFC 2047 |
| 7983 | @cindex RFC 2047, decoding | ||
| 7984 | @vindex mh-scan-format-mh | ||
| 7437 | 7985 | ||
| 7438 | The setting for @code{mh-scan-format-mh} is similar, except that MH | 7986 | The setting for @code{mh-scan-format-mh} is similar, except that MH |
| 7439 | doesn't have the function @code{decode} (which is used to decode RFC | 7987 | doesn't have the function @code{decode} (which is used to decode RFC |
| @@ -7459,7 +8007,7 @@ the @samp{Bcc:} field matches, and @samp{n} if a non-empty | |||
| 7459 | @vindex mh-scan-prog | 8007 | @vindex mh-scan-prog |
| 7460 | 8008 | ||
| 7461 | The name of the program that generates a listing of one line per | 8009 | The name of the program that generates a listing of one line per |
| 7462 | message is held in @code{mh-scan-prog} (default: @samp{"scan"}). | 8010 | message is held in @code{mh-scan-prog} (default: @code{"scan"}). |
| 7463 | Unless this variable contains an absolute pathname, it is assumed to | 8011 | Unless this variable contains an absolute pathname, it is assumed to |
| 7464 | be in the @code{mh-progs} directory (@pxref{Getting Started}). You may | 8012 | be in the @code{mh-progs} directory (@pxref{Getting Started}). You may |
| 7465 | link another program to @command{scan} (see @samp{mh-profile}(5)) to | 8013 | link another program to @command{scan} (see @samp{mh-profile}(5)) to |
| @@ -7468,25 +8016,26 @@ produce a different type of listing@footnote{See the section | |||
| 7468 | pick Ranges Sequences} in the MH book.}. | 8016 | pick Ranges Sequences} in the MH book.}. |
| 7469 | 8017 | ||
| 7470 | @cindex regular expressions, scan line formats | 8018 | @cindex regular expressions, scan line formats |
| 8019 | @findex mh-set-cmd-note | ||
| 8020 | @findex setq | ||
| 7471 | 8021 | ||
| 7472 | If you change the format of the scan lines you'll need to tell MH-E | 8022 | If you change the format of the scan lines you'll need to tell MH-E |
| 7473 | how to parse the new format. As you will see, quite a lot of variables | 8023 | how to parse the new format. As you will see, quite a lot of variables |
| 7474 | are involved to do that. Use @samp{M-x apropos @key{RET} mh-scan.*regexp'} | 8024 | are involved to do that. Use @kbd{M-x apropos @key{RET} |
| 7475 | to obtain a list of these variables. You will also have to call | 8025 | mh-scan.*regexp @key{RET}} to obtain a list of these variables. You |
| 7476 | @code{mh-set-cmd-note} if your notations are not in column 4 (columns | 8026 | will also have to call @code{mh-set-cmd-note} if your notations are |
| 7477 | in Emacs start with 0). Note that unlike most of the user options | 8027 | not in column 4 (columns in Emacs start with 0). Note that unlike most |
| 7478 | described in this manual, these are variables and must be set with | 8028 | of the user options described in this manual, these are variables and |
| 7479 | @code{setq} instead of in a customization buffer. For help with | 8029 | must be set with @code{setq} instead of in a customization buffer. For |
| 7480 | regular expressions, see | 8030 | help with regular expressions, see |
| 7481 | @ifnothtml | 8031 | @ifnothtml |
| 7482 | @ref{Regexps, , Syntax of Regular Expressions, emacs, The | 8032 | @ref{Regexps, , Syntax of Regular Expressions, emacs, The |
| 7483 | GNU Emacs Manual} | 8033 | GNU Emacs Manual}. |
| 7484 | @end ifnothtml | 8034 | @end ifnothtml |
| 7485 | @ifhtml | 8035 | @ifhtml |
| 7486 | the section | 8036 | section |
| 7487 | @uref{http://www.gnu.org/software/emacs/manual/html_node/Regexps.html, | 8037 | @uref{http://www.gnu.org/software/emacs/manual/html_node/Regexps.html, |
| 7488 | Syntax of Regular Expressions} in | 8038 | Syntax of Regular Expressions} in @cite{The GNU Emacs Manual}. |
| 7489 | @cite{The GNU Emacs Manual}). | ||
| 7490 | @end ifhtml | 8039 | @end ifhtml |
| 7491 | 8040 | ||
| 7492 | The first variable has to do with pruning out garbage. | 8041 | The first variable has to do with pruning out garbage. |
| @@ -7501,13 +8050,11 @@ This regular expression describes a valid scan line. This is used to | |||
| 7501 | eliminate error messages that are occasionally produced by | 8050 | eliminate error messages that are occasionally produced by |
| 7502 | @command{inc}@footnote{See the section | 8051 | @command{inc}@footnote{See the section |
| 7503 | @uref{@value{MH-BOOK-HOME}/reapre.htm, Reading Mail: inc show next | 8052 | @uref{@value{MH-BOOK-HOME}/reapre.htm, Reading Mail: inc show next |
| 7504 | prev} in the MH book.} or @command{scan} (default: @samp{"^ *[0-9]"}). | 8053 | prev} in the MH book.} or @command{scan} (default: @code{"^ *[0-9]"}). |
| 7505 | @end vtable | 8054 | @end vtable |
| 7506 | 8055 | ||
| 7507 | Next, many variables control how the scan lines are parsed. | 8056 | Next, many variables control how the scan lines are parsed. |
| 7508 | 8057 | ||
| 7509 | @vindex mh-folder-font-lock-keywords | ||
| 7510 | |||
| 7511 | @vtable @code | 8058 | @vtable @code |
| 7512 | @vindex mh-folder-body | 8059 | @vindex mh-folder-body |
| 7513 | @vindex mh-folder-font-lock-keywords | 8060 | @vindex mh-folder-font-lock-keywords |
| @@ -7516,7 +8063,7 @@ This regular expression matches the message body fragment. Note that | |||
| 7516 | the default setting of @code{mh-folder-font-lock-keywords} expects | 8063 | the default setting of @code{mh-folder-font-lock-keywords} expects |
| 7517 | this expression to contain at least one parenthesized expression which | 8064 | this expression to contain at least one parenthesized expression which |
| 7518 | matches the body text as in the default of | 8065 | matches the body text as in the default of |
| 7519 | @samp{"\\(<<\\([^\n]+\\)?\\)"}. If this regular expression is not | 8066 | @code{"\\(<<\\([^\n]+\\)?\\)"}. If this regular expression is not |
| 7520 | correct, the body fragment will not be highlighted with the face | 8067 | correct, the body fragment will not be highlighted with the face |
| 7521 | @code{mh-folder-body}. | 8068 | @code{mh-folder-body}. |
| 7522 | @c ------------------------- | 8069 | @c ------------------------- |
| @@ -7528,7 +8075,7 @@ This regular expression matches the current message. It must match | |||
| 7528 | from the beginning of the line. Note that the default setting of | 8075 | from the beginning of the line. Note that the default setting of |
| 7529 | @code{mh-folder-font-lock-keywords} expects this expression to contain | 8076 | @code{mh-folder-font-lock-keywords} expects this expression to contain |
| 7530 | at least one parenthesized expression which matches the message number | 8077 | at least one parenthesized expression which matches the message number |
| 7531 | as in the default of @w{@samp{"^\\( *[0-9]+\\+\\).*"}}. This | 8078 | as in the default of @w{@code{"^\\( *[0-9]+\\+\\).*"}}. This |
| 7532 | expression includes the leading space and current message marker | 8079 | expression includes the leading space and current message marker |
| 7533 | @samp{+} within the parenthesis since it looks better to highlight | 8080 | @samp{+} within the parenthesis since it looks better to highlight |
| 7534 | these items as well. The highlighting is done with the face | 8081 | these items as well. The highlighting is done with the face |
| @@ -7545,7 +8092,7 @@ anchored to the beginning or the end of the line. Note that the | |||
| 7545 | default setting of @code{mh-folder-font-lock-keywords} expects this | 8092 | default setting of @code{mh-folder-font-lock-keywords} expects this |
| 7546 | expression to contain only one parenthesized expression which matches | 8093 | expression to contain only one parenthesized expression which matches |
| 7547 | the date field as in the default of | 8094 | the date field as in the default of |
| 7548 | @samp{"\\([0-9][0-9]/[0-9][0-9]\\)"}. If this regular expression is | 8095 | @code{"\\([0-9][0-9]/[0-9][0-9]\\)"}. If this regular expression is |
| 7549 | not correct, the date will not be highlighted with the face | 8096 | not correct, the date will not be highlighted with the face |
| 7550 | @code{mh-folder-date}. | 8097 | @code{mh-folder-date}. |
| 7551 | @c ------------------------- | 8098 | @c ------------------------- |
| @@ -7557,7 +8104,7 @@ This regular expression matches deleted messages. It must match from | |||
| 7557 | the beginning of the line. Note that the default setting of | 8104 | the beginning of the line. Note that the default setting of |
| 7558 | @code{mh-folder-font-lock-keywords} expects this expression to contain | 8105 | @code{mh-folder-font-lock-keywords} expects this expression to contain |
| 7559 | at least one parenthesized expression which matches the message number | 8106 | at least one parenthesized expression which matches the message number |
| 7560 | as in the default of @samp{"^\\( *[0-9]+\\)D"}. This expression | 8107 | as in the default of @code{"^\\( *[0-9]+\\)D"}. This expression |
| 7561 | includes the leading space within the parenthesis since it looks | 8108 | includes the leading space within the parenthesis since it looks |
| 7562 | better to highlight it as well. The highlighting is done with the face | 8109 | better to highlight it as well. The highlighting is done with the face |
| 7563 | @code{mh-folder-deleted}. This regular expression should be correct as | 8110 | @code{mh-folder-deleted}. This regular expression should be correct as |
| @@ -7571,7 +8118,7 @@ This regular expression matches ``good'' messages. It must match from | |||
| 7571 | the beginning of the line. Note that the default setting of | 8118 | the beginning of the line. Note that the default setting of |
| 7572 | @code{mh-folder-font-lock-keywords} expects this expression to contain | 8119 | @code{mh-folder-font-lock-keywords} expects this expression to contain |
| 7573 | at least one parenthesized expression which matches the message number | 8120 | at least one parenthesized expression which matches the message number |
| 7574 | as in the default of @w{@samp{"^\\( *[0-9]+\\)[^D^0-9]"}}. This | 8121 | as in the default of @w{@code{"^\\( *[0-9]+\\)[^D^0-9]"}}. This |
| 7575 | expression includes the leading space within the parenthesis since it | 8122 | expression includes the leading space within the parenthesis since it |
| 7576 | looks better to highlight it as well. The highlighting is done with | 8123 | looks better to highlight it as well. The highlighting is done with |
| 7577 | the face @code{mh-folder-msg-number}. This regular expression should | 8124 | the face @code{mh-folder-msg-number}. This regular expression should |
| @@ -7581,7 +8128,7 @@ be correct as it is needed by non-fontification functions. | |||
| 7581 | @item mh-scan-msg-format-regexp | 8128 | @item mh-scan-msg-format-regexp |
| 7582 | This regular expression finds the message number width in a scan | 8129 | This regular expression finds the message number width in a scan |
| 7583 | format. Note that the message number must be placed in a parenthesized | 8130 | format. Note that the message number must be placed in a parenthesized |
| 7584 | expression as in the default of @samp{"%\\([0-9]*\\)(msg)"}. This | 8131 | expression as in the default of @code{"%\\([0-9]*\\)(msg)"}. This |
| 7585 | variable is only consulted if @code{mh-scan-format-file} is set to | 8132 | variable is only consulted if @code{mh-scan-format-file} is set to |
| 7586 | @samp{Use MH-E scan Format}. | 8133 | @samp{Use MH-E scan Format}. |
| 7587 | @c ------------------------- | 8134 | @c ------------------------- |
| @@ -7590,22 +8137,22 @@ variable is only consulted if @code{mh-scan-format-file} is set to | |||
| 7590 | This is a format string for the width of the message number in a scan | 8137 | This is a format string for the width of the message number in a scan |
| 7591 | format. Use @samp{0%d} for zero-filled message numbers. This variable | 8138 | format. Use @samp{0%d} for zero-filled message numbers. This variable |
| 7592 | is only consulted if @code{mh-scan-format-file} is set to @samp{Use | 8139 | is only consulted if @code{mh-scan-format-file} is set to @samp{Use |
| 7593 | MH-E scan Format} (default: @samp{"%d"}). | 8140 | MH-E scan Format} (default: @code{"%d"}). |
| 7594 | @c ------------------------- | 8141 | @c ------------------------- |
| 7595 | @item mh-scan-msg-number-regexp | 8142 | @item mh-scan-msg-number-regexp |
| 7596 | This regular expression extracts the message number. It must match | 8143 | This regular expression extracts the message number. It must match |
| 7597 | from the beginning of the line. Note that the message number must be | 8144 | from the beginning of the line. Note that the message number must be |
| 7598 | placed in a parenthesized expression as in the default of @w{@samp{"^ | 8145 | placed in a parenthesized expression as in the default of @w{@code{"^ |
| 7599 | *\\([0-9]+\\)"}}. | 8146 | *\\([0-9]+\\)"}}. |
| 7600 | @c ------------------------- | 8147 | @c ------------------------- |
| 7601 | @item mh-scan-msg-overflow-regexp | 8148 | @item mh-scan-msg-overflow-regexp |
| 7602 | This regular expression matches overflowed message numbers (default: | 8149 | This regular expression matches overflowed message numbers (default: |
| 7603 | @samp{"^[?0-9][0-9]"}). | 8150 | @code{"^[?0-9][0-9]"}). |
| 7604 | @c ------------------------- | 8151 | @c ------------------------- |
| 7605 | @item mh-scan-msg-search-regexp | 8152 | @item mh-scan-msg-search-regexp |
| 7606 | This regular expression matches a particular message. It is a format | 8153 | This regular expression matches a particular message. It is a format |
| 7607 | string; use @samp{%d} to represent the location of the message number | 8154 | string; use @samp{%d} to represent the location of the message number |
| 7608 | within the expression as in the default of @samp{"^[^0-9]*%d[^0-9]"}. | 8155 | within the expression as in the default of @code{"^[^0-9]*%d[^0-9]"}. |
| 7609 | @c ------------------------- | 8156 | @c ------------------------- |
| 7610 | @vindex mh-folder-address | 8157 | @vindex mh-folder-address |
| 7611 | @vindex mh-folder-font-lock-keywords | 8158 | @vindex mh-folder-font-lock-keywords |
| @@ -7616,7 +8163,7 @@ Note that the default setting of @code{mh-folder-font-lock-keywords} | |||
| 7616 | expects this expression to contain two parenthesized expressions. The | 8163 | expects this expression to contain two parenthesized expressions. The |
| 7617 | first is expected to match the @samp{To:} that the default scan format | 8164 | first is expected to match the @samp{To:} that the default scan format |
| 7618 | file generates. The second is expected to match the recipient's name | 8165 | file generates. The second is expected to match the recipient's name |
| 7619 | as in the default of @samp{"\\(To:\\)\\(..............\\)"}. If this | 8166 | as in the default of @code{"\\(To:\\)\\(..............\\)"}. If this |
| 7620 | regular expression is not correct, the @samp{To:} string will not be | 8167 | regular expression is not correct, the @samp{To:} string will not be |
| 7621 | highlighted with the face @code{mh-folder-to} and the recipient will not be | 8168 | highlighted with the face @code{mh-folder-to} and the recipient will not be |
| 7622 | highlighted with the face @code{mh-folder-address}. | 8169 | highlighted with the face @code{mh-folder-address}. |
| @@ -7629,7 +8176,7 @@ This regular expression matches refiled messages. It must match from | |||
| 7629 | the beginning of the line. Note that the default setting of | 8176 | the beginning of the line. Note that the default setting of |
| 7630 | @code{mh-folder-font-lock-keywords} expects this expression to contain | 8177 | @code{mh-folder-font-lock-keywords} expects this expression to contain |
| 7631 | at least one parenthesized expression which matches the message number | 8178 | at least one parenthesized expression which matches the message number |
| 7632 | as in the default of @w{@samp{"^\\( *[0-9]+\\)\\^"}}. This expression | 8179 | as in the default of @w{@code{"^\\( *[0-9]+\\)\\^"}}. This expression |
| 7633 | includes the leading space within the parenthesis since it looks | 8180 | includes the leading space within the parenthesis since it looks |
| 7634 | better to highlight it as well. The highlighting is done with the face | 8181 | better to highlight it as well. The highlighting is done with the face |
| 7635 | @code{mh-folder-refiled}. This regular expression should be correct as | 8182 | @code{mh-folder-refiled}. This regular expression should be correct as |
| @@ -7647,7 +8194,7 @@ expression to contain at least two parenthesized expressions. The | |||
| 7647 | first should match the fontification hint (see | 8194 | first should match the fontification hint (see |
| 7648 | @code{mh-scan-format-nmh}) and the second should match the user name | 8195 | @code{mh-scan-format-nmh}) and the second should match the user name |
| 7649 | as in the default of | 8196 | as in the default of |
| 7650 | @w{@samp{"^ *[0-9]+.\\([bct]\\).....[ ]*\\(..................\\)"}}. | 8197 | @w{@code{"^ *[0-9]+.\\([bct]\\).....[ ]*\\(..................\\)"}}. |
| 7651 | If this regular expression is not correct, the notation hints will not | 8198 | If this regular expression is not correct, the notation hints will not |
| 7652 | be highlighted with the face @code{mh-mh-folder-sent-to-me-hint} and | 8199 | be highlighted with the face @code{mh-mh-folder-sent-to-me-hint} and |
| 7653 | the sender will not be highlighted with the face | 8200 | the sender will not be highlighted with the face |
| @@ -7667,8 +8214,8 @@ number after @samp{Re:}, such as in @samp{Re[2]:} (and is thus a | |||
| 7667 | sub-expression of the first expression). The third is expected to | 8214 | sub-expression of the first expression). The third is expected to |
| 7668 | match the subject line itself which is highlighted with the face | 8215 | match the subject line itself which is highlighted with the face |
| 7669 | @code{mh-folder-subject}. For example, the default is | 8216 | @code{mh-folder-subject}. For example, the default is |
| 7670 | @w{@samp{"^ *[0-9]+........[ ]*...................}}@* | 8217 | @w{@code{"^ *[0-9]+........[ ]*...................}}@* |
| 7671 | @w{@samp{\\([Rr][Ee]\\(\\[[0-9]+\\]\\)?:\\s-*\\)*\\([^<\n]*\\)"}}. | 8218 | @w{@code{\\([Rr][Ee]\\(\\[[0-9]+\\]\\)?:\\s-*\\)*\\([^<\n]*\\)"}}. |
| 7672 | This regular expression should be correct as it is needed by | 8219 | This regular expression should be correct as it is needed by |
| 7673 | non-fontification functions. Note that this example is broken up on | 8220 | non-fontification functions. Note that this example is broken up on |
| 7674 | two lines for readability, but is actually a single string. | 8221 | two lines for readability, but is actually a single string. |
| @@ -7678,6 +8225,8 @@ Finally, there are a slew of variables that control how MH-E annotates | |||
| 7678 | the scan lines. | 8225 | the scan lines. |
| 7679 | 8226 | ||
| 7680 | @vtable @code | 8227 | @vtable @code |
| 8228 | @findex mh-set-cmd-note | ||
| 8229 | @vindex mh-adaptive-cmd-note-flag | ||
| 7681 | @item mh-cmd-note | 8230 | @item mh-cmd-note |
| 7682 | Column for notations (default: 4). This variable should be set with | 8231 | Column for notations (default: 4). This variable should be set with |
| 7683 | the function @code{mh-set-cmd-note}. This variable may be updated | 8232 | the function @code{mh-set-cmd-note}. This variable may be updated |
| @@ -7687,39 +8236,42 @@ Emacs start with 0. | |||
| 7687 | @c ------------------------- | 8236 | @c ------------------------- |
| 7688 | @item mh-note-copied | 8237 | @item mh-note-copied |
| 7689 | Messages that have been copied are marked by this character (default: | 8238 | Messages that have been copied are marked by this character (default: |
| 7690 | @samp{?C}). | 8239 | @code{?C}). |
| 7691 | @c ------------------------- | 8240 | @c ------------------------- |
| 8241 | @vindex mh-scan-cur-msg-number-regexp | ||
| 7692 | @item mh-note-cur | 8242 | @item mh-note-cur |
| 7693 | The current message (in MH, not in MH-E) is marked by this character | 8243 | The current message (in MH, not in MH-E) is marked by this character |
| 7694 | (default: @samp{?+}). See also @code{mh-scan-cur-msg-number-regexp}. | 8244 | (default: @code{?+}). See also @code{mh-scan-cur-msg-number-regexp}. |
| 7695 | @c ------------------------- | 8245 | @c ------------------------- |
| 8246 | @vindex mh-scan-deleted-msg-regexp | ||
| 7696 | @item mh-note-deleted | 8247 | @item mh-note-deleted |
| 7697 | Messages that have been deleted are marked by this character (default: | 8248 | Messages that have been deleted are marked by this character (default: |
| 7698 | @samp{?D}). See also @code{mh-scan-deleted-msg-regexp}. | 8249 | @code{?D}). See also @code{mh-scan-deleted-msg-regexp}. |
| 7699 | @c ------------------------- | 8250 | @c ------------------------- |
| 7700 | @item mh-note-dist | 8251 | @item mh-note-dist |
| 7701 | Messages that have been redistributed are marked by this character | 8252 | Messages that have been redistributed are marked by this character |
| 7702 | (default: @samp{?R}). | 8253 | (default: @code{?R}). |
| 7703 | @c ------------------------- | 8254 | @c ------------------------- |
| 7704 | @item mh-note-forw | 8255 | @item mh-note-forw |
| 7705 | Messages that have been forwarded are marked by this character | 8256 | Messages that have been forwarded are marked by this character |
| 7706 | (default: @samp{?F}). | 8257 | (default: @code{?F}). |
| 7707 | @c ------------------------- | 8258 | @c ------------------------- |
| 7708 | @item mh-note-printed | 8259 | @item mh-note-printed |
| 7709 | Messages that have been printed are marked by this character (default: | 8260 | Messages that have been printed are marked by this character (default: |
| 7710 | @samp{?P}). | 8261 | @code{?P}). |
| 7711 | @c ------------------------- | 8262 | @c ------------------------- |
| 8263 | @vindex mh-scan-refiled-msg-regexp | ||
| 7712 | @item mh-note-refiled | 8264 | @item mh-note-refiled |
| 7713 | Messages that have been refiled are marked by this character (default: | 8265 | Messages that have been refiled are marked by this character (default: |
| 7714 | @samp{?^}). See also @code{mh-scan-refiled-msg-regexp}. | 8266 | @code{?^}). See also @code{mh-scan-refiled-msg-regexp}. |
| 7715 | @c ------------------------- | 8267 | @c ------------------------- |
| 7716 | @item mh-note-repl | 8268 | @item mh-note-repl |
| 7717 | Messages that have been replied to are marked by this character | 8269 | Messages that have been replied to are marked by this character |
| 7718 | (default: @samp{?-}). | 8270 | (default: @code{?-}). |
| 7719 | @c ------------------------- | 8271 | @c ------------------------- |
| 7720 | @item mh-note-seq | 8272 | @item mh-note-seq |
| 7721 | Messages in a user-defined sequence are marked by this character | 8273 | Messages in a user-defined sequence are marked by this character |
| 7722 | (default: @samp{?%}). Messages in the @samp{search} sequence are | 8274 | (default: @code{?%}). Messages in the @samp{search} sequence are |
| 7723 | marked by this character as well. | 8275 | marked by this character as well. |
| 7724 | @end vtable | 8276 | @end vtable |
| 7725 | 8277 | ||
| @@ -7732,6 +8284,8 @@ message according to MH; it also uses that column for notations. | |||
| 7732 | %20(decode(friendly@{from@})) %50(decode@{subject@}) %4(msg)%<(cur)+%| %> | 8284 | %20(decode(friendly@{from@})) %50(decode@{subject@}) %4(msg)%<(cur)+%| %> |
| 7733 | @end example | 8285 | @end example |
| 7734 | 8286 | ||
| 8287 | @vindex mh-adaptive-cmd-note-flag | ||
| 8288 | @vindex mh-scan-format-file | ||
| 7735 | @vindex mh-scan-format-file, example | 8289 | @vindex mh-scan-format-file, example |
| 7736 | 8290 | ||
| 7737 | The first thing you have to do is tell MH-E to use this file. | 8291 | The first thing you have to do is tell MH-E to use this file. |
| @@ -7916,9 +8470,10 @@ Select the @samp{Several files in a directory} value, check the | |||
| 7916 | @samp{Path} box and enter @file{~/Mail} to tell Gnus where to find | 8470 | @samp{Path} box and enter @file{~/Mail} to tell Gnus where to find |
| 7917 | your mail. | 8471 | your mail. |
| 7918 | @c ------------------------- | 8472 | @c ------------------------- |
| 8473 | @vindex mail-user-agent | ||
| 7919 | @item message-mail-user-agent | 8474 | @item message-mail-user-agent |
| 7920 | In order to send mail within Gnus using MH-E, set this option to | 8475 | In order to send mail within Gnus using MH-E, set this option to |
| 7921 | @samp{mail-user-agent} and set the @samp{mail-user-agent} option to | 8476 | @samp{mail-user-agent} and set the @code{mail-user-agent} option to |
| 7922 | @samp{Emacs interface to MH}. | 8477 | @samp{Emacs interface to MH}. |
| 7923 | @c ------------------------- | 8478 | @c ------------------------- |
| 7924 | @item nnmail-keep-last-article | 8479 | @item nnmail-keep-last-article |
| @@ -7966,8 +8521,9 @@ I also point out some additional sources of information. | |||
| 7966 | @node Bug Reports, Mailing Lists, Odds and Ends, Odds and Ends | 8521 | @node Bug Reports, Mailing Lists, Odds and Ends, Odds and Ends |
| 7967 | @appendixsec Bug Reports | 8522 | @appendixsec Bug Reports |
| 7968 | 8523 | ||
| 7969 | @cindex SourceForge | ||
| 7970 | @cindex bugs | 8524 | @cindex bugs |
| 8525 | @cindex SourceForge | ||
| 8526 | @kindex M-x mh-version | ||
| 7971 | 8527 | ||
| 7972 | Bug reports should be filed at | 8528 | Bug reports should be filed at |
| 7973 | @uref{https://sourceforge.net/bugs/?group_id=13357, SourceForge}. You | 8529 | @uref{https://sourceforge.net/bugs/?group_id=13357, SourceForge}. You |
| @@ -8025,7 +8581,6 @@ distribution in @file{miscellany/mh-e}. | |||
| 8025 | @cindex change log | 8581 | @cindex change log |
| 8026 | @cindex release notes | 8582 | @cindex release notes |
| 8027 | 8583 | ||
| 8028 | @c intentionally wordy to avoid overfull hbox | ||
| 8029 | New MH-E releases are always available for downloading at | 8584 | New MH-E releases are always available for downloading at |
| 8030 | @uref{https://sourceforge.net/project/showfiles.php?group_id=13357, | 8585 | @uref{https://sourceforge.net/project/showfiles.php?group_id=13357, |
| 8031 | SourceForge} before they appear in an Emacs release. You can read the | 8586 | SourceForge} before they appear in an Emacs release. You can read the |
| @@ -8035,11 +8590,12 @@ change log to see if you are interested in what the given release of | |||
| 8035 | MH-E has to offer (although we have no doubt that you will be | 8590 | MH-E has to offer (although we have no doubt that you will be |
| 8036 | extremely interested in all new releases). | 8591 | extremely interested in all new releases). |
| 8037 | 8592 | ||
| 8038 | @cindex @samp{MH-E-NEWS} | ||
| 8039 | @cindex @samp{README} | ||
| 8040 | @cindex files, @samp{MH-E-NEWS} | 8593 | @cindex files, @samp{MH-E-NEWS} |
| 8041 | @cindex files, @samp{README} | 8594 | @cindex files, @samp{README} |
| 8042 | @cindex news | 8595 | @cindex news |
| 8596 | @cindex @samp{MH-E-NEWS} | ||
| 8597 | @cindex @samp{README} | ||
| 8598 | @kindex M-x mh-version | ||
| 8043 | 8599 | ||
| 8044 | After you download and extract the MH-E tarball, read the | 8600 | After you download and extract the MH-E tarball, read the |
| 8045 | @file{README} file and @file{MH-E-NEWS}. These correspond to the | 8601 | @file{README} file and @file{MH-E-NEWS}. These correspond to the |
| @@ -8232,20 +8788,24 @@ was incorporated into @w{Emacs 19.29}. | |||
| 8232 | After a long break, Stephen handed the reins over to me in 2000. I | 8788 | After a long break, Stephen handed the reins over to me in 2000. I |
| 8233 | moved the project to a new site called SourceForge and organized a | 8789 | moved the project to a new site called SourceForge and organized a |
| 8234 | great team of developers. Our first release in late 2001 was version | 8790 | great team of developers. Our first release in late 2001 was version |
| 8235 | 6. It appeared in Emacs 21.2 and had menus and tool bar buttons. | 8791 | 6. It appeared around the time of Emacs 21.2 and had menus and tool |
| 8792 | bar buttons. | ||
| 8236 | 8793 | ||
| 8237 | Then, indexed searches, improved MIME handling, a speedbar, multiple | 8794 | Then, indexed searches, improved MIME handling, a speedbar, multiple |
| 8238 | identities, alias completion, an index view of unseen messages, spam | 8795 | identities, alias completion, an index view of unseen messages, spam |
| 8239 | software support, Face and X-Image-URL header field support, Fcc | 8796 | software support, Face and X-Image-URL header field support, Fcc |
| 8240 | completion, arbitrary range handling, and draft form editing were | 8797 | completion, arbitrary range handling, and draft form editing were |
| 8241 | introduced in the version 7 series in Emacs 21.4 (2004). | 8798 | introduced in the version 7 series around the time of Emacs 21.4 |
| 8799 | (2004). Still, Emacs itself contained version 5 of MH-E released back | ||
| 8800 | in 1994. | ||
| 8242 | 8801 | ||
| 8243 | Version 8 development was mostly driven by the rewrite of the manual. | 8802 | Version 8 development was mostly driven by the rewrite of the manual. |
| 8244 | It also brought mailutils support, S/MIME support, picon support, and | 8803 | It also brought mailutils support, S/MIME support, picon support, and |
| 8245 | an improved interface for hiding header fields. The CVS repository was | 8804 | an improved interface for hiding header fields. The CVS repository was |
| 8246 | migrated from SourceForge to Savannah (only for those files that were | 8805 | migrated from SourceForge to Savannah (only for those files that were |
| 8247 | already part of Emacs) and the software was completely reorganized to | 8806 | already part of Emacs) and the software was completely reorganized to |
| 8248 | push back two decades of entropy. It appeared in Emacs 22.1 (2006). | 8807 | push back two decades of entropy. Version 8 will appear in Emacs 22.1, |
| 8808 | expected to be released in 2006. | ||
| 8249 | 8809 | ||
| 8250 | Bill Wohler, February 2006 | 8810 | Bill Wohler, February 2006 |
| 8251 | 8811 | ||
diff --git a/man/org.texi b/man/org.texi index 29436365feb..06deb034a3a 100644 --- a/man/org.texi +++ b/man/org.texi | |||
| @@ -4,7 +4,7 @@ | |||
| 4 | @setfilename ../info/org | 4 | @setfilename ../info/org |
| 5 | @settitle Org Mode Manual | 5 | @settitle Org Mode Manual |
| 6 | 6 | ||
| 7 | @set VERSION 4.08 | 7 | @set VERSION 4.09 |
| 8 | @set DATE March 2006 | 8 | @set DATE March 2006 |
| 9 | 9 | ||
| 10 | @dircategory Emacs | 10 | @dircategory Emacs |
| @@ -22,6 +22,7 @@ | |||
| 22 | 22 | ||
| 23 | @c Macro definitions | 23 | @c Macro definitions |
| 24 | 24 | ||
| 25 | @c FIXME: does not look good in html | ||
| 25 | @c Subheadings inside a table. Need a difference between info and the rest. | 26 | @c Subheadings inside a table. Need a difference between info and the rest. |
| 26 | @macro tsubheading{text} | 27 | @macro tsubheading{text} |
| 27 | @ifinfo | 28 | @ifinfo |
| @@ -3063,8 +3064,18 @@ to read. To do this, customize the variable | |||
| 3063 | @end lisp | 3064 | @end lisp |
| 3064 | 3065 | ||
| 3065 | @noindent | 3066 | @noindent |
| 3066 | and restart emacs (this is necessary to make this change effective). | 3067 | or change this on a per-file basis with one of the lines (anywhere in |
| 3067 | The tree then becomes | 3068 | the buffer) |
| 3069 | |||
| 3070 | @example | ||
| 3071 | #+STARTUP: showstars | ||
| 3072 | #+STARTUP: hidestars | ||
| 3073 | @end example | ||
| 3074 | @noindent | ||
| 3075 | Press @kbd{C-c C-c} with the cursor in a @samp{STARTUP} line to activate | ||
| 3076 | the modifications. | ||
| 3077 | |||
| 3078 | With stars hidden, the tree becomes: | ||
| 3068 | 3079 | ||
| 3069 | @example | 3080 | @example |
| 3070 | * Top level headline | 3081 | * Top level headline |
| @@ -3101,17 +3112,28 @@ outline level to the next: | |||
| 3101 | 3112 | ||
| 3102 | @noindent | 3113 | @noindent |
| 3103 | In order to make the structure editing and export commands handle this | 3114 | In order to make the structure editing and export commands handle this |
| 3104 | convention correctly, use (again a restart of emacs will be needed) | 3115 | convention correctly, use |
| 3105 | 3116 | ||
| 3106 | @lisp | 3117 | @lisp |
| 3107 | (setq org-odd-levels-only t) | 3118 | (setq org-odd-levels-only t) |
| 3108 | @end lisp | 3119 | @end lisp |
| 3109 | 3120 | ||
| 3110 | @noindent | 3121 | @noindent |
| 3122 | or set this on a per-file basis with one of the following lines (don't | ||
| 3123 | forget to press @kbd{C-c C-c} with the cursor in the startup line to | ||
| 3124 | activate changes immediately). | ||
| 3125 | |||
| 3126 | @example | ||
| 3127 | #+STARTUP: odd | ||
| 3128 | #+STARTUP: oddeven | ||
| 3129 | @end example | ||
| 3130 | |||
| 3111 | You can convert an Org-mode file from single-star-per-level to | 3131 | You can convert an Org-mode file from single-star-per-level to |
| 3112 | double-star-per-level convention with @kbd{M-x org-convert-to-odd-levels | 3132 | double-star-per-level convention with @kbd{M-x org-convert-to-odd-levels |
| 3113 | RET} in that file. It is not possible to use this setting on a | 3133 | RET} in that file. There is no command for the back conversion because |
| 3114 | file-local basis, so you need to decide which format to use. | 3134 | such a command might merge levels and in this way destroy the |
| 3135 | structure of the tree. | ||
| 3136 | @c FIXME: Maybe we should have such a command... | ||
| 3115 | 3137 | ||
| 3116 | @node TTY keys, FAQ, Clean view, Miscellaneous | 3138 | @node TTY keys, FAQ, Clean view, Miscellaneous |
| 3117 | @section Using org-mode on a tty | 3139 | @section Using org-mode on a tty |
| @@ -3130,7 +3152,6 @@ work-around can be better. For example changing a time stamp is | |||
| 3130 | really only fun with @kbd{S-@key{cursor}} keys. On a tty you would | 3152 | really only fun with @kbd{S-@key{cursor}} keys. On a tty you would |
| 3131 | rather use @kbd{C-c .} to re-insert the timestamp. | 3153 | rather use @kbd{C-c .} to re-insert the timestamp. |
| 3132 | 3154 | ||
| 3133 | @page | ||
| 3134 | @multitable @columnfractions 0.15 0.2 0.2 | 3155 | @multitable @columnfractions 0.15 0.2 0.2 |
| 3135 | @item @b{Default} @tab @b{Alternative 1} @tab @b{Alternative 2} | 3156 | @item @b{Default} @tab @b{Alternative 1} @tab @b{Alternative 2} |
| 3136 | @item @kbd{S-@key{TAB}} @tab @kbd{C-u @key{TAB}} @tab | 3157 | @item @kbd{S-@key{TAB}} @tab @kbd{C-u @key{TAB}} @tab |
| @@ -3339,7 +3360,7 @@ to have other replacement keys, look at the variable | |||
| 3339 | @code{org-disputed-keys}. | 3360 | @code{org-disputed-keys}. |
| 3340 | @item @file{remember.el} by John Wiegley | 3361 | @item @file{remember.el} by John Wiegley |
| 3341 | Org mode cooperates with remember, see @ref{Remember}. | 3362 | Org mode cooperates with remember, see @ref{Remember}. |
| 3342 | @file{remember.el} is not part of Emacs, find it on the web. | 3363 | @file{Remember.el} is not part of Emacs, find it on the web. |
| 3343 | @cindex @file{planner.el} | 3364 | @cindex @file{planner.el} |
| 3344 | @item @file{planner.el} by John Wiegley | 3365 | @item @file{planner.el} by John Wiegley |
| 3345 | Planner is another tool to plan work and keep track of tasks. Planner | 3366 | Planner is another tool to plan work and keep track of tasks. Planner |
| @@ -3388,7 +3409,7 @@ However, from Org-mode's timeline and agenda buffers (created with | |||
| 3388 | @kbd{C-c C-r} and @kbd{C-c a}), things do work correctly. | 3409 | @kbd{C-c C-r} and @kbd{C-c a}), things do work correctly. |
| 3389 | @item | 3410 | @item |
| 3390 | You can only make a single word boldface or italic. To emphasize | 3411 | You can only make a single word boldface or italic. To emphasize |
| 3391 | several words in a row, each much have the emphasize markers, like in | 3412 | several words in a row, each must have the emphasize markers, like in |
| 3392 | @samp{*three* *bold* *words*}. | 3413 | @samp{*three* *bold* *words*}. |
| 3393 | @item | 3414 | @item |
| 3394 | The exporters work well, but could be made more efficient. | 3415 | The exporters work well, but could be made more efficient. |
| @@ -3452,6 +3473,8 @@ Linking to VM/BBDB/GNUS was inspired by Tom Shannon's | |||
| 3452 | Juergen Vollmer contributed code generating the table of contents | 3473 | Juergen Vollmer contributed code generating the table of contents |
| 3453 | in HTML output, and other export improvements. | 3474 | in HTML output, and other export improvements. |
| 3454 | @item | 3475 | @item |
| 3476 | Chris Wallace provided a patch implementing the @samp{QUOTE} keyword. | ||
| 3477 | @item | ||
| 3455 | David Wainberg suggested the archiving mechanism and shaped the | 3478 | David Wainberg suggested the archiving mechanism and shaped the |
| 3456 | internal link system with many suggestions and ideas. | 3479 | internal link system with many suggestions and ideas. |
| 3457 | @item | 3480 | @item |