X-Git-Url: https://diplodocus.org/git/nmh/blobdiff_plain/46f35e659f3bc3e808a70263bea0ec72624c8a08..c576ad2674c37a1c63f004c71049998f38854c64:/man/dist.man diff --git a/man/dist.man b/man/dist.man index d8beb2b5..8f4673d9 100644 --- a/man/dist.man +++ b/man/dist.man @@ -1,13 +1,15 @@ -.TH DIST %manext1% "June 18, 2012" "%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. @@ -189,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 @@ -202,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'%nmhetcdir%/ExtraBigFileName 'u -^%nmhetcdir%/distcomps~^The standard message skeleton -^or /distcomps~^Rather than the standard skeleton -^$HOME/\&.mh\(ruprofile~^The user profile -^/draft~^The draft file -.fi +.PD 0 +.TP 20 +%nmhetcdir%/distcomps +The default message skeleton. +.TP 20 +/distcomps +The user's message skeleton. +.TP 20 +$HOME/.mh_profile +The user's profile. +.TP 20 +/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), @@ -236,19 +251,27 @@ 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 @@ -256,13 +279,13 @@ instead of 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 @@ -280,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