aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorGlenn Morris2017-04-08 19:24:13 -0700
committerGlenn Morris2017-04-08 19:24:13 -0700
commite9fc0ce7bef1c698639b9008bdb1524f24f29972 (patch)
treeaf9ba362fd47bfc6f98d4ec228dc74360a75d9e5
parent48536f67e009bb8c5e2d5a0ee38f50cd546a84c6 (diff)
downloademacs-e9fc0ce7bef1c698639b9008bdb1524f24f29972.tar.gz
emacs-e9fc0ce7bef1c698639b9008bdb1524f24f29972.zip
* doc/emacs/rmail.texi: Prefer @command to @code for movemail.
-rw-r--r--doc/emacs/rmail.texi36
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
331mail for you in a file that we call your @dfn{inbox}. When you start 331mail for you in a file that we call your @dfn{inbox}. When you start
332up Rmail, it runs a C program called @code{movemail} to copy the new 332up Rmail, it runs a C program called @command{movemail} to copy the new
333messages from your local inbox into your primary Rmail file, which 333messages from your local inbox into your primary Rmail file, which
334also contains other messages saved from previous Rmail sessions. It 334also contains other messages saved from previous Rmail sessions. It
335is in this file that you actually read the mail with Rmail. This 335is 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
397on the server and you can save it later on your workstation. 397on 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
400indirectly. First it runs the @code{movemail} program to move the mail 400indirectly. First it runs the @command{movemail} program to move the mail
401from the inbox to an intermediate file called 401from 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
403file. Then Rmail merges the new mail from that file, saves the Rmail 403file. 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
1373which applies the code when displaying the text. 1373which 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
1380your Rmail file (@pxref{Rmail Inbox}). When loaded for the first time, 1380your Rmail file (@pxref{Rmail Inbox}). When loaded for the first time,
1381Rmail attempts to locate the @code{movemail} program and determine its 1381Rmail attempts to locate the @command{movemail} program and determine its
1382version. There are two versions of the @code{movemail} program: the 1382version. There are two versions of the @command{movemail} program: the
1383GNU Mailutils version (@pxref{movemail,,,mailutils,GNU mailutils}), 1383GNU Mailutils version (@pxref{movemail,,,mailutils,GNU mailutils}),
1384and an Emacs-specific version that is built and installed unless Emacs 1384and an Emacs-specific version that is built and installed unless Emacs
1385was configured using the @option{--with-mailutils} option. 1385was 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
1453Any local mailbox format. Its actual format is detected automatically 1453Any local mailbox format. Its actual format is detected automatically
1454by @code{movemail}. 1454by @command{movemail}.
1455 1455
1456@item pop 1456@item pop
1457A remote mailbox to be accessed via POP3 protocol. @var{user} 1457A 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
1482absolute file name of the @code{movemail} executable. If it is 1482absolute 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
1484listed in @code{rmail-movemail-search-path}, then in @code{exec-path} 1484listed 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
1523supported only by the Mailutils @code{movemail}. To specify an IMAP 1523supported only by the Mailutils @command{movemail}. To specify an IMAP
1524mailbox in the inbox list, use the following mailbox @acronym{URL}: 1524mailbox 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},
1549set the variable @code{rmail-movemail-flags} a list of the flags you 1549set the variable @code{rmail-movemail-flags} a list of the flags you
1550wish to use. Do not use this variable to pass the @samp{-p} flag to 1550wish to use. Do not use this variable to pass the @samp{-p} flag to
1551preserve your inbox contents; use @code{rmail-preserve-inbox} instead. 1551preserve 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
1555Kerberos authentication. If it is supported, it is used by default 1555Kerberos authentication. If it is supported, it is used by default
1556whenever you attempt to retrieve POP mail when 1556whenever 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
1562this, and you would rather read your mail in the order in which it was 1562this, and you would rather read your mail in the order in which it was
1563received, you can tell @code{movemail} to reverse the order of 1563received, you can tell @command{movemail} to reverse the order of
1564downloaded messages by adding the @samp{-r} flag to 1564downloaded 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
1569use it, add the @samp{--tls} flag to @code{rmail-movemail-flags}. 1569use 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
1575than Unix mailbox, you will need the Mailutils @code{movemail} to 1575than Unix mailbox, you will need the Mailutils @command{movemail} to
1576retrieve it. @xref{Movemail}, for the detailed description of 1576retrieve 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
1579include the following in the Rmail inbox list: 1579include the following in the Rmail inbox list:
1580 1580