X-Git-Url: https://diplodocus.org/git/nmh/blobdiff_plain/7efaea5e53d58f4d8c5b5217ecc4974b62a62eea..c3bcb67006e022443a1a424cb8f76c98e809050d:/man/forw.man diff --git a/man/forw.man b/man/forw.man index e6fa01a5..bf172f67 100644 --- a/man/forw.man +++ b/man/forw.man @@ -1,7 +1,7 @@ +.TH FORW %manext1% "March 21, 2013" "%nmhversion%" .\" .\" %nmhwarning% .\" -.TH FORW %manext1% "%nmhdate%" MH.6.8 [%nmhversion%] .SH NAME forw \- forward messages .SH SYNOPSIS @@ -98,12 +98,12 @@ alternate 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 first forwarded 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: @@ -111,7 +111,7 @@ escapes are also supported: .RS 5 .nf .ta \w'nmh\-subject 'u +\w'Returns 'u -.I Escape Returns Description +.I "Escape Returns Description" fcc string Any folders specified with `\-fcc\ folder' nmh\-from string Addresses specified with `\-from\ address' nmh\-to string Addresses specified with `\-to\ address' @@ -137,7 +137,7 @@ by using the .B \-from .I address switch. The default mailbox in the \*(lqFcc:\*(rq field is -.IR \+outbox . +.IR +outbox . This can be overridden by the .B \-fcc switch. @@ -186,7 +186,7 @@ change this by using the switch. .PP See -.BR comp (1) +.IR comp (1) for a description of the .B \-editor and @@ -306,7 +306,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 The @@ -318,7 +318,7 @@ initial edit. 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 @@ -382,7 +382,7 @@ Specifying these switches enables and/or overloads the following escapes: .RS 5 .nf .ta \w'Component 'u +\w'Escape 'u +\w'Returns 'u -.I Type Escape Returns Description +.I "Type Escape Returns Description" component digest string Argument to `\-digest' function cur integer Argument to `\-volume' function msg integer Argument to `\-issue' @@ -394,57 +394,103 @@ Consult the section of the .B nmh User's Manual for more information on making digests. - .SH FILES -.fc ^ ~ -.nf -.ta \w'%etcdir%/ExtraBigFileName 'u -^%etcdir%/forwcomps~^The standard message skeleton -^or /forwcomps~^Rather than the standard skeleton -^%etcdir%/digestcomps~^The message skeleton if `\-digest' is given -^or /digestcomps~^Rather than the standard skeleton -^%etcdir%/mhl.forward~^The standard message filter -^or /mhl.forward~^Rather than the standard filter -^$HOME/\&.mh\(ruprofile~^The user profile -^/draft~^The draft file -.fi - +.B forw +looks for format and filter files in multiple locations: absolute +pathnames are accessed directly, tilde expansion is done on usernames, +and files are searched for in the user's +.I Mail +directory as specified in their profile. If not found there, the directory +.RI \*(lq %etcdir% \*(rq +is checked. +.PP +.PD 0 +.TP 25 +%etcdir%/forwcomps +The standard message skeleton. +.TP +/forwcomps +Rather than the standard skeleton. +.TP +%etcdir%/digestcomps +The message skeleton if +.B \-digest +is given. +.TP +/digestcomps +Rather than the standard skeleton. +.TP +^%etcdir%/mhl.forward +The standard message filter. +.TP +/mhl.forward +Rather than the standard filter. +.TP +^$HOME/.mh\-profile +The user's profile. +.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 -^Msg\-Protect:~^To set mode when creating a new message (draft) -^fileproc:~^Program to refile the message -^mhlproc:~^Program to filter messages being forwarded -^whatnowproc:~^Program to ask the \*(lqWhat now?\*(rq questions -.fi - +.PD 0 +.TP 25 +Path: +To determine the user's nmh directory. +.TP +Current\-Folder: +To find the default current folder. +.TP +Draft\-Folder: +To find the default draft\-folder. +.TP +Editor: +To override the default editor. +.TP +Msg\-Protect: +To set mode when creating a new message (draft). +.TP +fileproc: +Program to refile the message. +.TP +mhlproc: +Program to filter messages being forwarded. +.TP +whatnowproc: +Program to ask the \*(lqWhat now?\*(rq questions. +.PD .SH "SEE ALSO" -mhbuild(1), comp(1), repl(1), send(1), whatnow(1), mh\-format(5), -.I "Proposed Standard for Message Encapsulation" +.IR comp (1), +.IR mhbuild (1), +.IR repl (1), +.IR send (1), +.IR whatnow (1), +.IR mh\-format (5) +.PP +.I +Proposed Standard for Message Encapsulation (RFC\-934) - .SH DEFAULTS -.nf -.RB ` +folder "' defaults to the current folder" -.RB ` msgs "' defaults to cur" -.RB ` \-noannotate ' -.RB ` \-nodraftfolder ' -.RB ` \-noformat ' -.RB ` \-inplace ' -.RB ` \-dashstuffing ' -.RB ` \-nomime ' -.fi - +.PD 0 +.TP 25 ++folder +The current folder. +.TP +msgs +The current message. +.TP +\-noannotate +.TP +\-nodraftfolder +.TP +\-noformat +.TP +\-inplace +.TP +\-dashstuffing +.TP +\-nomime +.PD .SH CONTEXT If a folder is given, it will become the current folder. The first message forwarded will become the current message. - .SH BUGS If .I whatnowproc