X-Git-Url: http://git.marmaro.de/?a=blobdiff_plain;f=man%2Fdist.man;h=e217f418e3854202242129ddea4fbbd2cd025444;hb=492101aee1185135f239b3aabd5b2494f748c931;hp=add2e8e094c7209bb72d71a5fc1f6a7e5566852b;hpb=9c8f0ed7894b42fea0c8b429eba36684b0a405de;p=mmh diff --git a/man/dist.man b/man/dist.man index add2e8e..e217f41 100644 --- a/man/dist.man +++ b/man/dist.man @@ -1,7 +1,7 @@ +.TH DIST %manext1% "June 18, 2012" "%nmhversion%" .\" .\" %nmhwarning% .\" -.TH DIST %manext1% "%nmhdate%" MH.6.8 [%nmhversion%] .SH NAME dist \- redistribute a message to additional addresses .SH SYNOPSIS @@ -69,12 +69,12 @@ forms file with the switch Forms are processed via the .B nmh template system; see -.BR mh\-format (5) +.IR mh\-format (5) for details. Components from the redistributed message are available as standard component escapes in the forms file. .PP In addition to the standard -.BR mh\-format (5) +.IR mh\-format (5) escapes, the following .I component escapes are also supported: @@ -91,7 +91,7 @@ nmh\-cc string Addresses specified with `\-cc\ address' .RE .PP See the -.BR forw (1) +.IR forw (1) man page for descriptions of the .BR \-from , .BR \-to , @@ -120,7 +120,7 @@ and will be sent. Also, a .RI \*(lq "Resent\-Fcc: folder" \*(rq will be honored (see -.BR send (1)). +.IR send (1)). Note that with .BR dist , the draft should contain only @@ -130,7 +130,7 @@ the original message are copied to the draft when the message is sent. Use care in constructing the headers for the redistribution. .PP Because the draft is minimal, the -.BR prompter (1) +.IR prompter (1) editor is quite useful with .BR dist . .PP @@ -138,10 +138,11 @@ If the .B \-annotate switch is given, the message being distributed will be annotated with the lines: - - Resent:\ date - Resent:\ addrs - +.RS +Resent:\ date +.br +Resent:\ addrs +.RE where each address list contains as many lines as required. This annotation will be done only if the message is sent directly from .BR dist . @@ -157,12 +158,14 @@ the switch to change this. .PP See -.BR comp (1) +.IR comp (1) 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 @@ -171,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,7 +190,7 @@ switches invoke the .B nmh draft folder facility. This is an advanced (and highly useful) feature. Consult the -.BR mh-draft (5) +.IR mh-draft (5) man page for more information. .PP Upon exiting from the editor, @@ -196,7 +198,7 @@ Upon exiting from the editor, will invoke the .B whatnow program. See -.BR whatnow (1) +.IR whatnow (1) for a discussion of available options. The invocation of this program can be inhibited by using the .B \-nowhatnowproc @@ -205,7 +207,6 @@ switch. (In truth of fact, it is the program which starts the initial edit. Hence, .B \-nowhatnowproc will prevent any edit from occurring.) - .SH FILES .fc ^ ~ .nf @@ -215,7 +216,6 @@ will prevent any edit from occurring.) ^$HOME/\&.mh\(ruprofile~^The user profile ^/draft~^The draft file .fi - .SH "PROFILE COMPONENTS" .fc ^ ~ .nf @@ -228,10 +228,13 @@ will prevent any edit from occurring.) ^fileproc:~^Program to refile the message ^whatnowproc:~^Program to ask the \*(lqWhat now?\*(rq questions .fi - .SH "SEE ALSO" -comp(1), forw(1), prompter(1), repl(1), send(1), whatnow(1) - +.IR comp (1), +.IR forw (1), +.IR prompter (1), +.IR repl (1), +.IR send (1), +.IR whatnow (1) .SH DEFAULTS .nf .RB ` +folder "' defaults to the current folder" @@ -241,11 +244,9 @@ comp(1), forw(1), prompter(1), repl(1), send(1), whatnow(1) .RB ` \-inplace ' .RB ` \-noatfile ' .fi - .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 originally used headers of the form @@ -260,7 +261,6 @@ will recognize .RI \*(lq Distribute\-xxx: \*(rq type headers and automatically convert them to .RI \*(lq Resent\-xxx: \*(rq. - .SH BUGS .B Dist does not rigorously check the message being distributed @@ -292,6 +292,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.