This is automatically generated email about markup problems in a man page for which you appear to be responsible. If you are not the right person or list, please tell me so I can correct my database.
See http://catb.org/~esr/doclifter/bugs.html for details on how and why these patches were generated. Feel free to email me with any questions. Note: These patches do not change the modification date of any manual page. You may wish to do that by hand. I apologize if this message seems spammy or impersonal. The volume of markup bugs I am tracking is over five hundred - there is no real alternative to generating bugmail from a database and template. -- Eric S. Raymond
Problems with mutt.1: Ambiguous or invalid backslash. This doesn't cause groff a problem. but it confuses doclifter and may confuse older troff implementations. Spelling error or typo. --- mutt.1-unpatched 2012-06-29 14:51:10.361755678 -0400 +++ mutt.1 2012-06-29 14:52:01.213754726 -0400 @@ -88,8 +88,8 @@ Specify a blind-carbon-copy (BCC) recipient .IP "-c \fIaddress\fP" Specify a carbon-copy (CC) recipient -.IP "-d \fIlevel\fp" -If mutt was complied with +DEBUG log debugging output to ~/.muttdebug0. +.IP "-d \fIlevel\fP" +If mutt was compiled with +DEBUG log debugging output to ~/.muttdebug0. \fILevel\fP can range from 1-5 and effects verbosity. A value of 2 is recommended. .IP "-D"
Problems with muttrc.5: Ambiguous or invalid backslash. This doesn't cause groff a problem. but it confuses doclifter and may confuse older troff implementations. Unknown or invalid macro. That is, one that does not fit in the macro set that the man page seems to be using. This is a serious error; it often means part of your text is being lost or rendered incorrectly. Use local definitions of .EX/.EE or .DS/.DE to avoid low-level troff requests in the page body. There are plans to add these to groff man; in the interim, this patch adds a compatible definition to your page. --- muttrc.5-unpatched 2012-07-23 02:24:15.784081601 -0400 +++ muttrc.5 2012-07-23 02:24:24.828081291 -0400 @@ -18,6 +18,14 @@ .\" along with this program; if not, write to the Free Software .\" Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. .\" +.de EX +.nf +.ft CW +.. +.de EE +.ft +.fi +.. .TH muttrc 5 "September 2002" Unix "User Manuals" .SH NAME muttrc \- Configuration file for the Mutt Mail User Agent @@ -270,7 +278,7 @@ list from the lists of known and subscribed mailing lists. The \fBsubscribe\fP command adds a mailing list to the lists of known and subscribed mailing lists. The \fBunsubscribe\fP command removes -it from the list of subscribed mailing lists. The \fb-group\fP flag +it from the list of subscribed mailing lists. The \fB-group\fP flag adds all of the subsequent regular expressions to the named group. .TP \fBmbox-hook\fP [\fB!\fP]\fIpattern\fP \fImailbox\fP @@ -404,8 +412,8 @@ \fBsource\fP \fIfilename\fP The given file will be evaluated as a configuration file. .TP -.nf \fBspam\fP \fIpattern\fP \fIformat\fP +.TP \fBnospam\fP \fIpattern\fP .fi These commands define spam-detection patterns from external spam @@ -780,15 +788,12 @@ message could include a line like .IP -.DS .sp -.ft CR -.nf +.EX [\-\- PGP output follows ... .fi -.ec -.ft P +.ft .sp .IP and give it the same color as your attachment color (see also @@ -859,15 +864,12 @@ For example, Japanese users might prefer this: .IP -.DS .sp -.ft CR -.nf +.EX set assumed_charset=\(rqiso\-2022\-jp:euc\-jp:shift_jis:utf\-8\(rq .fi -.ec -.ft P +.ft .sp .IP However, only the first content is valid for the message body. @@ -890,15 +892,12 @@ text handling: .IP -.DS .sp -.ft CR -.nf +.EX set attach_charset=\(rqiso\-2022\-jp:euc\-jp:shift_jis:utf\-8\(rq .fi -.ec -.ft P +.ft .sp .IP Note: for Japanese users, \(lqiso\-2022\-*\(rq must be put at the head @@ -1133,15 +1132,10 @@ Example: .IP -.DS .sp -.ft CR -.nf +.EX set certificate_file=~/.mutt/certificates - -.fi -.ec -.ft P +.EE .sp @@ -1588,15 +1582,10 @@ Example: .IP -.DS .sp -.ft CR -.nf +.EX set dsn_notify=\(rqfailure,delay\(rq - -.fi -.ec -.ft P +.EE .sp .IP \fBNote:\fP when using $sendmail for delivery, you should not enable @@ -1620,15 +1609,10 @@ Example: .IP -.DS .sp -.ft CR -.nf +.EX set dsn_return=hdrs - -.fi -.ec -.ft P +.EE .sp .IP \fBNote:\fP when using $sendmail for delivery, you should not enable @@ -2232,15 +2216,10 @@ Example: .IP -.DS .sp -.ft CR -.nf +.EX set imap_authenticators=\(rqgssapi:cram\-md5:login\(rq - -.fi -.ec -.ft P +.EE .sp .IP \fBNote:\fP Mutt will only fall back to other authentication methods if @@ -3457,15 +3436,10 @@ output format must be analogous to the one used by .IP -.DS .sp -.ft CR -.nf +.EX gpg \-\-list\-keys \-\-with\-colons. - -.fi -.ec -.ft P +.EE .sp .IP This format is also generated by the \fCpgpring\fP utility which comes @@ -3487,15 +3461,10 @@ output format must be analogous to the one used by: .IP -.DS .sp -.ft CR -.nf +.EX gpg \-\-list\-keys \-\-with\-colons. - -.fi -.ec -.ft P +.EE .sp .IP This format is also generated by the \fCpgpring\fP utility which comes @@ -3784,15 +3753,10 @@ Example: .IP -.DS .sp -.ft CR -.nf +.EX set pop_authenticators=\(rqdigest\-md5:apop:user\(rq - -.fi -.ec -.ft P +.EE .sp @@ -3830,15 +3794,10 @@ can also specify an alternative port, username and password, i.e.: .IP -.DS .sp -.ft CR -.nf +.EX [pop[s]://][username[:password]@]popserver[:port] - -.fi -.ec -.ft P +.EE .sp .IP where \(lq[...]\(rq denotes an optional part. @@ -3945,16 +3904,11 @@ status, mutt gives up opening the server. Example: .IP -.DS .sp -.ft CR -.nf +.EX set preconnect=\(rqssh \-f \-q \-L 1234:mailhost.net:143 mailhost.net \\ sleep 20 < /dev/null > /dev/null\(rq - -.fi -.ec -.ft P +.EE .sp .IP Mailbox \(lqfoo\(rq on \(lqmailhost.net\(rq can now be reached @@ -4269,29 +4223,19 @@ alias: .IP -.DS .sp -.ft CR -.nf +.EX alias juser [email protected] (Joe User) - -.fi -.ec -.ft P +.EE .sp .IP and then you receive mail which contains the following header: .IP -.DS .sp -.ft CR -.nf +.EX From: [email protected] - -.fi -.ec -.ft P +.EE .sp .IP It would be displayed in the index menu as \(lqJoe User\(rq instead of @@ -4343,15 +4287,10 @@ to save attachments to files named like: .IP -.DS .sp -.ft CR -.nf +.EX =?iso\-8859\-1?Q?file=5F=E4=5F991116=2Ezip?= - -.fi -.ec -.ft P +.EE .sp .IP When this variable is \fIset\fP interactively, the change won't be @@ -5011,15 +4950,10 @@ Example: .IP -.DS .sp -.ft CR -.nf +.EX set smtp_authenticators=\(rqdigest\-md5:cram\-md5\(rq - -.fi -.ec -.ft P +.EE .sp .IP \fBNote:\fP On Debian systems, this variable defaults to the example @@ -5053,15 +4987,10 @@ delivery. This should take the form of an SMTP URL, e.g.: .IP -.DS .sp -.ft CR -.nf +.EX smtp[s]://[user[:pass]@]host[:port] - -.fi -.ec -.ft P +.EE .sp .IP where \(lq[...]\(rq denotes an optional part. @@ -5147,15 +5076,10 @@ the rest of $sort_aux as an ordering. For instance, .IP -.DS .sp -.ft CR -.nf +.EX set sort_aux=last\-date\-received - -.fi -.ec -.ft P +.EE .sp .IP would mean that if a new message is received in a @@ -5251,15 +5175,10 @@ Example: .IP -.DS .sp -.ft CR -.nf +.EX set ssl_ca_certificates_file=/etc/ssl/certs/ca\-certificates.crt - -.fi -.ec -.ft P +.EE .sp @@ -5698,15 +5617,10 @@ preauthenticated connections to your IMAP/POP3/SMTP server. Example: .IP -.DS .sp -.ft CR -.nf +.EX set tunnel=\(rqssh \-q mailhost.net /usr/local/libexec/imapd\(rq - -.fi -.ec -.ft P +.EE .sp .IP Note: For this example to work you must be able to log in to the remote
