make writeQuoted() work correctly with content containing NULs

[nmh] / man / forw.man

diff --git a/man/forw.man b/man/forw.man
index 2efa5413a43e5ac23fbf0540e7c622eb9a0481d4..362fadea35eace266cfd54c3444bdce95fba0cf7 100644 (file)
--- a/man/forw.man
+++ b/man/forw.man
@@ -1,4 +1,4 @@
-.TH FORW %manext1% "February 28, 2012" "%nmhversion%"
+.TH FORW %manext1% "April 18, 2014" "%nmhversion%"

 .\"
 .\" %nmhwarning%
 .\"
 .\"
 .\" %nmhwarning%
 .\"


@@ -250,7 +250,7 @@ By default, any dashes in the first column of the forwarded messages
 will be prepended with `\-\ ' so that when received, the message is
 suitable for bursting by
 .BR burst .
 will be prepended with `\-\ ' so that when received, the message is
 suitable for bursting by
 .BR burst .

-This follows the Internet RFC\-934 guidelines.  You may use the flag
+This follows the Internet RFC 934 guidelines.  You may use the flag

 .B \-nodashstuffing
 in order
 to suppress this form of quoting to the forwarded messages.
 .B \-nodashstuffing
 in order
 to suppress this form of quoting to the forwarded messages.


@@ -275,18 +275,7 @@ composition file. Note that
 .B nmh
 will not invoke
 .B mhbuild
 .B nmh
 will not invoke
 .B mhbuild

-automatically, unless you
-add this line to your
-.I \&.mh\(ruprofile
-file:
-.PP
-.RS 5
-.nf
-automimeproc: 1
-.fi
-.RE
-.PP
-Otherwise, you must specifically give the command
+automatically; you must specifically give the command

 .PP
 .RS 5
 .nf
 .PP
 .RS 5
 .nf


@@ -347,11 +336,7 @@ The
 switch specifies the message to be forwarded as an 
 exact filename rather than as an
 .B nmh
 switch specifies the message to be forwarded as an 
 exact filename rather than as an
 .B nmh

-folder and message number. It is 
-intended to be used by the
-.B msh
-interface to
-.BR nmh . 
+folder and message number.

 This switch implies
 .BR \-noannotate .
 The forwarded message is simply
 This switch implies
 .BR \-noannotate .
 The forwarded message is simply


@@ -395,32 +380,67 @@ section of the
 .B nmh
 User's Manual for more information on making digests.
 .SH FILES
 .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 <mh\-dir>/forwcomps~^Rather than the standard skeleton
-^%etcdir%/digestcomps~^The message skeleton if `\-digest' is given
-^or <mh\-dir>/digestcomps~^Rather than the standard skeleton
-^%etcdir%/mhl.forward~^The standard message filter
-^or <mh\-dir>/mhl.forward~^Rather than the standard filter
-^$HOME/\&.mh\(ruprofile~^The user profile
-^<mh\-dir>/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
+<mh\-dir>/forwcomps
+Rather than the standard skeleton.
+.TP
+%etcdir%/digestcomps
+The message skeleton if
+.B \-digest
+is given.
+.TP
+<mh\-dir>/digestcomps
+Rather than the standard skeleton.
+.TP
+^%etcdir%/mhl.forward
+The standard message filter.
+.TP
+<mh\-dir>/mhl.forward
+Rather than the standard filter.
+.TP
+^$HOME/.mh_profile
+The user's profile.
+.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
-^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"
 .IR comp (1),
 .IR mhbuild (1),
 .SH "SEE ALSO"
 .IR comp (1),
 .IR mhbuild (1),


@@ -431,18 +451,28 @@ User's Manual for more information on making digests.
 .PP
 .I
 Proposed Standard for Message Encapsulation
 .PP
 .I
 Proposed Standard for Message Encapsulation

-(RFC\-934)
+(RFC 934)

 .SH DEFAULTS
 .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 CONTEXT
 If a folder is given, it will become the current folder.
 The first message forwarded will become the current message.