#726275 mutt(1): Font "p" not found and some formatting improvements for the manual

Package:
mutt
Source:
mutt
Description:
text-based mailreader supporting MIME, GPG, PGP and threading
Submitter:
Bjarni Ingi Gislason
Date:
2013-10-14 02:03:13 UTC
Severity:
minor
#726275#5
Date:
2013-10-14 02:00:34 UTC
From:
To:
Dear Maintainer,

  From "groff -b -ww -mandoc -z"

<groff: mutt.1>:91: backtrace
/home/bg/opt/share/groff/1.21/tmac/an-old.tmac:491: backtrace: macro `IP'
<groff: mutt.1>:91: warning: can't find font `p'

  Input file is /usr/share/man/man1/mutt.1.gz

  Changes (besides the warning):

  Extra space (\, or \/) added between a roman and an italic character
in a string

  Space at end of line removed

  Extra space (\^) around '|' that means 'or'

  Added space between some sentences.  Betters is to start each sentence
in a new line

  Added backslash (\) in front of '-' if it means an option

  A dash meaning a range is \(en

  Added a small space (\^) between two dashes (--, \-\-)

  Patch:
--- mutt.1	2013-10-14 00:19:00.000000000 +0000
+++ mutt.1.new	2013-10-14 00:44:07.000000000 +0000
@@ -24,44 +24,46 @@ mutt \- The Mutt Mail User Agent
 .PP
 .B mutt
 [\-nRyzZ]
-[\-e \fIcmd\fP] [\-F \fIfile\fP] [\-m \fItype\fP] [\-f \fIfile\fP]
+[\-e \fIcmd\/\fP] [\-F \fIfile\/\fP] [\-m \fItype\/\fP] [\-f \fIfile\/\fP]
 .PP
-.B mutt
-[\-nx]
-[\-e \fIcmd\fP]
-[\-F \fIfile\fP]
-[\-H \fIfile\fP]
-[\-i \fIfile\fP]
-[\-s \fIsubj\fP]
-[\-b \fIaddr\fP]
-[\-c \fIaddr\fP]
+.B mutt
+[\-nx]
+[\-e \fIcmd\/\fP]
+[\-F \fIfile\/\fP]
+[\-H \fIfile\/\fP]
+[\-i \fIfile\/\fP]
+[\-s \fIsubj\/\fP]
+[\-b \fIaddr\/\fP]
+[\-c \fIaddr\/\fP]
 [\-a \fIfile\fP [...] \-\-]
-\fIaddr|mailto_url\fP [...]
+.\"\fIaddr|mailto_url\fP [...]
+.IR addr \^|\^ "mailto_url " [...]
 .PP
-.B mutt
-[\-nx]
-[\-e \fIcmd\fP]
-[\-F \fIfile\fP]
-[\-s \fIsubj\fP]
-[\-b \fIaddr\fP]
-[\-c \fIaddr\fP]
+.B mutt
+[\-nx]
+[\-e \fIcmd\/\fP]
+[\-F \fIfile\/\fP]
+[\-s \fIsubj\/\fP]
+[\-b \fIaddr\/\fP]
+[\-c \fIaddr\/\fP]
 [\-a \fIfile\fP [...] \-\-]
-\fIaddr|mailto_url\fP [...]
+.\"\fIaddr|mailto_url\fP [...]
+.IR addr \^|\^ mailto_url " [...]"
 < message
 .PP
 .B mutt
-[\-n] [\-e \fIcmd\fP] [\-F \fIfile\fP] \-p
+[\-n] [\-e \fIcmd\/\fP] [\-F \fIfile\/\fP] \-p
 .PP
 .B mutt
-[\-n] [\-e \fIcmd\fP] [\-F \fIfile\fP] \-A \fIalias\fP
+[\-n] [\-e \fIcmd\/\fP] [\-F \fIfile\/\fP] \-A \fIalias\fP
 .PP
 .B mutt
-[\-n] [\-e \fIcmd\fP] [\-F \fIfile\fP] \-Q \fIquery\fP
+[\-n] [\-e \fIcmd\/\fP] [\-F \fIfile\/\fP] \-Q \fIquery\fP
 .PP
-.B mutt
+.B mutt
 \-v[v]
 .PP
-.B mutt
+.B mutt
 \-D
 .SH DESCRIPTION
 .PP
@@ -72,72 +74,72 @@ OpenPGP, and a threaded sorting mode.
 .I Note:
 .IR
 This manual page gives a brief overview of mutt's command line
-options. You should find a copy of the full manual in /usr/share/doc, in
+options.  You should find a copy of the full manual in /usr/share/doc, in
 text, HTML, and/or PDF format.
 .SH OPTIONS
 .PP
-.IP "-A \fIalias\fP"
+.IP "\-A \fIalias\fP"
 An expanded version of the given alias is passed to stdout.
-.IP "-a \fIfile\fP [...]"
+.IP "\-a \fIfile\fP [...]"
 Attach a file to your message using MIME.
 When attaching single or multiple files, separating filenames and recipient addresses with
-"\-\-" is mandatory, e.g. \fBmutt \-a image.jpg \-\- addr1\fP or
+"\-\-" is mandatory, e.g.\& \fBmutt \-a image.jpg \-\- addr1\fP or
 \fBmutt \-a img.jpg *.png \-\- addr1 addr2\fP.
 The \-a option must be placed at the end of command line options.
-.IP "-b \fIaddress\fP"
+.IP "\-b \fIaddress\fP"
 Specify a blind-carbon-copy (BCC) recipient
-.IP "-c \fIaddress\fP"
+.IP "\-c \fIaddress\fP"
 Specify a carbon-copy (CC) recipient
-.IP "-d \fIlevel\fp"
+.IP "\-d \fIlevel\fP"
 If mutt was complied with +DEBUG log debugging output to ~/.muttdebug0.
-\fILevel\fP can range from 1-5 and effects verbosity. A value of 2 is
+\fILevel\fP can range from 1\(en5 and effects verbosity.  A value of 2 is
 recommended.
-.IP "-D"
+.IP "\-D"
 Print the value of all configuration options to stdout.
-.IP "-e \fIcommand\fP"
+.IP "\-e \fIcommand\fP"
 Specify a configuration command to be run after processing of initialization
 files.
-.IP "-f \fImailbox\fP"
+.IP "\-f \fImailbox\fP"
 Specify which mailbox to load.
-.IP "-F \fImuttrc\fP"
+.IP "\-F \fImuttrc\fP"
 Specify an initialization file to read instead of ~/.muttrc
-.IP "-h"
+.IP "\-h"
 Display help.
-.IP "-H \fIdraft\fP"
+.IP "\-H \fIdraft\fP"
 Specify a draft file which contains header and body to use to send a
 message.
-.IP "-i \fIinclude\fP"
+.IP "\-i \fIinclude\fP"
 Specify a file to include into the body of a message.
-.IP "-m \fItype\fP       "
+.IP "\-m \fItype\fP       "
 specify a default mailbox type for newly created folders.
-.IP "-n"
+.IP "\-n"
 Causes Mutt to bypass the system configuration file.
-.IP "-p"
+.IP "\-p"
 Resume a postponed message.
-.IP "-Q \fIquery\fP"
+.IP "\-Q \fIquery\fP"
 Query a configuration variables value.  The query is executed after
 all configuration files have been parsed, and any commands given on
 the command line have been executed.
-.IP "-R"
+.IP "\-R"
 Open a mailbox in \fIread-only\fP mode.
-.IP "-s \fIsubject\fP"
+.IP "\-s \fIsubject\fP"
 Specify the subject of the message.
-.IP "-v"
+.IP "\-v"
 Display the Mutt version number and compile-time definitions.
-.IP "-vv"
+.IP "\-vv"
 Display license and copyright information.
-.IP "-x"
+.IP "\-x"
 Emulate the mailx compose mode.
-.IP "-y"
+.IP "\-y"
 Start Mutt with a listing of all mailboxes specified by the \fImailboxes\fP
 command.
-.IP "-z"
+.IP "\-z"
 When used with \-f, causes Mutt not to start if there are no messages in the
 mailbox.
-.IP "-Z"
+.IP "\-Z"
 Causes Mutt to open the first mailbox specified by the \fImailboxes\fP
 command which contains new mail.
-.IP "--"
+.IP "\-\^\-"
 Treat remaining arguments as \fIaddr\fP even if they start with a dash.
 See also "\-a" above.
 .SH ENVIRONMENT