Changed type of name argument to m_getfld() from unsigned char *
[mmh] / man / forw.man
index d4edc2f..2efa541 100644 (file)
@@ -1,7 +1,7 @@
+.TH FORW %manext1% "February 28, 2012" "%nmhversion%"
 .\"
 .\" %nmhwarning%
 .\"
 .\"
 .\" %nmhwarning%
 .\"
-.TH FORW %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
 .SH NAME
 forw \- forward messages
 .SH SYNOPSIS
 .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
 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
 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:
 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
 .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'
 fcc    string  Any folders specified with `\-fcc\ folder'
 nmh\-from      string  Addresses specified with `\-from\ address'
 nmh\-to        string  Addresses specified with `\-to\ address'
@@ -120,6 +120,32 @@ nmh\-subject       string  Any text specified with `\-subject\ text'
 .fi
 .RE
 .PP
 .fi
 .RE
 .PP
+By default the \*(lqTo:\*(rq and \*(lqcc:\*(rq fields are empty.  You may
+add addresses to these fields with the
+.B \-to
+.I address
+and
+.B \-cc
+.I address
+switches.  You may give these switches multiple times to add multiple
+addresses.
+.PP
+By default the \*(lqFrom:\*(rq field has either the value of the
+.B Local\-Mailbox
+profile entry a system default email address.  This default can be overridden
+by using the
+.B \-from
+.I address
+switch.  The default mailbox in the \*(lqFcc:\*(rq field is
+.IR +outbox .
+This can be overridden by the
+.B \-fcc
+switch.
+.PP
+Any text you give to the
+.B \-subject
+switch will be placed in the \*(lqSubject:\*(rq field in the draft.
+.PP
 If the draft already exists,
 .B forw
 will ask you as to the disposition
 If the draft already exists,
 .B forw
 will ask you as to the disposition
@@ -160,7 +186,7 @@ change this by using the
 switch.
 .PP
 See
 switch.
 .PP
 See
-.BR comp (1)
+.IR comp (1)
 for a description of the
 .B \-editor
 and
 for a description of the
 .B \-editor
 and
@@ -280,7 +306,7 @@ switches invoke the
 .B nmh
 draft folder facility.  This is an advanced (and highly
 useful) feature.  Consult 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
 man page for more information.
 .PP
 The
@@ -292,7 +318,7 @@ initial edit.  Upon exiting from the editor,
 will invoke the
 .B whatnow
 program.  See
 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
 for a discussion of
 available options.  The invocation of this program can be inhibited
 by using the
@@ -356,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
 .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'
 component      digest  string  Argument to `\-digest'
 function       cur     integer Argument to `\-volume'
 function       msg     integer Argument to `\-issue'
@@ -368,7 +394,6 @@ Consult the
 section of the
 .B nmh
 User's Manual for more information on making digests.
 section of the
 .B nmh
 User's Manual for more information on making digests.
-
 .SH FILES
 .fc ^ ~
 .nf
 .SH FILES
 .fc ^ ~
 .nf
@@ -382,7 +407,6 @@ User's Manual for more information on making digests.
 ^$HOME/\&.mh\(ruprofile~^The user profile
 ^<mh\-dir>/draft~^The draft file
 .fi
 ^$HOME/\&.mh\(ruprofile~^The user profile
 ^<mh\-dir>/draft~^The draft file
 .fi
-
 .SH "PROFILE COMPONENTS"
 .fc ^ ~
 .nf
 .SH "PROFILE COMPONENTS"
 .fc ^ ~
 .nf
@@ -397,12 +421,17 @@ User's Manual for more information on making digests.
 ^mhlproc:~^Program to filter messages being forwarded
 ^whatnowproc:~^Program to ask the \*(lqWhat now?\*(rq questions
 .fi
 ^mhlproc:~^Program to filter messages being forwarded
 ^whatnowproc:~^Program to ask the \*(lqWhat now?\*(rq questions
 .fi
-
 .SH "SEE ALSO"
 .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)
 (RFC\-934)
-
 .SH DEFAULTS
 .nf
 .RB ` +folder "' defaults to the current folder"
 .SH DEFAULTS
 .nf
 .RB ` +folder "' defaults to the current folder"
@@ -414,11 +443,9 @@ mhbuild(1), comp(1), repl(1), send(1), whatnow(1), mh\-format(5),
 .RB ` \-dashstuffing '
 .RB ` \-nomime '
 .fi
 .RB ` \-dashstuffing '
 .RB ` \-nomime '
 .fi
-
 .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.
-
 .SH BUGS
 If
 .I whatnowproc
 .SH BUGS
 If
 .I whatnowproc