mhlsbr.c: Don't strchr(3) non-string NUL-less buffer.

[nmh] / man / dist.man

diff --git a/man/dist.man b/man/dist.man
index 1f6e041ddf057b5a927aded84ee38ed679b66609..8f4673d9d619fd6dc16f6e1ffb2fa326264a6752 100644 (file)
--- 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%
 .\" %nmhwarning%

-.\"
+.

 .SH NAME
 .SH NAME

-dist \- redistribute a message to additional addresses
+dist \- distribute an nmh message to additional addresses

 .SH SYNOPSIS
 .HP 5
 .na
 .B dist
 .SH SYNOPSIS
 .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


@@ -90,9 +90,9 @@ nmh\-cc       string  Addresses specified with `\-cc\ address'
 .fi
 .RE
 .PP
 .fi
 .RE
 .PP

-See the
+See

 .IR forw (1)
 .IR forw (1)

-man page for descriptions of the
+for descriptions of the

 .BR \-from ,
 .BR \-to ,
 .BR \-cc ,
 .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
 .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
 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.
 the
 .B \-noinplace
 switch to change this.


@@ -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


@@ -188,9 +189,9 @@ and
 switches invoke the
 .B nmh
 draft folder facility.  This is an advanced (and highly
 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)
 .IR mh-draft (5)

-man page for more information.
+for more information.

 .PP
 Upon exiting from the editor,
 .B dist
 .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
 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
 .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"
 .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


@@ -279,7 +303,7 @@ is
 .BR whatnow ,
 then
 .B comp
 .BR whatnow ,
 then
 .B comp

-uses a built\-in
+uses a built-in

 .BR whatnow ,
 it does not actually run the
 .B whatnow
 .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.
 since
 .B comp
 won't run it.

-.PP
-If your current working directory is not writable, the link named
-\*(lq@\*(rq is not available.