X-Git-Url: https://diplodocus.org/git/nmh/blobdiff_plain/95e9c4e6befb17ca3e691c26f024fb55eeae5e31..94187a80bd60baab4b9c4b949ad820d730578123:/man/dist.man?ds=sidebyside

diff --git a/man/dist.man b/man/dist.man
index 1f6e041d..8f4673d9 100644
--- a/man/dist.man
+++ b/man/dist.man
@@ -1,13 +1,15 @@
-.TH DIST %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
-.\"
+.TH DIST %manext1% 2012-12-04 "%nmhversion%"
+.
 .\" %nmhwarning%
-.\"
+.
 .SH NAME
-dist \- redistribute a message to additional addresses
+dist \- distribute an nmh message to additional addresses
 .SH SYNOPSIS
 .HP 5
 .na
 .B dist
+.RB [ \-help ]
+.RB [ \-version ]
 .RI [ +folder ]
 .RI [ msg ]
 .RB [ \-form
@@ -37,11 +39,9 @@ dist \- redistribute a message to additional addresses
 .RB [ \-nowhatnowproc ]
 .RB [ \-atfile ]
 .RB [ \-noatfile ]
-.RB [ \-version ]
-.RB [ \-help ]
 .ad
 .SH DESCRIPTION
-.B Dist
+.B dist
 is similar to
 .BR forw .
 It prepares the specified message
@@ -90,9 +90,9 @@ nmh\-cc	string	Addresses specified with `\-cc\ address'
 .fi
 .RE
 .PP
-See the
+See
 .IR forw (1)
-man page for descriptions of the
+for descriptions of the
 .BR \-from ,
 .BR \-to ,
 .BR \-cc ,
@@ -150,9 +150,9 @@ If the message is not sent immediately from
 .BR dist ,
 .RB \*(lq comp
 .BR \-use \*(rq
-may be used to re\-edit and send the constructed
+may be used to re-edit and send the constructed
 message, but the annotations won't take place.  Normally annotations are
-done inplace in order to preserve any links to the message.  You may use
+done in place in order to preserve any links to the message.  You may use
 the
 .B \-noinplace
 switch to change this.
@@ -163,7 +163,9 @@ 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
@@ -172,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,9 +189,9 @@ and
 switches invoke the
 .B nmh
 draft folder facility.  This is an advanced (and highly
-useful) feature.  Consult the
+useful) feature.  Consult
 .IR mh-draft (5)
-man page for more information.
+for more information.
 .PP
 Upon exiting from the editor,
 .B dist
@@ -201,32 +202,47 @@ program.  See
 for a discussion of available options.  The invocation of this
 program can be inhibited by using the
 .B \-nowhatnowproc
-switch.  (In truth of fact, it is the
+switch.  (In fact, it is the
 .B whatnow
 program which starts the initial edit.  Hence,
 .B \-nowhatnowproc
 will prevent any edit from occurring.)
 .SH FILES
-.fc ^ ~
-.nf
-.ta \w'%etcdir%/ExtraBigFileName  'u
-^%etcdir%/distcomps~^The standard message skeleton
-^or <mh\-dir>/distcomps~^Rather than the standard skeleton
-^$HOME/\&.mh\(ruprofile~^The user profile
-^<mh\-dir>/draft~^The draft file
-.fi
+.PD 0
+.TP 20
+%nmhetcdir%/distcomps
+The default message skeleton.
+.TP 20
+<mh-dir>/distcomps
+The user's message skeleton.
+.TP 20
+$HOME/.mh_profile
+The user's profile.
+.TP 20
+<mh-dir>/draft
+The draft file.
+.PD
 .SH "PROFILE COMPONENTS"
-.fc ^ ~
-.nf
-.ta 2.4i
-.ta \w'ExtraBigProfileName  'u
-^Path:~^To determine the user's nmh directory
-^Current\-Folder:~^To find the default current folder
-^Draft\-Folder:~^To find the default draft\-folder
-^Editor:~^To override the default editor
-^fileproc:~^Program to refile the message
-^whatnowproc:~^Program to ask the \*(lqWhat now?\*(rq questions
-.fi
+.PD 0
+.TP 20
+Path:
+To determine the user's nmh directory.
+.TP 20
+Current\-Folder:
+To find the default current folder.
+.TP 20
+Draft\-Folder:
+To find the default draft-folder.
+.TP 20
+Editor:
+To override the default editor.
+.TP 20
+fileproc:
+Program to refile the message.
+.TP 20
+whatnowproc:
+Program to ask the \*(lqWhat now?\*(rq questions.
+.PD
 .SH "SEE ALSO"
 .IR comp (1),
 .IR forw (1),
@@ -235,33 +251,41 @@ will prevent any edit from occurring.)
 .IR send (1),
 .IR whatnow (1)
 .SH DEFAULTS
-.nf
-.RB ` +folder "' defaults to the current folder"
-.RB ` msg "' defaults to cur"
-.RB ` \-noannotate '
-.RB ` \-nodraftfolder '
-.RB ` \-inplace '
-.RB ` \-noatfile '
-.fi
+.PD 0
+.TP 20
++folder
+The current folder.
+.TP 20
+msg
+The current message.
+.TP 20
+\-noannotate
+.TP 20
+\-nodraftfolder
+.TP 20
+\-inplace
+.TP 20
+\-noatfile
+.PD
 .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
+.B dist
 originally used headers of the form
 .RI \*(lq Distribute\-xxx: \*(rq
 instead of
 .RI \*(lq Resent\-xxx: \*(rq.
-In order to conform with the ARPA Internet standard, RFC\-822, the
+In order to conform with the ARPA Internet standard, RFC 822, the
 .RI \*(lq Resent\-xxx: \*(rq
 form is now used.
-.B Dist
+.B dist
 will recognize
 .RI \*(lq Distribute\-xxx: \*(rq
 type headers and automatically convert them to
 .RI \*(lq Resent\-xxx: \*(rq.
 .SH BUGS
-.B Dist
+.B dist
 does not rigorously check the message being distributed
 for adherence to the transport standard, but
 .B post
@@ -279,7 +303,7 @@ is
 .BR whatnow ,
 then
 .B comp
-uses a built\-in
+uses a built-in
 .BR whatnow ,
 it does not actually run the
 .B whatnow
@@ -291,6 +315,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.