diff options
| author | Glenn Morris | 2017-04-08 19:24:13 -0700 |
|---|---|---|
| committer | Glenn Morris | 2017-04-08 19:24:13 -0700 |
| commit | e9fc0ce7bef1c698639b9008bdb1524f24f29972 (patch) | |
| tree | af9ba362fd47bfc6f98d4ec228dc74360a75d9e5 | |
| parent | 48536f67e009bb8c5e2d5a0ee38f50cd546a84c6 (diff) | |
| download | emacs-e9fc0ce7bef1c698639b9008bdb1524f24f29972.tar.gz emacs-e9fc0ce7bef1c698639b9008bdb1524f24f29972.zip | |
* doc/emacs/rmail.texi: Prefer @command to @code for movemail.
| -rw-r--r-- | doc/emacs/rmail.texi | 36 |
1 files changed, 18 insertions, 18 deletions
diff --git a/doc/emacs/rmail.texi b/doc/emacs/rmail.texi index 15ed3c7fedc..59955ca7c2d 100644 --- a/doc/emacs/rmail.texi +++ b/doc/emacs/rmail.texi | |||
| @@ -329,7 +329,7 @@ adding or removing this attribute. @xref{Rmail Attributes}. | |||
| 329 | 329 | ||
| 330 | When you receive mail locally, the operating system places incoming | 330 | When you receive mail locally, the operating system places incoming |
| 331 | mail for you in a file that we call your @dfn{inbox}. When you start | 331 | mail for you in a file that we call your @dfn{inbox}. When you start |
| 332 | up Rmail, it runs a C program called @code{movemail} to copy the new | 332 | up Rmail, it runs a C program called @command{movemail} to copy the new |
| 333 | messages from your local inbox into your primary Rmail file, which | 333 | messages from your local inbox into your primary Rmail file, which |
| 334 | also contains other messages saved from previous Rmail sessions. It | 334 | also contains other messages saved from previous Rmail sessions. It |
| 335 | is in this file that you actually read the mail with Rmail. This | 335 | is in this file that you actually read the mail with Rmail. This |
| @@ -397,7 +397,7 @@ check your mail via POP while traveling, so that your mail will remain | |||
| 397 | on the server and you can save it later on your workstation. | 397 | on the server and you can save it later on your workstation. |
| 398 | 398 | ||
| 399 | In some cases, Rmail copies the new mail from the inbox file | 399 | In some cases, Rmail copies the new mail from the inbox file |
| 400 | indirectly. First it runs the @code{movemail} program to move the mail | 400 | indirectly. First it runs the @command{movemail} program to move the mail |
| 401 | from the inbox to an intermediate file called | 401 | from the inbox to an intermediate file called |
| 402 | @file{.newmail-@var{inboxname}}, in the same directory as the Rmail | 402 | @file{.newmail-@var{inboxname}}, in the same directory as the Rmail |
| 403 | file. Then Rmail merges the new mail from that file, saves the Rmail | 403 | file. Then Rmail merges the new mail from that file, saves the Rmail |
| @@ -1373,13 +1373,13 @@ rot13-other-window}. This displays the current buffer in another window | |||
| 1373 | which applies the code when displaying the text. | 1373 | which applies the code when displaying the text. |
| 1374 | 1374 | ||
| 1375 | @node Movemail | 1375 | @node Movemail |
| 1376 | @section @code{movemail} program | 1376 | @section @command{movemail} program |
| 1377 | @cindex @code{movemail} program | 1377 | @cindex @command{movemail} program |
| 1378 | 1378 | ||
| 1379 | Rmail uses the @code{movemail} program to move mail from your inbox to | 1379 | Rmail uses the @command{movemail} program to move mail from your inbox to |
| 1380 | your Rmail file (@pxref{Rmail Inbox}). When loaded for the first time, | 1380 | your Rmail file (@pxref{Rmail Inbox}). When loaded for the first time, |
| 1381 | Rmail attempts to locate the @code{movemail} program and determine its | 1381 | Rmail attempts to locate the @command{movemail} program and determine its |
| 1382 | version. There are two versions of the @code{movemail} program: the | 1382 | version. There are two versions of the @command{movemail} program: the |
| 1383 | GNU Mailutils version (@pxref{movemail,,,mailutils,GNU mailutils}), | 1383 | GNU Mailutils version (@pxref{movemail,,,mailutils,GNU mailutils}), |
| 1384 | and an Emacs-specific version that is built and installed unless Emacs | 1384 | and an Emacs-specific version that is built and installed unless Emacs |
| 1385 | was configured using the @option{--with-mailutils} option. | 1385 | was configured using the @option{--with-mailutils} option. |
| @@ -1451,7 +1451,7 @@ denotes the name of @code{maildir} mailbox, e.g., | |||
| 1451 | 1451 | ||
| 1452 | @item file | 1452 | @item file |
| 1453 | Any local mailbox format. Its actual format is detected automatically | 1453 | Any local mailbox format. Its actual format is detected automatically |
| 1454 | by @code{movemail}. | 1454 | by @command{movemail}. |
| 1455 | 1455 | ||
| 1456 | @item pop | 1456 | @item pop |
| 1457 | A remote mailbox to be accessed via POP3 protocol. @var{user} | 1457 | A remote mailbox to be accessed via POP3 protocol. @var{user} |
| @@ -1478,9 +1478,9 @@ This is equivalent to specifying the @samp{file} protocol: | |||
| 1478 | @vindex rmail-movemail-program | 1478 | @vindex rmail-movemail-program |
| 1479 | @vindex rmail-movemail-search-path | 1479 | @vindex rmail-movemail-search-path |
| 1480 | The variable @code{rmail-movemail-program} controls which version of | 1480 | The variable @code{rmail-movemail-program} controls which version of |
| 1481 | @code{movemail} to use. If that is a string, it specifies the | 1481 | @command{movemail} to use. If that is a string, it specifies the |
| 1482 | absolute file name of the @code{movemail} executable. If it is | 1482 | absolute file name of the @command{movemail} executable. If it is |
| 1483 | @code{nil}, Rmail searches for @code{movemail} in the directories | 1483 | @code{nil}, Rmail searches for @command{movemail} in the directories |
| 1484 | listed in @code{rmail-movemail-search-path}, then in @code{exec-path} | 1484 | listed in @code{rmail-movemail-search-path}, then in @code{exec-path} |
| 1485 | (@pxref{Shell}), then in @code{exec-directory}. | 1485 | (@pxref{Shell}), then in @code{exec-directory}. |
| 1486 | 1486 | ||
| @@ -1520,7 +1520,7 @@ the machine on which to look for the POP server. | |||
| 1520 | 1520 | ||
| 1521 | @cindex IMAP mailboxes | 1521 | @cindex IMAP mailboxes |
| 1522 | Another method for accessing remote mailboxes is IMAP@. This method is | 1522 | Another method for accessing remote mailboxes is IMAP@. This method is |
| 1523 | supported only by the Mailutils @code{movemail}. To specify an IMAP | 1523 | supported only by the Mailutils @command{movemail}. To specify an IMAP |
| 1524 | mailbox in the inbox list, use the following mailbox @acronym{URL}: | 1524 | mailbox in the inbox list, use the following mailbox @acronym{URL}: |
| 1525 | @samp{imap://@var{username}[:@var{password}]@@@var{hostname}:@var{port}}. The | 1525 | @samp{imap://@var{username}[:@var{password}]@@@var{hostname}:@var{port}}. The |
| 1526 | @var{password} part is optional, as described above. | 1526 | @var{password} part is optional, as described above. |
| @@ -1545,13 +1545,13 @@ Otherwise, Rmail will ask you for the password to use. | |||
| 1545 | @end enumerate | 1545 | @end enumerate |
| 1546 | 1546 | ||
| 1547 | @vindex rmail-movemail-flags | 1547 | @vindex rmail-movemail-flags |
| 1548 | If you need to pass additional command-line flags to @code{movemail}, | 1548 | If you need to pass additional command-line flags to @command{movemail}, |
| 1549 | set the variable @code{rmail-movemail-flags} a list of the flags you | 1549 | set the variable @code{rmail-movemail-flags} a list of the flags you |
| 1550 | wish to use. Do not use this variable to pass the @samp{-p} flag to | 1550 | wish to use. Do not use this variable to pass the @samp{-p} flag to |
| 1551 | preserve your inbox contents; use @code{rmail-preserve-inbox} instead. | 1551 | preserve your inbox contents; use @code{rmail-preserve-inbox} instead. |
| 1552 | 1552 | ||
| 1553 | @cindex Kerberos POP authentication | 1553 | @cindex Kerberos POP authentication |
| 1554 | The @code{movemail} program installed at your site may support | 1554 | The @command{movemail} program installed at your site may support |
| 1555 | Kerberos authentication. If it is supported, it is used by default | 1555 | Kerberos authentication. If it is supported, it is used by default |
| 1556 | whenever you attempt to retrieve POP mail when | 1556 | whenever you attempt to retrieve POP mail when |
| 1557 | @code{rmail-remote-password} and @code{rmail-remote-password-required} | 1557 | @code{rmail-remote-password} and @code{rmail-remote-password-required} |
| @@ -1560,21 +1560,21 @@ are unset. | |||
| 1560 | @cindex reverse order in POP inboxes | 1560 | @cindex reverse order in POP inboxes |
| 1561 | Some POP servers store messages in reverse order. If your server does | 1561 | Some POP servers store messages in reverse order. If your server does |
| 1562 | this, and you would rather read your mail in the order in which it was | 1562 | this, and you would rather read your mail in the order in which it was |
| 1563 | received, you can tell @code{movemail} to reverse the order of | 1563 | received, you can tell @command{movemail} to reverse the order of |
| 1564 | downloaded messages by adding the @samp{-r} flag to | 1564 | downloaded messages by adding the @samp{-r} flag to |
| 1565 | @code{rmail-movemail-flags}. | 1565 | @code{rmail-movemail-flags}. |
| 1566 | 1566 | ||
| 1567 | @cindex TLS encryption (Rmail) | 1567 | @cindex TLS encryption (Rmail) |
| 1568 | Mailutils @code{movemail} supports TLS encryption. If you wish to | 1568 | Mailutils @command{movemail} supports TLS encryption. If you wish to |
| 1569 | use it, add the @samp{--tls} flag to @code{rmail-movemail-flags}. | 1569 | use it, add the @samp{--tls} flag to @code{rmail-movemail-flags}. |
| 1570 | 1570 | ||
| 1571 | @node Other Mailbox Formats | 1571 | @node Other Mailbox Formats |
| 1572 | @section Retrieving Mail from Local Mailboxes in Various Formats | 1572 | @section Retrieving Mail from Local Mailboxes in Various Formats |
| 1573 | 1573 | ||
| 1574 | If your incoming mail is stored on a local machine in a format other | 1574 | If your incoming mail is stored on a local machine in a format other |
| 1575 | than Unix mailbox, you will need the Mailutils @code{movemail} to | 1575 | than Unix mailbox, you will need the Mailutils @command{movemail} to |
| 1576 | retrieve it. @xref{Movemail}, for the detailed description of | 1576 | retrieve it. @xref{Movemail}, for the detailed description of |
| 1577 | @code{movemail} versions. For example, to access mail from a inbox in | 1577 | @command{movemail} versions. For example, to access mail from a inbox in |
| 1578 | @code{maildir} format located in @file{/var/spool/mail/in}, you would | 1578 | @code{maildir} format located in @file{/var/spool/mail/in}, you would |
| 1579 | include the following in the Rmail inbox list: | 1579 | include the following in the Rmail inbox list: |
| 1580 | 1580 | ||