]> diplodocus.org Git - nmh/blobdiff - man/dist.man
fgets() reserves space for the NUL itself.
[nmh] / man / dist.man
index 1f6e041ddf057b5a927aded84ee38ed679b66609..ad6f97a9df0f440040c63a931478a711181f5a82 100644 (file)
@@ -1,4 +1,4 @@
-.TH DIST %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH DIST %manext1% "June 18, 2012" "%nmhversion%"
 .\"
 .\" %nmhwarning%
 .\"
 .\"
 .\" %nmhwarning%
 .\"
@@ -8,6 +8,8 @@ dist \- redistribute a message to additional addresses
 .HP 5
 .na
 .B dist
 .HP 5
 .na
 .B dist
+.RB [ \-help ]
+.RB [ \-version ]
 .RI [ +folder ]
 .RI [ msg ]
 .RB [ \-form
 .RI [ +folder ]
 .RI [ msg ]
 .RB [ \-form
@@ -37,11 +39,9 @@ dist \- redistribute a message to additional addresses
 .RB [ \-nowhatnowproc ]
 .RB [ \-atfile ]
 .RB [ \-noatfile ]
 .RB [ \-nowhatnowproc ]
 .RB [ \-atfile ]
 .RB [ \-noatfile ]
-.RB [ \-version ]
-.RB [ \-help ]
 .ad
 .SH DESCRIPTION
 .ad
 .SH DESCRIPTION
-.B Dist
+.B dist
 is similar to
 .BR forw .
 It prepares the specified message
 is similar to
 .BR forw .
 It prepares the specified message
@@ -163,7 +163,9 @@ for a description of the
 .B \-editor
 and
 .B \-noedit
 .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
 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 .
 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
 .B \-atfile
 and
 .B \-noatfile
@@ -207,26 +208,41 @@ program which starts the initial edit.  Hence,
 .B \-nowhatnowproc
 will prevent any edit from occurring.)
 .SH FILES
 .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 standard message skeleton.
+.TP 20
+<mh\-dir>/distcomps
+An alternative to the standard skeleton.
+.TP 20
+$HOME/\&.mh\(ruprofile
+The user's profile.
+.TP 20
+<mh\-dir>/draft
+The draft file.
+.PD
 .SH "PROFILE COMPONENTS"
 .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),
 .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
 .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
 .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.
 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.
 .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
 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
 does not rigorously check the message being distributed
 for adherence to the transport standard, but
 .B post
@@ -291,6 +315,3 @@ don't call it
 since
 .B comp
 won't run 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.