Note in dist, mh-profile, and repl man pages that the @ link

[mmh] / man / dist.man

diff --git a/man/dist.man b/man/dist.man
index add2e8e..e217f41 100644 (file)
--- a/man/dist.man
+++ b/man/dist.man
@@ -1,7 +1,7 @@
+.TH DIST %manext1% "June 18, 2012" "%nmhversion%"
 .\"
 .\" %nmhwarning%
 .\"
-.TH DIST %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
 .SH NAME
 dist \- redistribute a message to additional addresses
 .SH SYNOPSIS
@@ -69,12 +69,12 @@ forms file with the switch
 Forms are processed via the
 .B nmh
 template system; see
-.BR mh\-format (5)
+.IR mh\-format (5)
 for details.  Components from the redistributed message are available
 as standard component escapes in the forms file.
 .PP
 In addition to the standard
-.BR mh\-format (5)
+.IR mh\-format (5)
 escapes, the following
 .I component
 escapes are also supported:
@@ -91,7 +91,7 @@ nmh\-cc       string  Addresses specified with `\-cc\ address'
 .RE
 .PP
 See the
-.BR forw (1)
+.IR forw (1)
 man page for descriptions of the
 .BR \-from ,
 .BR \-to ,
@@ -120,7 +120,7 @@ and
 will be sent.  Also, a
 .RI \*(lq "Resent\-Fcc: folder" \*(rq
 will be honored (see
-.BR send (1)).
+.IR send (1)).
 Note that with
 .BR dist ,
 the draft should contain only
@@ -130,7 +130,7 @@ the original message are copied to the draft when the message is sent.
 Use care in constructing the headers for the redistribution.
 .PP
 Because the draft is minimal, the
-.BR prompter (1)
+.IR prompter (1)
 editor is quite useful with
 .BR dist .
 .PP
@@ -138,10 +138,11 @@ If the
 .B \-annotate
 switch is given, the  message being distributed will
 be annotated with the lines:
-
-     Resent:\ date
-     Resent:\ addrs
-
+.RS
+Resent:\ date
+.br
+Resent:\ addrs
+.RE
 where each address list contains as many lines as required.  This
 annotation will be done only if the message is sent directly from
 .BR dist .
@@ -157,12 +158,14 @@ the
 switch to change this.
 .PP
 See
-.BR comp (1)
+.IR comp (1)
 for a description of the
 .B \-editor
 and
 .B \-noedit
-switches.  Note that while in the editor, the message being resent
+switches.  Note that while in the editor, with
+.B \-atfile
+and if the current directory is writable, the message being resent
 is available through a link named \*(lq@\*(rq (assuming the default
 .IR whatnowproc ).
 In addition, the actual pathname of the message is
@@ -171,8 +174,7 @@ stored in the environment variable
 and the pathname of
 the folder containing the message is stored in the environment variable
 .BR $mhfolder .
-The creation of the \*(lq@\*(rq file and associated environment variables
-can be controlled via the
+The creation of the \*(lq@\*(rq file is controlled via the
 .B \-atfile
 and
 .B \-noatfile
@@ -188,7 +190,7 @@ switches invoke the
 .B nmh
 draft folder facility.  This is an advanced (and highly
 useful) feature.  Consult the
-.BR mh-draft (5)
+.IR mh-draft (5)
 man page for more information.
 .PP
 Upon exiting from the editor,
@@ -196,7 +198,7 @@ Upon exiting from the editor,
 will invoke the
 .B whatnow
 program.  See
-.BR whatnow (1)
+.IR whatnow (1)
 for a discussion of available options.  The invocation of this
 program can be inhibited by using the
 .B \-nowhatnowproc
@@ -205,7 +207,6 @@ switch.  (In truth of fact, it is the
 program which starts the initial edit.  Hence,
 .B \-nowhatnowproc
 will prevent any edit from occurring.)
-
 .SH FILES
 .fc ^ ~
 .nf
@@ -215,7 +216,6 @@ will prevent any edit from occurring.)
 ^$HOME/\&.mh\(ruprofile~^The user profile
 ^<mh\-dir>/draft~^The draft file
 .fi
-
 .SH "PROFILE COMPONENTS"
 .fc ^ ~
 .nf
@@ -228,10 +228,13 @@ will prevent any edit from occurring.)
 ^fileproc:~^Program to refile the message
 ^whatnowproc:~^Program to ask the \*(lqWhat now?\*(rq questions
 .fi
-
 .SH "SEE ALSO"
-comp(1), forw(1), prompter(1), repl(1), send(1), whatnow(1)
-
+.IR comp (1),
+.IR forw (1),
+.IR prompter (1),
+.IR repl (1),
+.IR send (1),
+.IR whatnow (1)
 .SH DEFAULTS
 .nf
 .RB ` +folder "' defaults to the current folder"
@@ -241,11 +244,9 @@ comp(1), forw(1), prompter(1), repl(1), send(1), whatnow(1)
 .RB ` \-inplace '
 .RB ` \-noatfile '
 .fi
-
 .SH CONTEXT
 If a folder is given, it will become the current folder.  The message
 distributed will become the current message.
-
 .SH HISTORY
 .B Dist
 originally used headers of the form
@@ -260,7 +261,6 @@ will recognize
 .RI \*(lq Distribute\-xxx: \*(rq
 type headers and automatically convert them to
 .RI \*(lq Resent\-xxx: \*(rq.
-
 .SH BUGS
 .B Dist
 does not rigorously check the message being distributed
@@ -292,6 +292,3 @@ don't call it
 since
 .B comp
 won't run it.
-.PP
-If your current working directory is not writable, the link named
-\*(lq@\*(rq is not available.