X-Git-Url: https://diplodocus.org/git/nmh/blobdiff_plain/95e9c4e6befb17ca3e691c26f024fb55eeae5e31..b0aa8cdb1c264e42d4931ca24968689c73381278:/man/dist.man?ds=sidebyside diff --git a/man/dist.man b/man/dist.man index 1f6e041d..ad6f97a9 100644 --- a/man/dist.man +++ b/man/dist.man @@ -1,4 +1,4 @@ -.TH DIST %manext1% "%nmhdate%" MH.6.8 [%nmhversion%] +.TH DIST %manext1% "June 18, 2012" "%nmhversion%" .\" .\" %nmhwarning% .\" @@ -8,6 +8,8 @@ dist \- redistribute a message to additional addresses .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 @@ -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 @@ -207,26 +208,41 @@ 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 /distcomps~^Rather than the standard skeleton -^$HOME/\&.mh\(ruprofile~^The user profile -^/draft~^The draft file -.fi +.PD 0 +.TP 20 +%nmhetcdir%/distcomps +The standard message skeleton. +.TP 20 +/distcomps +An alternative to the standard skeleton. +.TP 20 +$HOME/\&.mh\(ruprofile +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), @@ -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 @@ -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.