echo ' s,%mhl_forward%,,g' >> $@
echo '/%mhl_format%/r $(top_srcdir)/etc/mhl.format' >> $@
echo ' s,%mhl_format%,,g' >> $@
+ echo '/%mhl_reply%/r $(top_srcdir)/etc/mhl.reply' >> $@
+ echo ' s,%mhl_reply%,,g' >> $@
# ========= INSTALL TARGETS =========
.\" %nmhwarning%
.\" $Id$
.\"
-.\" include the -mh macro file
-.so %etcdir%/tmac.h
-.\"
.TH PROMPTER %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
.SH NAME
prompter \- prompting editor front-end for nmh
.SH SYNOPSIS
-.in +.5i
-.ti -.5i
-prompter
-\%[\-erase\ chr]
-\%[\-kill\ chr]
-\%[\-prepend] \%[\-noprepend]
-\%[\-rapid] \%[\-norapid]
-\%[\-doteof] \%[\-nodoteof]
-file
-\%[\-version]
-\%[\-help]
-.in -.5i
+.HP 5
+.B prompter
+.RB [ \-erase
+.IR chr ]
+.RB [ \-kill
+.IR chr ]
+.RB [ \-prepend " | " \-noprepend ]
+.RB [ \-rapid " | " \-norapid ]
+.RB [ \-doteof " | " \-nodoteof ]
+.I file
+.RB [ \-version ]
+.RB [ \-help ]
.SH DESCRIPTION
-\fIPrompter\fR is an editor front\-end for \fInmh\fR which allows rapid
+.B Prompter
+is an editor front\-end for
+.B nmh
+which allows rapid
composition of messages. This program is not normally invoked directly by
users but takes the place of an editor and acts as an editor front\-end.
It operates on an RFC\-822 style message draft skeleton specified by
-file, normally provided by the nmh commands \fIcomp\fR, \fIdist\fR,
-\fIforw\fR, or \fIrepl\fR.
-
-\fIPrompter\fR is particularly useful when composing messages over slow
-network or modem lines. It is an \fInmh\fR program in that it can have
+.IR file ,
+normally provided by the
+.B nmh
+commands
+.BR comp ,
+.BR dist ,
+.BR forw ,
+or
+.BR repl .
+.PP
+.B Prompter
+is particularly useful when composing messages over slow
+network or modem lines. It is an
+.B nmh program in that it can have
its own profile entry with switches, but it is not invoked directly by
-the user. The commands \fIcomp\fR, \fIdist\fR, \fIforw\fR, and \fIrepl\fR
-invoke \fIprompter\fR as an editor, either when invoked with
-`\-editor\ prompter', or by the profile entry \*(lqEditor:\ prompter\*(rq,
-or when given the command `edit\ prompter' at the \*(lqWhat now?\*(rq prompt.
-
-For each empty component \fIprompter\fR finds in the draft, the user
+the user. The commands
+.BR comp ,
+.BR dist ,
+.BR forw ,
+and
+.B repl
+invoke
+.B prompter as an editor, either when invoked with
+.B \-editor
+.IR prompter ,
+or by the profile entry \*(lqEditor:\ prompter\*(rq,
+or when given the command
+.B edit
+.B prompter
+at the \*(lqWhat now?\*(rq prompt.
+.PP
+For each empty component
+.B prompter finds in the draft, the user
is prompted for a response; A <RETURN> will cause the whole component
to be left out. Otherwise, a `\\' preceding a <RETURN> will continue
the response on the next line, allowing for multiline components.
-Continuation lines \fBmust\fR begin with a space or tab.
-
+Continuation lines
+.B must
+begin with a space or tab.
+.PP
Each non\-empty component is copied to the draft and displayed on the
terminal.
-
+.PP
The start of the message body is denoted by a blank line or a line
of dashes. If the body is non\-empty, the prompt, which isn't written
to the file, is
-
- \*(lq--------Enter additional text\*(rq,
-
-or (if `\-prepend' was given)
-
- \*(lq--------Enter initial text\*(rq.
-
+.PP
+.RS 5
+--------Enter additional text
+.RE
+.PP
+or (if
+.B \-prepend
+was given)
+.PP
+.RS 5
+--------Enter initial text
+.RE
+.PP
Message\-body typing is terminated with an end\-of\-file (usually
-CTRL\-D). With the `\-doteof' switch, a period on a line all by itself
+CTRL\-D). With the
+.B \-doteof
+switch, a period on a line all by itself
also signifies end\-of\-file. At this point control is returned to
the calling program, where the user is asked \*(lqWhat now?\*(rq.
-See \fIwhatnow\fR for the valid options to this query.
-
-By using the `\-prepend' switch, the user can add type\-in to the
+See
+.B whatnow (1)
+for the valid options to this query.
+.PP
+By using the
+.B \-prepend
+switch, the user can add type\-in to the
beginning of the message body and have the rest of the body follow.
-This is useful for the \fIforw\fR command.
-
-By using the `\-rapid' switch, if the draft already contains text in
+This is useful for the
+.B forw
+command.
+.PP
+By using the
+.B \-rapid
+switch, if the draft already contains text in
the message\-body, it is not displayed on the user's terminal. This is
useful for low\-speed terminals.
-
+.PP
The line editing characters for kill and erase may be specified by the
-user via the arguments `\-kill\ chr' and `\-erase\ chr', where chr may
-be a character; or `\\nnn', where \*(lqnnn\*(rq is the octal value for
+user via the arguments
+.B \-kill
+.I chr
+and
+.B \-erase
+.IR chr ,
+where
+.I chr
+may be a character; or `\\nnn', where \*(lqnnn\*(rq is the octal value for
the character.
-
+.PP
An interrupt (usually CTRL\-C) during component typing will abort
-\fIprompter\fR and the \fInmh\fR command that invoked it. An interrupt
+.B prompter
+and the
+.B nmh
+command that invoked it. An interrupt
during message\-body typing is equivalent to CTRL\-D, for historical
-reasons. This means that \fIprompter\fR should finish up and exit.
-
-The first non\-flag argument to \fIprompter\fR is taken as the name of
+reasons. This means that
+.B prompter
+should finish up and exit.
+.PP
+The first non\-flag argument to
+.B prompter is taken as the name of
the draft file, and subsequent non\-flag arguments are ignored.
.\" (\fIRepl\fR invokes editors with two file arguments:
.\" the draft file name and the replied\-to message file name.)
-.Fi
+
+.SH FILES
+.fc ^ ~
+.nf
+.ta \w'/usr/local/nmh/etc/ExtraBigFileName 'u
^$HOME/\&.mh\(ruprofile~^The user profile
^/tmp/prompter*~^Temporary copy of message
-.Pr
-prompter\-next: To name the editor to be used on exit from \fIprompter\fR
-.Ps
+.fi
+
+.SH "PROFILE COMPONENTS"
+.fc ^ ~
+.nf
+.ta 2.4i
+.ta \w'ExtraBigProfileName 'u
+prompter\-next: To name the editor to be used on exit from .B prompter
^Msg\-Protect:~^To set mode when creating a new draft
-.Sa
+.fi
+
+.SH "SEE ALSO"
comp(1), dist(1), forw(1), repl(1), whatnow(1)
-.De
-`\-prepend'
-.Ds
-`\-norapid'
-.Ds
-`\-nodoteof'
-.Co
+
+.SH DEFAULTS
+.nf
+.RB ` \-prepend '
+.RB ` \-norapid '
+.RB ` \-nodoteof '
+.fi
+
+.SH CONTEXT
None
-.Hh
-The `\-rapid' option is particularly useful with \fIforw\fP, and
-`\-noprepend' is useful with \fIcomp\ \-use\fP.
-The user may wish to link \fIprompter\fR under several names (e.g.,
+.SH "HELPFUL HINTS"
+The
+.B \-rapid
+option is particularly useful with
+.BR forw ,
+and
+.B \-noprepend
+is useful with
+.B comp
+.BR \-use .
+.PP
+The user may wish to link
+.B prompter under several names (e.g.,
\*(lqrapid\*(rq) and give appropriate switches in the profile entries
under these names (e.g., \*(lqrapid: -rapid\*(rq). This facilitates
-invoking prompter differently for different \fInmh\fP commands (e.g.,
+invoking prompter differently for different
+.B nmh
+commands (e.g.,
\*(lqforw: -editor rapid\*(rq).
-.Bu
-\fIPrompter\fR uses \fIstdio\fR\0(3), so it will lose if you edit files
-with nulls in them.
-.En
+
+.SH BUGS
+.B Prompter
+uses
+.BR stdio (3),
+so it will lose if you edit files with nulls in them.
.\" %nmhwarning%
.\" $Id$
.\"
-.\" include the -mh macro file
-.so %etcdir%/tmac.h
-.\"
.TH RCVDIST %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
.SH NAME
rcvdist \- asynchronously redistribute new mail
.SH SYNOPSIS
-.in +.5i
-.ti -.5i
-%libdir%/rcvdist
-\%[\-form\ formfile]
-.br
-\%[switches\ for\ \fIpostproc\fR]
-address1\ ...
-.br
-\%[\-version]
-\%[\-help]
-.in -.5i
+.HP 5
+.B %libdir%/rcvdist
+.RB [ \-form
+.IR formfile ]
+[switches\ for
+.IR postproc ]
+.I address1
+\&...
+.RB [ \-version ]
+.RB [ \-help ]
.SH DESCRIPTION
-The \fIrcvdist\fR program will accept a message on its standard input
+The
+.B rcvdist
+program will accept a message on its standard input
and resend a copy of this message to all of the addresses listed on its
command line.
-
-When a message is redistributed with the \fIrcvdist\fR command, the
+.PP
+When a message is redistributed with the
+.B rcvdist
+command, the
format of the Resent-xxx header fields is controlled by the forms files
-"rcvdistcomps". If a file named "rcvdistcomps" exists in the user's nmh
+.RI \*(lq rcvdistcomps \*(rq.
+If a file named
+.RI \*(lq rcvdistcomps \*(rq
+exists in the user's nmh
directory, it will be used instead of the default one. You may specify
-an alternate forms file with the switch `\-form\ formfile'.
-
-The "rcvdistcomps" file uses the format string facility described in
-\fImh\-format\fR(5). In addition to the standard format escapes,
-\fIrcvdist\fP also recognizes the following additional \fIcomponent\fR
+an alternate forms file with the switch
+.B \-form
+.IR formfile .
+.PP
+The
+.RI \*(lq rcvdistcomps \*(rq
+file uses the format string facility described in
+.BR mh\-format (5).
+In addition to the standard format escapes,
+.B rcvdist
+also recognizes the following additional
+.I component
escape:
-.sp 1
-.ne 5
+.PP
+.RS 5
.nf
.ta \w'Dtimenow 'u +\w'Returns 'u
-\fIEscape\fR \fIReturns\fR \fIDescription\fR
-addresses string the addresses to distribute to
-.re
+.I Escape Returns Description
+addresses string the addresses to distribute to
.fi
-
-By default, \fIrcvdist\fR uses the program \fIpost\fR(8) to do the actual
+.RE
+.PP
+By default,
+.B rcvdist
+uses the program
+.B post
+to do the actual
delivery of the message, although this can be changed by defining the
-\fIpostproc\fR profile component.
-.Fi
+.I postproc
+profile component.
+
+.SH FILES
+.fc ^ ~
+.nf
+.ta \w'/usr/local/nmh/etc/ExtraBigFileName 'u
^%etcdir%/rcvdistcomps~^Default message skeleton
^or <mh\-dir>/rcvdistcomps~^Rather than standard message skeleton
^%etcdir%/mts.conf~^nmh mts configuration file
^$HOME/\&.maildelivery~^The file controlling local delivery
^%etcdir%/maildelivery~^Rather than the standard file
-.Sa
+.fi
+
+.SH "SEE ALSO"
rcvpack(1), rcvstore(1), rcvtty(1), mh\-format(5), slocal(1)
-.Bu
+
+.SH BUGS
Only two return codes are meaningful, others should be.
-.En
.\" %nmhwarning%
.\" $Id$
.\"
-.\" include the -mh macro file
-.so %etcdir%/tmac.h
-.\"
.TH RCVPACK %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
.SH NAME
rcvpack \- append message to file
.SH SYNOPSIS
-.in +.5i
-.ti -.5i
-%libdir%/rcvpack
-file
-\%[-mbox] \%[-mmdf]
-.br
-\%[\-version]
-\%[\-help]
-.in -.5i
+.HP 5
+.B %libdir%/rcvpack
+.I file
+.RB [ \-mbox ]
+.RB [ \-mmdf ]
+.RB [ \-version ]
+.RB [ \-help ]
.SH DESCRIPTION
-The \fIrcvpack\fR program will append a copy of the message to the file
+The
+.B rcvpack
+program will append a copy of the message to the file
listed on its command line.
-
-If the `-mbox' switch is given (the default), then the messages are
+.PP
+If the
+.B \-mbox
+switch is given (the default), then the messages are
separated using mbox (uucp) style delimiters. This is the format used
by most mail clients (elm, mailx, etc.).
-
-If the `-mmdf' switch is given, then the messages are separated by
+.PP
+If the
+.B \-mmdf
+switch is given, then the messages are separated by
mmdf style delimiters. Each message in the file is separated by four
CTRL\-A's and a newline.
-
-\fIrcvpack\fR will correctly lock and unlock the file to serialize
-access to the file, when running multiple copies of \fIrcvpack\fR.
-
-In general, its use is obsoleted by the \*(lqfile\*(rq action of
-\fIslocal\fR, although it might still have occasional uses in various
+.PP
+.B rcvpack
+will correctly lock and unlock the file to serialize
+access to the file, when running multiple copies of
+.B rcvpack .
+.PP
+In general, its use is obsoleted by the
+.B file
+action of
+.BR slocal ,
+although it might still have occasional uses in various
shell scripts.
-.Fi
+
+.SH FILES
+.fc ^ ~
+.nf
+.ta \w'/usr/local/nmh/etc/ExtraBigFileName 'u
^%etcdir%/mts.conf~^nmh mts configuration file
-.Sa
+.fi
+
+.SH "SEE ALSO"
rcvdist(1), rcvstore(1), rcvtty(1), slocal(1)
-.Bu
+
+.SH BUGS
Only two return codes are meaningful, others should be.
-.En
.\" %nmhwarning%
.\" $Id$
.\"
-.\" include the -mh macro file
-.so %etcdir%/tmac.h
-.\"
.TH RCVSTORE %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
.SH NAME
rcvstore \- asynchronously incorporate mail into a folder
.SH SYNOPSIS
-.in +.5i
-.ti -.5i
-%libdir%/rcvstore
-\%[+folder]
-.br
-\%[\-create] \%[\-nocreate]
-\%[\-unseen] \%[\-nounseen]
-.br
-\%[\-zero] \%[\-nozero]
-\%[\-public] \%[\-nopublic]
-.br
-\%[\-sequence\ name\ ...]
-\%[\-version]
-\%[\-help]
-.in -.5i
+.HP 5
+.B %libdir%/rcvstore
+.RI [ +folder ]
+.RB [ \-create " | " \-nocreate ]
+.RB [ \-unseen " | " \-nounseen ]
+.RB [ \-zero " | " \-nozero ]
+.RB [ \-sequence
+.I name
+\&...]
+.RB [ \-public " | " \-nopublic ]
+.RB [ \-version ]
+.RB [ \-help ]
.SH DESCRIPTION
-\fIRcvstore\fR incorporates a message from the standard input into an
-\fInmh\fR folder. This command is typically used in conjunction with
-mail filtering programs such as \fIslocal\fR and \fIprocmail\fR, to
-filter your mail into different folders.
-
-You may specify which folder to use with `+folder'. If no folder is
-specified, \fIrcvstore\fP will use the folder given by a non\-empty
+.B Rcvstore
+incorporates a message from the standard input into an
+.B nmh
+folder. This command is typically used in conjunction with
+mail filtering programs such as
+.B slocal
+and
+.BR procmail ,
+to filter your mail into different folders.
+.PP
+You may specify which folder to use with
+.IR +folder .
+If no folder is specified,
+.B rcvstore
+will use the folder given by a non\-empty
\*(lqInbox:\*(rq entry in the user's profile, else it will use the folder
named \*(lqinbox\*(rq.
-
-If the switch `\-create' is given (it is the default) and if the specified
+.PP
+If the switch
+.B \-create
+is given (it is the default) and if the specified
(or default) folder does not exist, then it will be created. You may
-disable this with the `\-nocreate' option. In this case \fIrcvstore\fP
+disable this with the
+.B \-nocreate
+option. In this case
+.B rcvstore
will exit if the specified folder does not exist.
-
+.PP
When the new message is incorporated into the folder, it is assigned
the next highest number for that folder.
-
-\fIRcvstore\fR will incorporate anything except zero length messages
-into the user's nmh folder. It will not change the message in any
+.PP
+.B Rcvstore
+will incorporate anything except zero length messages
+into the user's
+.B nmh
+folder. It will not change the message in any
way.
-
+.PP
If the user's profile contains a \*(lqMsg\-Protect: nnn\*(rq entry, it
will be used as the protection on the newly created message, otherwise
-the \fInmh\fR default of 0644 will be used. For all subsequent operations
+the
+.B nmh
+default of 0644 will be used. For all subsequent operations
on this message, this initially assigned protection will be preserved.
-
-If the switch `\-unseen' is given (it is on by default), and if the
+.PP
+If the switch
+.B \-unseen
+is given (it is on by default), and if the
profile entry \*(lqUnseen\-Sequence\*(rq is present and non\-empty, then
-\fIrcvstore\fR will add the newly incorporated message to each sequence
-named by this profile entry. You may use the switch `\-nounseen' to
-disable this. These sequences will not be zero'ed by \fIrcvstore\fR
+.B rcvstore
+will add the newly incorporated message to each sequence
+named by this profile entry. You may use the switch
+.B \-nounseen
+to disable this. These sequences will not be zero'ed by
+.B rcvstore
prior to adding the new message.
-
+.PP
Furthermore, the incoming message may be added to additional sequences
-as they arrive by the use of the `\-sequence' switch. As with the
-commands \fIpick\fP and \fImark\fP, you may also use the switches
-`\-zero' and `\-nozero' to specify whether to zero old sequences or not.
-Similarly, use of the `\-public' and `\-nopublic switches may be used
+as they arrive by the use of the
+.B \-sequence
+switch. As with the
+commands
+.B pick
+and
+.BR mark ,
+you may also use the switches
+.B \-zero
+and
+.B \-nozero
+to specify whether to zero old sequences or not.
+Similarly, use of the
+.B \-public
+and
+.B \-nopublic
+switches may be used
to force these sequences to be public or private sequences.
-.Fi
+.SH FILES
+.fc ^ ~
+.nf
+.ta \w'/usr/local/nmh/etc/ExtraBigFileName 'u
^$HOME/\&.mh\(ruprofile~^The user profile
-.Pr
+.fi
+
+.SH "PROFILE COMPONENTS"
+.fc ^ ~
+.nf
+.ta 2.4i
+.ta \w'ExtraBigProfileName 'u
^Path:~^To determine the user's nmh directory
-.Ps
^Folder\-Protect:~^To set mode when creating a new folder
-.Ps
^Inbox:~^To find the default inbox
-.Ps
^Msg\-Protect:~^To set mode when creating a new message
-.Ps
^Unseen\-Sequence:~^To name sequences denoting unseen messages
-.Sa
+.fi
+
+.SH "SEE ALSO"
rcvdist(1), rcvpack(1), rcvtty(1), mh\-sequence(5)
-.De
-`+folder' defaults to \*(lqInbox\*(rq profile entry
-.Ds
-`\-create'
-.Ds
-`\-unseen'
-.Ds
-`\-nozero'
-.Co
+
+.SH DEFAULTS
+.nf
+.RB ` +folder "' defaults to \*(lqInbox\*(rq profile entry"
+.RB ` \-create '
+.RB ` \-unseen '
+.RB ` \-nozero '
+.fi
+
+.SH CONTEXT
No context changes will be attempted, with the exception of
sequence manipulation.
-.Bu
-If you use the \*(lqUnseen\-Sequence\*(rq profile entry, \fIrcvstore\fP
-could try to update the context while another \fInmh\fP process
+
+.SH BUGS
+If you use the \*(lqUnseen\-Sequence\*(rq profile entry,
+.B rcvstore
+could try to update the context while another
+.B nmh
+process
is also trying to do so. This can cause the context to become
-corrupted. To avoid this, do not use \fIrcvstore\fP if you use the
+corrupted. To avoid this, do not use
+.B rcvstore
+if you use the
\*(lqUnseen\-Sequence\*(rq profile entry.
-.En
.\" %nmhwarning%
.\" $Id$
.\"
-.\" include the -mh macro file
-.so %etcdir%/tmac.h
-.\"
.TH RCVTTY %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
.SH NAME
rcvtty \- report new mail
.SH SYNOPSIS
-.in +.5i
-.ti -.5i
-%libdir%/rcvtty
-\%[command]
-.br
-\%[\-form\ formatfile]
-\%[\-format\ string]
-\%[\-width\ columns]
-.br
-\%[\-bell] \%[\-nobell]
-\%[\-newline]
-\%[\-nonewline]
-\%[\-biff]
-.br
-\%[\-version]
-\%[\-help]
-.in -.5i
+.HP 5
+.B %libdir%/rcvtty
+.RI [ command ]
+.RB [ \-form
+.IR formatfile ]
+.RB [ \-format
+.IR string ]
+.RB [ \-width
+.IR columns ]
+.RB [ \-bell " | " \-nobell ]
+.RB [ \-newline " | " \-nonewline ]
+.RB [ \-biff ]
+.RB [ \-version ]
+.RB [ \-help ]
.SH DESCRIPTION
-The \fIrcvtty\fR can be used to report new mail. It is used primarily
-in conjunction with mail filtering agents such as \fIslocal\fP or
-\fIprocmail\fP.
-
-The \fIrcvtty\fR program executes the named command with the message as
+The
+.B rcvtty
+can be used to report new mail. It is used primarily
+in conjunction with mail filtering agents such as
+.B slocal
+or
+.BR procmail .
+.PP
+The
+.B rcvtty
+program executes the named command with the message as
its standard input, and writes the resulting output on your terminal.
-
-Alternately, if no command is specified (or is bogus), then \fIrcvtty\fR
+.PP
+Alternately, if no command is specified (or is bogus), then
+.B rcvtty
will instead write a one\-line scan listing. The default output format
of this scan listing may be overridden by using either the
-`\-form\ formatfile' or `\-format\ string' option, similar to the
-equivalent options for \fIscan\fP and \fIinc\fP.
-See \fImh\-format\fP(5) for details.
-
+.B \-form
+.I formatfile
+or
+.B \-format
+.I string
+option, similar to the
+equivalent options for
+.B scan
+and
+.BR inc .
+See
+.BR mh\-format (5)
+for details.
+.PP
A newline is output before the message output, and the terminal bell is
-rung after the output. The `\-nonewline' and `\-nobell' options will
+rung after the output. The
+.B \-nonewline
+and
+.B \-nobell
+options will
inhibit these functions.
-
-The switch `\-width\ columns' may be given to specify the width of
+.PP
+The switch
+.B \-width
+.I columns
+may be given to specify the width of
the scan line. The default is to use the width of the terminal.
-
+.PP
In addition to the standard format escapes described in
-\fImh\-format\fR(5), \fIrcvtty\fR also recognizes the following additional
-\fIcomponent\fR escapes:
-.sp 1
-.ne 5
+.BR mh\-format (5),
+.B rcvtty
+also recognizes the following additional
+.I component
+escapes:
+.PP
+.RS 5
.nf
.ta \w'Dtimenow 'u +\w'Returns 'u
-\fIEscape\fR \fIReturns\fR \fIDescription\fR
+Escape Returns Description
body string the (compressed) first part of the body
dtimenow date the current date
folder string the name of the current folder
-.re
.fi
-
-By default, \fIrcvtty\fP will send its output to every terminal on the
+.RE
+.PP
+By default,
+.B rcvtty
+will send its output to every terminal on the
local machine that is owned by current user, and that has given write
-permission as granted by the command \fImesg\fP\0(1). If the option
-`\-biff' is given, then \fIrcvtty\fP will obey the notification status
-set by the command \fIbiff\fP\0(1) instead.
-.Fi
+permission as granted by the command
+.BR mesg (1).
+If the option
+.B \-biff
+is given, then
+.B rcvtty
+will obey the notification status
+set by the command
+.BR biff (1)
+instead.
+
+.SH FILES
+.fc ^ ~
+.nf
+.ta \w'/usr/local/nmh/etc/ExtraBigFileName 'u
^%etcdir%/mts.conf~^nmh mts configuration file
^$HOME/\&.maildelivery~^The file controlling local delivery
^%etcdir%/maildelivery~^Rather than the standard file
-.De
-`\-width' defaults to the width of the terminal
-.Ds
-`\-newline'
-.Ds
-`\-bell'
-.Sa
+.fi
+
+.SH CONTEXT
+None
+
+.SH DEFAULTS
+.nf
+.RB ` \-width "' defaults to the width of the terminal"
+.RB ` \-newline '
+.RB ` \-bell '
+.fi
+
+.SH "SEE ALSO"
rcvdist(1), rcvpack(1), rcvstore(1), mh\-format(5), slocal(1)
-.Bu
+
+.SH BUGS
Only two return codes are meaningful, others should be.
-.En
.\" %nmhwarning%
.\" $Id$
.\"
-.\" include the -mh macro file
-.so %etcdir%/tmac.h
-.\"
.TH REFILE %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
.SH NAME
refile \- file message in other folders
.SH SYNOPSIS
-.in +.5i
-.ti -.5i
-refile
-\%[msgs]
-\%[\-draft]
-\%[\-link] \%[\-nolink]
-.br
-\%[\-preserve] \%[\-nopreserve]
-\%[\-unlink] \%[\-nounlink]
-.br
-\%[\-src\ +folder]
-\%[\-file\ file]
-\%[\-rmmproc program]
-.br
-\%[\-normmproc]
-+folder1 ...
-\%[\-version]
-\%[\-help]
-.in -.5i
+.HP 5
+.B refile
+.RI [ msgs ]
+.RB [ \-draft ]
+.RB [ \-link " | " \-nolink ]
+.RB [ \-preserve " | " \-nopreserve ]
+.RB [ \-unlink " | " \-nounlink ]
+.RB [ \-src
+.IR +folder ]
+.RB [ \-file
+.IR file ]
+.RB [ \-rmmproc
+.IR program ]
+.RB [ \-normmproc ]
+.I +folder1
+\&...
+.RB [ \-version ]
+.RB [ \-help ]
.SH DESCRIPTION
-\fIRefile\fR moves (\fImv\fR\0(1)) or links (\fIln\fR\0(1)) messages
+.B Refile
+moves (see
+.BR mv (1))
+or links (see
+.BR ln (1))
+messages
from a source folder into one or more destination folders.
-
+.PP
If you think of a message as a sheet of paper, this operation is not
unlike filing the sheet of paper (or copies) in file cabinet folders.
When a message is filed, it is linked into the destination folder(s)
storage overhead. This facility provides a good way to cross\-file or
multiply\-index messages. For example, if a message is received from
Jones about the ARPA Map Project, the command
-
- refile\0cur\0+jones\0+Map
-
+.PP
+.RS 5
+refile\0cur\0+jones\0+Map
+.RE
+.PP
would allow the message to be found in either of the two folders `jones'
or `Map'.
-
-You may specify the source folder using `\-src\ +folder'. If this is
+.PP
+You may specify the source folder using
+.B \-src
+.IR +folder .
+If this is
not given, the current folder is used by default. If no message is
specified, then `cur' is used by default.
-
-The option `\-file\ file' directs \fIrefile\fR to use the specified file
+.PP
+The option
+.B \-file
+.I file
+directs
+.B refile
+to use the specified file
as the source message to be filed, rather than a message from a folder.
Note that the file should be a validly formatted message, just like
-any other \fInmh\fR message. It should \fBNOT\fR be in mail drop format
-(to convert a file in mail drop format to a folder of \fInmh\fR messages,
-see \fIinc\fR\0(1)).
-
-If a destination folder doesn't exist, \fIrefile\fR will ask if you want
+any other
+.B nmh
+message. It should
+.B NOT
+be in mail drop format
+(to convert a file in mail drop format to a folder of
+.B nmh
+messages,
+see
+.BR inc (1)).
+.PP
+If a destination folder doesn't exist,
+.B refile
+will ask if you want
to create it. A negative response will abort the file operation. If the
-standard input for \fIrefile\fR is \fInot\fR a tty, then \fIrefile\fR
+standard input for
+.B refile
+is
+.B not
+a tty, then
+.B refile
will not ask any questions and will proceed as if the user answered
\*(lqyes\*(rq to all questions.
-
-The option `\-link' preserves the source folder copy of the message (i.e.,
-it does a \fIln\fR(1) rather than a \fImv\fR(1)), whereas, `\-nolink'
+.PP
+The option
+.B \-link
+preserves the source folder copy of the message (i.e.,
+it does a
+.BR ln (1)
+rather than a
+.BR mv (1)),
+whereas,
+.B \-nolink
(the default) deletes the filed messages from the source folder.
-
+.PP
Normally when a message is refiled, for each destination folder it
is assigned the number which is one above the current highest message
-number in that folder. Use of the `\-preserve' switch will override
+number in that folder. Use of the
+.B \-preserv
+switch will override
this message renaming, and try to preserve the number of the message.
-If a conflict for a particular folder occurs when using the `\-preserve'
-switch, then \fIrefile\fR will use the next available message number
+If a conflict for a particular folder occurs when using the
+.B \-preserve
+switch, then
+.B refile
+will use the next available message number
which is above the message number you wish to preserve.
-
-If `\-link' is not specified (or `\-nolink' is specified), the filed
+.PP
+If
+.B \-link
+is not specified (or
+.B \-nolink
+is specified), the filed
messages will be removed from the source folder. The default is to
remove these messages by renaming them with a site-dependent prefix
(usually a comma). Such files will then need to be removed in some
manner after a certain amount of time. Many sites arrange for
-\fIcron\fR\0(8) to remove these files once a day, so check with your
+.B cron
+to remove these files once a day, so check with your
system administrator.
-
-Alternately, if you wish for \fIrefile\fR to really remove the files
+.PP
+Alternately, if you wish for
+.B refile
+to really remove the files
representing these messages from the source folder, you can use the
-`-unlink' switch (not to be confused with the -link switch). But
+.B -unlink
+switch (not to be confused with the
+.B \-link
+switch). But
messages removed by this method cannot be later recovered.
-
-.ne 4
+.PP
If you prefer a more sophisticated method of `removing' the messages
-from the source folder, you can define the \fIrmmproc\fR profile
+from the source folder, you can define the
+.B rmmproc
+profile
component. For example, you can add a profile component such as
-
- rmmproc: /home/coleman/bin/rmm_msgs
-
-then \fIrefile\fR will instead call the named program or script to
+.PP
+.RS 5
+rmmproc: /home/coleman/bin/rmm_msgs
+.RE
+.PP
+then
+.B refile
+will instead call the named program or script to
handle the message files.
-
-The user may specify `\-rmmproc program' on the command line to
-override this profile specification. The `-normmproc' option forces
+.PP
+The user may specify
+.B \-rmmproc
+.I program
+on the command line to
+override this profile specification. The
+.B \-normmproc
+option forces
the message files to be deleted by renaming or unlinking them as
described above.
-
-The `\-draft' switch tells \fIrefile\fR to file the <mh\-dir>/draft.
-.Fi
+.PP
+The
+.B \-draft
+switch tells
+.B refile
+to file the <mh\-dir>/draft.
+
+.SH FILES
+.fc ^ ~
+.nf
+.ta \w'/usr/local/nmh/etc/ExtraBigFileName 'u
^$HOME/\&.mh\(ruprofile~^The user profile
-.Pr
+.fi
+
+.SH "PROFILE COMPONENTS"
+.fc ^ ~
+.nf
+.ta 2.4i
+.ta \w'ExtraBigProfileName 'u
^Path:~^To determine the user's nmh directory
-.Ps
^Current\-Folder:~^To find the default current folder
-.Ps
^Folder\-Protect:~^To set mode when creating a new folder
-.Ps
^rmmproc:~^Program to delete the message
-.Sa
+.fi
+
+.SH "SEE ALSO"
folder(1), rmf(1), rmm(1)
-.De
-`\-src\ +folder' defaults to the current folder
-.Ds
-`msgs' defaults to cur
-.Ds
-`\-nolink'
-.Ds
-`\-nounlink'
-.Ds
-`\-nopreserve'
-.Co
-If `\-src\ +folder' is given, it will become the current folder.
-If neither `\-link' nor `all' is specified, the current message in the
+
+.SH DEFAULTS
+.nf
+.RB ` "\-src\ +folder" "' defaults to the current folder"
+.RB ` msgs "' defaults to cur"
+.RB ` \-nolink '
+.RB ` \-nounlink '
+.RB ` \-nopreserve '
+.fi
+
+.SH CONTEXT
+If
+.B \-src
+.I +folder
+is given, it will become the current folder.
+If neither
+.B \-link
+nor `all' is specified, the current message in the
source folder will be set to the last message specified; otherwise, the
current message won't be changed.
-
-If the Previous\-Sequence profile entry is set, in addition to defining
-the named sequences from the source folder, \fIrefile\fR will also define
-those sequences for the destination folders. See \fImh\-sequence\fR\0(5)
+.PP
+If the \*(lqPrevious\-Sequence\*(rq profile entry is set, in addition to defining
+the named sequences from the source folder,
+.B refile
+will also define
+those sequences for the destination folders. See
+.B mh\-sequence (5)
for information concerning the previous sequence.
-.Bu
-Since \fIrefile\fR uses your \fIrmmproc\fP to delete the message,
-the \fIrmmproc\fP must \fBNOT\fP call \fIrefile\fP without specifying
-`\-normmproc', or you will create an infinite loop.
-.En
+
+.SH BUGS
+Since
+.B refile
+uses your
+.I rmmproc
+to delete the message,
+the
+.I rmmproc
+must
+.B NOT
+call
+.B refile
+without specifying
+.BR \-normmproc ,
+or you will create an infinite loop.
.\" %nmhwarning%
.\" $Id$
.\"
-.\" include the -mh macro file
-.so %etcdir%/tmac.h
-.\"
.TH REPL %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
.SH NAME
repl \- reply to a message
.SH SYNOPSIS
-.in +.5i
-.ti -.5i
-repl
-\%[+folder] \%[msg]
-.br
-\%[\-group] \%[\-nogroup]
-\%[\-annotate] \%[\-noannotate]
-.br
-\%[\-cc\ all/to/cc/me] \%[\-nocc\ all/to/cc/me]
-.br
-\%[\-query] \%[\-noquery]
-\%[\-form\ formfile]
-.br
-\%[\-format] \%[\-noformat]
-\%[\-filter\ filterfile]
-.br
-\%[\-inplace] \%[\-noinplace]
-\%[\-mime] \%[\-nomime]
-.br
-\%[\-fcc\ +folder]
-\%[\-width\ columns]
-.br
-\%[\-draftfolder\ +folder] \%[\-draftmessage\ msg]
-.br
-\%[\-nodraftfolder]
-\%[\-editor\ editor] \%[\-noedit]
-.br
-\%[\-whatnowproc\ program] \%[\-nowhatnowproc]
-.br
-\%[\-build]
-\%[-file msgfile]
-.br
-\%[\-version]
-\%[\-help]
-.in -.5i
+.HP 5
+.B repl
+.RI [ +folder ]
+.RI [ msgs ]
+.RB [ \-annotate " | " \-noannotate ]
+.RB [ \-group " | " \-nogroup ]
+.RB [ \-cc
+all/to/cc/me]
+.RB [ \-nocc
+all/to/cc/me]
+.RB [ \-query " | " \-noquery ]
+.RB [ \-form
+.IR formfile ]
+.RB [ \-format " | " \-noformat ]
+.RB [ \-filter
+.IR filterfile ]
+.RB [ \-inplace " | " \-noinplace ]
+.RB [ \-mime " | " \-nomime ]
+.RB [ \-fcc
+.IR +folder ]
+.RB [ \-width
+.IR columns ]
+.RB [ \-draftfolder
+.IR +folder ]
+.RB [ \-draftmessage
+.IR msg ]
+.RB [ \-nodraftfolder ]
+.RB [ \-editor
+.IR editor ]
+.RB [ \-noedit ]
+.RB [ \-whatnowproc
+.IR program ]
+.RB [ \-nowhatnowproc ]
+.RB [ \-build ]
+.RB [ \-file
+.IR msgfile ]
+.RB [ \-version ]
+.RB [ \-help ]
.SH DESCRIPTION
-\fIRepl\fR may be used to produce a reply to an existing message.
-
-In its simplest form (with no arguments), \fIrepl\fR will set up a
+.B Repl
+may be used to produce a reply to an existing message.
+.PP
+In its simplest form (with no arguments),
+.B repl
+will set up a
message\-form skeleton in reply to the current message in the current
folder, and invoke the whatnow shell.
-
-In order to construct the message draft of the reply, \fIrepl\fR uses
+.PP
+In order to construct the message draft of the reply,
+.B repl
+uses
a reply template to guide its actions. A reply template is simply a
-\fImhl\fR format file (see \fImh\-format\fR\0(5) for details).
-
-If the switch `\-nogroup' is given (it is on by default), then \fIrepl\fR
+.B mhl
+format file (see
+.BR mh\-format (5)
+for details).
+.PP
+If the switch
+.B \-nogroup
+is given (it is on by default), then
+.B repl
will use the standard forms file \*(lqreplcomps\*(rq. This will construct
a draft message that is intended to be sent only to the author of the
message to which you are replying. If a file named \*(lqreplcomps\*(rq
-exists in the user's nmh directory, it will be used instead of this
+exists in the user's
+.B nmh
+directory, it will be used instead of this
default forms file.
-
-The default reply template \*(lqreplcomps\*(rq will direct \fIrepl\fR
+.PP
+The default reply template \*(lqreplcomps\*(rq will direct
+.B repl
to construct the reply message draft as follows:
-
+.PP
+.RS 5
.nf
-.in 1i
To: <Mail\-Reply\-To> or <Reply\-To> or <From>
cc: <To> and <cc> and <personal address>
Subject: Re: <Subject>
In\-Reply\-To: Your message of <Date>.
.ti +\w'In\-Reply\-To: 'u
<Message\-Id>
-.in .5i
+--------
.fi
-
+.RE
+.PP
where field names enclosed in angle brackets (<\ >) indicate the
contents of the named field from the message to which the reply is
being made.
-
+.PP
By default, the \*(lqcc:\*(rq field is empty. You may selectively add
-addresses to this default with the `\-cc\ type' switch. This switch takes an
-argument (all/to/cc/me) which specifies who gets added to the default
+addresses to this default with the
+.B \-cc
+.I type
+switch. This switch takes an
+argument (
+.IR all / to / cc / me )
+which specifies who gets added to the default
\*(lqcc:\*(rq list of the reply. You may give this switch multiple times (with
different arguments) if you wish to add multiple types of addresses.
-
-If the switch `\-group' is given, then \fIrepl\fR will use the the
+.PP
+If the switch
+.B \-group
+is given, then
+.B repl
+will use the the
standard forms file \*(lqreplgroupcomps\*(rq. This will construct a
draft message that is intended as a group or followup reply. If a file
named \*(lqreplgroupcomps\*(rq exists in the user's nmh directory, it
will be used instead of this default forms file.
-
+.PP
The default group reply template \*(lqreplgroupcomps\*(rq will direct
-\fIrepl\fR to construct the reply message draft as follows:
-
+.B repl
+to construct the reply message draft as follows:
+.PP
+.RS 5
.nf
-.in 1i
To: <Mail\-Followup\-To>
Subject: Re: <Subject>
In\-Reply\-To: Message from <From> of <Date>.
.ti +\w'In\-Reply\-To: 'u
<Message\-Id>
-.in .5i
+--------
.fi
-
+.RE
+.PP
or if the field <Mail\-Followup\-To> is not available:
-
+.PP
+.RS 5
.nf
-.in 1i
To: <Mail\-Reply\-To> or <Reply\-To> or <From>
cc: <To> and <cc> and <personal address>
Subject: Re: <Subject>
In\-Reply\-To: Message from <From> of <Date>.
.ti +\w'In\-Reply\-To: 'u
<Message\-Id>
-.in .5i
+--------
.fi
-
+.RE
+.PP
By default, the \*(lqcc:\*(rq contains all the addresses shown. You may
-selectively remove addresses from this default with the `\-nocc\ type' switch.
-This switch takes an argument (all/to/cc/me) which specifies who gets removed
+selectively remove addresses from this default with the
+.B \-nocc
+.I type
+switch.
+This switch takes an argument (
+.IR all / to / cc / me )
+which specifies who gets removed
from the default \*(lqcc:\*(rq list of the reply. You may give this switch
multiple times (with different arguments) if you wish to remove multiple types
of addresses.
-
+.PP
In any case, you may specify an alternate forms file with the switch
-`\-form\ formfile'.
-
-The `\-query' switch modifies the action of `\-nocc\ type' switch by
+.B \-form
+.IR formfile .
+.PP
+The
+.B \-query
+switch modifies the action of
+.B \-nocc
+.I type
+switch by
interactively asking you if each address that normally would be placed in
the \*(lqTo:\*(rq and \*(lqcc:\*(rq list should actually be sent a copy.
This is useful for special\-purpose replies. Note that the position of
-the `\-cc' and `\-nocc' switches, like all other switches which take a
+the
+.B \-cc
+and
+.B \-nocc
+switches, like all other switches which take a
positive and negative form, is important.
-
+.PP
Lines beginning with the fields \*(lqTo:\*(rq, \*(lqcc:\*(rq, and
\*(rqBcc:\*(rq will be standardized and have duplicate addresses removed.
-In addition, the `\-width\ columns' switch will guide \fIrepl\fR's
+In addition, the
+.B \-width
+.I columns
+switch will guide
+.BR repl 's
formatting of these fields.
-
-If the draft already exists, \fIrepl\fR will ask you as to the disposition
-of the draft. A reply of \fBquit\fR will abort \fIrepl\fR, leaving the
-draft intact; \fBreplace\fR will replace the existing draft with a blank
-skeleton; and \fBlist\fR will display the draft.
-
-See \fIcomp\fR\0(1) for a description of the `\-editor' and `\-noedit'
+.PP
+If the draft already exists,
+.B repl
+will ask you as to the disposition
+of the draft. A reply of
+.B quit
+will abort
+.BR repl ,
+leaving the
+draft intact;
+.B replace
+will replace the existing draft with a blank
+skeleton; and
+.B list
+will display the draft.
+.PP
+See
+.BR comp (1)
+for a description of the
+.B \-editor
+and
+.B \-noedit
switches. Note that while in the editor, the message being replied
to is available through a link named \*(lq@\*(rq (assuming the default
-\fIwhatnowproc\fR\0). In addition, the actual pathname of the message is
-stored in the environment variable \fB$editalt\fR, and the pathname of
+.IR whatnowproc ).
+In addition, the actual pathname of the message is
+stored in the environment variable
+.BR $editalt ,
+and the pathname of
the folder containing the message is stored in the environment variable
-\fB$mhfolder\fR.
-
-Although \fIrepl\fR uses a forms file to direct it how to construct
+.BR $mhfolder .
+.PP
+Although
+.B repl
+uses a forms file to direct it how to construct
the beginning of the draft, it uses a message filter file to direct
it as to how the message to which you are replying should be filtered
-(re\-formatted) in the body of the draft. The filter file for \fIrepl\fR
-should be a standard form file for \fImhl\fR, as \fIrepl\fR will invoke
-\fImhl\fR to format the message to which you are replying.
-
-The switches `\-noformat', `\-format', and `\-filter\ filterfile' specify
+(re\-formatted) in the body of the draft. The filter file for
+.B repl
+should be a standard form file for
+.BR mhl ,
+as
+.B repl
+will invoke
+.B mhl
+to format the message to which you are replying.
+.PP
+The switches
+.BR \-noformat ,
+.BR \-format ,
+and
+.B \-filter
+.I filterfile
+specify
which message filter file to use.
-
-If the switch `\-noformat' is given (it is the default), then the message
+.PP
+If the switch
+.B \-noformat
+is given (it is the default), then the message
to which you are replying is not included in the body of the draft.
-
-If the switch `\-format' is given, then a default message filter file
+.PP
+If the switch
+.B \-format
+is given, then a default message filter file
is used. This default message filter should be adequate for most users.
-This default filter \*(lqmhl.reply\*(rq is:
-
+This default filter
+.RI \*(lq mhl.reply \*(rq
+is:
+.PP
+.RS 5
.nf
-.in +.5i
-.ne 10
-.eo
-.so %etcdir%/mhl.reply
-.ec
-.in -.5i
+%mhl_reply%
.fi
-
+.RE
+.PP
which outputs each line of the body of the message prefaced with the
\*(lq>\*(rq character and a space.
-
-If a file named \*(lqmhl.reply\*(rq exists in the user's nmh directory,
+.PP
+If a file named
+.RI \*(lq mhl.reply \*(rq
+exists in the user's
+.B nmh
+directory,
it will be used instead of this form. You may specify an alternate
-message filter file with the switch `\-filter\ filterfile'.
-
+message filter file with the switch
+.B \-filter
+.IR filterfile .
+.PP
Other reply filters are commonly used, such as:
-
+.PP
+.RS 5
.nf
-.in +.5i
:
body:nocomponent,compwidth=9,offset=9
-.in -.5i
.fi
-
+.RE
+.PP
which says to output a blank line and then the body of the message
being replied\-to, indented by one tab\-stop. Another popular format
is:
-
+.PP
+.RS 5
.nf
-.in +.5i
-.ie n \{
message-id:nocomponent,\|nonewline,\\
-formatfield=\*(lqIn message %{text},\ \*(rq \}
-.el message-id:nocomponent,\|nonewline,\|formatfield=\*(lqIn message %{text},\ \*(rq
+formatfield=\*(lqIn message %{text},\ \*(rq
from:nocomponent,\|formatfield=\*(lq%(friendly{text}) writes:\*(rq
body:component=\*(lq>\*(rq,\|overflowtext=\*(lq>\*(rq,\|overflowoffset=0
-.in -.5i
.fi
-
+.RE
+.PP
This message filter file cites the Message-ID and author of the message
being replied\-to, and then outputs each line of the body prefaced with
the \*(lq>\*(rq character.
-
-To use the MIME rules for encapsulation, specify the `\-mime' switch.
-This directs \fIreply\fR to generate an \fImhbuild\fR composition file.
-Note that nmh will not invoke \fImhbuild\fR automatically, unless you
-add this line to your \&.mh\(ruprofile file:
-.sp
-.in +.5i
+.PP
+To use the MIME rules for encapsulation, specify the
+.B \-mime
+switch.
+This directs
+.B repl
+to generate an
+.B mhbuild
+composition file.
+Note that
+.B nmh
+will not invoke
+.B mhbuild
+automatically, unless you
+add this line to your
+.I \&.mh\(ruprofile
+file:
+.PP
+.RS 5
automimeproc: 1
-.in -.5i
-.sp
+.RE
+.PP
Otherwise, you must specifically give the command
-.sp
-.in +.5i
+.PP
+.RS 5
What now? mime
-.in -.5i
-.sp
+.RE
+.PP
prior to sending the draft.
-
-If the `\-annotate' switch is given, the message being replied\-to will
+.PP
+If the
+.B \-annotate
+switch is given, the message being replied\-to will
be annotated with the lines
-
- Replied:\ date
- Replied:\ addrs
-
+.PP
+.RS 5
+Replied:\ date
+Replied:\ addrs
+.RE
+.PP
where the address list contains one line for each addressee.
The annotation will be done only if the message is sent directly from
-\fIrepl\fR. If the message is not sent immediately from \fIrepl\fR,
-\*(lqcomp\ \-use\*(rq may be used to re\-edit and send the constructed
+.BR repl .
+If the message is not sent immediately from
+.BR repl ,
+.RB \*(lq "comp\ \-use" \*(rq
+may be used to re\-edit and send the constructed
message, but the annotations won't take place. Normally annotations are
done inplace in order to preserve any links to the message. You may use
-the `\-noinplace' switch to change this.
-
-The `\-fcc\ +folder' switch can be used to automatically specify a folder
-to receive Fcc:s. More than one folder, each preceded by `\-fcc' can
+the
+.B \-noinplace
+switch to change this.
+.PP
+The
+.B \-fcc
+.I +folder
+switch can be used to automatically specify a folder
+to receive Fcc:s. More than one folder, each preceded by
+.B \-fcc
+can
be named.
-
-In addition to the standard \fImh\-format\fR\0(5) escapes, \fIrepl\fR
-also recognizes the following additional \fIcomponent\fR escape:
-.sp 1
+.PP
+In addition to the standard
+.BR mh\-format (5)
+escapes,
+.B repl
+also recognizes the following additional
+.I component
+escape:
+.PP
+.RS 5
.nf
.ta \w'Escape 'u +\w'Returns 'u
-\fIEscape\fR \fIReturns\fR \fIDescription\fR
-\fIfcc\fR string Any folders specified with `\-fcc\ folder'
-.re
+.I Escape Returns Description
+fcc string Any folders specified with `\-fcc\ folder'
.fi
-
-To avoid reiteration, \fIrepl\fR strips any leading `Re: ' strings from
-the \fIsubject\fR component.
-
-The `\-draftfolder\ +folder' and `\-draftmessage\ msg' switches invoke
-the \fInmh\fR draft folder facility. This is an advanced (and highly
-useful) feature. Consult the \fImh-draft\fR(5) man page for more
+.RE
+.PP
+To avoid reiteration,
+.B repl
+strips any leading `Re: ' strings from
+the
+.I subject
+component.
+.PP
+The
+.B \-draftfolder
+.I +folder
+and
+.B \-draftmessage
+.I msg
+switches invoke
+the
+.B nmh
+draft folder facility. This is an advanced (and highly
+useful) feature. Consult the
+.BR mh-draft (5)
+man page for more
information.
-
-Upon exiting from the editor, \fIrepl\fR will invoke the \fIwhatnow\fR
-program. See \fIwhatnow\fR\0(1) for a discussion of available
+.PP
+Upon exiting from the editor,
+.B repl
+will invoke the
+.B whatnow
+program. See
+.BR whatnow (1)
+for a discussion of available
options. The invocation of this program can be inhibited by using the
-`\-nowhatnowproc' switch. (In truth of fact, it is the \fIwhatnow\fR
-program which starts the initial edit. Hence, `\-nowhatnowproc' will
+.B \-nowhatnowproc
+switch. (In truth of fact, it is the
+.B whatnow
+program which starts the initial edit. Hence,
+.B \-nowhatnowproc
+will
prevent any edit from occurring.)
-
-The `\-build' switch is intended to be used by the Emacs mh-e interface
-to \fInmh\fR, and is only present if \fInmh\fR was compiled with support
-for mh-e. It implies `\-nowhatnowproc'. It causes a file <mh\-dir>/reply
+.PP
+The
+.B \-build
+switch is intended to be used by the Emacs mh-e interface
+to
+.BR nmh ,
+and is only present if
+.B nmh
+was compiled with support
+for mh-e. It implies
+.BR \-nowhatnowproc .
+It causes a file
+.I <mh\-dir>/reply
to be created, containing the draft message that would normally be presented
to the user for editing.
No mail is actually sent. Note that this switch is not guaranteed to
-be present or to have the same effects in future versions of \fInmh\fR:
+be present or to have the same effects in future versions of
+.BR nmh :
it is documented here only for completeness.
-
-The `\-file\ msgfile' switch specifies the message to be replied to as an
-exact filename rather than as an \fInmh\fR folder and message number. It is
-intended to be used by the \fImsh\fR\0(1) interface to \fInmh\fR.
-The same caveats apply to this option as to the `\-build' switch.
-
-.Fi
+.PP
+The
+.B \-file
+.I msgfile
+switch specifies the message to be replied to 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 .
+The same caveats apply to this option as to the
+.B \-build
+switch.
+
+.SH FILES
+.fc ^ ~
+.nf
+.ta \w'/usr/local/nmh/etc/ExtraBigFileName 'u
^%etcdir%/replcomps~^The standard reply template
^or <mh\-dir>/replcomps~^Rather than the standard template
^%etcdir%/replgroupcomps~^The standard `reply -group' template
^or <mh\-dir>/mhl.reply~^Rather than the standard filter
^$HOME/\&.mh\(ruprofile~^The user profile
^<mh\-dir>/draft~^The draft file
-.Pr
+.fi
+
+.SH "PROFILE COMPONENTS"
+.fc ^ ~
+.nf
+.ta 2.4i
+.ta \w'ExtraBigProfileName 'u
^Path:~^To determine the user's nmh directory
-.Ps
^Alternate\-Mailboxes:~^To determine the user's mailboxes
-.Ps
^Current\-Folder:~^To find the default current folder
-.Ps
^Draft\-Folder:~^To find the default draft\-folder
-.Ps
^Editor:~^To override the default editor
-.Ps
^Msg\-Protect:~^To set mode when creating a new message (draft)
-.Ps
^fileproc:~^Program to refile the message
-.Ps
^mhlproc:~^Program to filter message being replied\-to
-.Ps
^whatnowproc:~^Program to ask the \*(lqWhat now?\*(rq questions
-.Sa
+.fi
+
+.SH "SEE ALSO"
mhbuild(1), comp(1), forw(1), send(1), whatnow(1), mh\-format(5)
-.De
-`+folder' defaults to the current folder
-.Ds
-`msg' defaults to cur
-.Ds
-`\-nogroup'
-.Ds
-`\-nocc\ all' with `\-nogroup', `\-cc\ all' with `\-group'
-.Ds
-`\-noannotate'
-.Ds
-`\-nodraftfolder'
-.Ds
-`\-noformat'
-.Ds
-`\-inplace'
-.Ds
-`\-nomime'
-.Ds
-`\-noquery'
-.Ds
-`\-width\ 72'
-.Co
+
+.SH DEFAULTS
+.nf
+.RB ` +folder "' defaults to the current folder"
+.RB ` msg "' defaults to cur"
+.RB ` \-nogroup '
+.RB ` "\-nocc\ all" "' with `\-nogroup', `\-cc\ all' with `\-group'"
+.RB ` \-noannotate '
+.RB ` \-nodraftfolder '
+.RB ` \-noformat '
+.RB ` \-inplace '
+.RB ` \-nomime '
+.RB ` \-noquery '
+.RB ` "\-width\ 72" '
+.fi
+
+.SH CONTEXT
If a folder is given, it will become the current folder. The message
replied\-to will become the current message.
-.Bu
+
+.SH BUGS
If any addresses occur in the reply template, addresses in the template
that do not contain hosts are defaulted incorrectly. Instead of using
-the localhost for the default, \fIrepl\fR uses the sender's host.
+the localhost for the default,
+.B repl
+uses the sender's host.
Moral of the story: if you're going to include addresses in a reply
template, include the host portion of the address.
-
-The `\-width columns' switch is only used to do address-folding; other
+.PP
+The
+.B \-width
+.I columns
+switch is only used to do address-folding; other
headers are not line\-wrapped.
-
-If \fIwhatnowproc\fR is \fIwhatnow\fR, then \fIrepl\fR uses a built\-in
-\fIwhatnow\fR, it does not actually run the \fIwhatnow\fR program.
-Hence, if you define your own \fIwhatnowproc\fR, don't call it
-\fIwhatnow\fR since \fIrepl\fR won't run it.
-
+.PP
+If
+.I whatnowproc
+is
+.BR whatnow ,
+then
+.B repl
+uses a built\-in
+.BR whatnow ,
+it does not actually run the
+.B whatnow
+program.
+Hence, if you define your own
+.IR whatnowproc ,
+don't call it
+.B whatnow
+since
+.B repl
+won't run it.
+.PP
If your current working directory is not writable, the link named
\*(lq@\*(rq is not available.
-.En
.\" %nmhwarning%
.\" $Id$
.\"
-.\" include the -mh macro file
-.so %etcdir%/tmac.h
-.\"
.TH RMF %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
.SH NAME
rmf \- remove an nmh folder
.SH SYNOPSIS
-.in +.5i
-.ti -.5i
-rmf
-\%[+folder]
-\%[\-interactive] \%[\-nointeractive]
-.br
-\%[\-version]
-\%[\-help]
-.in -.5i
+.HP 5
+.B rmf
+.RI [ +folder ]
+.RB [ \-interactive " | " \-nointeractive ]
+.RB [ \-version ]
+.RB [ \-help ]
.SH DESCRIPTION
-\fIRmf\fR removes all of the messages (files) within the specified
+.B Rmf
+removes all of the messages (files) within the specified
(or default) folder, and then removes the folder (directory) itself.
-
+.PP
If there are any files within the folder which are not a part of
-\fInmh\fR, they will \fInot\fR be removed, and an error will be produced.
-If the folder is given explicitly or the `\-nointeractive' option is
+.BR nmh ,
+they will
+.B not
+be removed, and an error will be produced.
+If the folder is given explicitly or the
+.B \-nointeractive
+option is
given, then the folder will be removed without confirmation. Otherwise,
-the user will be asked for confirmation. If \fIrmf\fR can't find the
+the user will be asked for confirmation. If
+.B rmf
+can't find the
current folder, for some reason, the folder to be removed defaults to
`+inbox' (unless overridden by user's profile entry \*(lqInbox\*(rq)
with confirmation.
-
+.PP
If the folder being removed is a subfolder, the parent folder will become
-the new current folder, and \fIrmf\fR will produce a message telling the
+the new current folder, and
+.B rmf
+will produce a message telling the
user this has happened. This provides an easy mechanism for selecting
a set of messages, operating on the list, then removing the list and
returning to the current folder from which the list was extracted.
-
-If \fIrmf\fR is used on a read\-only folder, it will delete all the
+.PP
+If
+.B rmf
+s used on a read\-only folder, it will delete all the
(private) sequences
-(i.e., \*(lqatr\-\fIseq\fR\-\fIfolder\fR\*(rq entries) for this folder
+(i.e.,
+.RI \*(lqatr\- seq \- folder \*(rq
+entries) for this folder
from your context without affecting the folder itself.
-
-\fIRmf\fR irreversibly deletes messages that don't have other links, so
+.PP
+.B Rmf
+irreversibly deletes messages that don't have other links, so
use it with caution.
-.Fi
+
+.SH FILES
+.fc ^ ~
+.nf
+.ta \w'/usr/local/nmh/etc/ExtraBigFileName 'u
^$HOME/\&.mh\(ruprofile~^The user profile
-.Pr
+.fi
+
+.SH "PROFILE COMPONENTS"
+.fc ^ ~
+.nf
+.ta 2.4i
+.ta \w'ExtraBigProfileName 'u
^Path:~^To determine the user's nmh directory
-.Ps
^Current\-Folder:~^To find the default current folder
-.Ps
^Inbox:~^To find the default inbox
-.Sa
+.fi
+
+.SH "SEE ALSO"
rmm(1)
-.De
-`+folder' defaults to the current folder, usually with confirmation
-.Ds
-`\-interactive' if +folder' not given, `\-nointeractive' otherwise
-.Co
-\fIRmf\fR will set the current folder to the parent folder if a
+
+.SH DEFAULTS
+.nf
+.RB ` +folder "' defaults to the current folder, usually with confirmation"
+.RB ` \-interactive "' if +folder' not given, `\-nointeractive' otherwise"
+.fi
+
+.SH CONTEXT
+.B Rmf
+will set the current folder to the parent folder if a
subfolder is removed; or if the current folder is removed, it will make
\*(lqinbox\*(rq current. Otherwise, it doesn't change the current folder
or message.
-.Bu
-Although intuitively one would suspect that \fIrmf\fR works recursively,
+
+.SH BUGS
+Although intuitively one would suspect that
+.B rmf
+works recursively,
it does not. Hence if you have a sub\-folder within a folder, in order
-to \fIrmf\fR the parent, you must first \fIrmf\fR each of the children.
-.En
+to
+.B rmf
+the parent, you must first
+.B rmf
+each of the children.
.\" %nmhwarning%
.\" $Id$
.\"
-.\" include the -mh macro file
-.so %etcdir%/tmac.h
-.\"
.TH RMM %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
.SH NAME
rmm \- remove messages
.SH SYNOPSIS
-.in +.5i
-.ti -.5i
-rmm
-\%[+folder] \%[msgs]
-\%[\-unlink] \%[\-nounlink]
-.br
-\%[\-version]
-\%[\-help]
-.in -.5i
+.HP 5
+.B rmm
+.RI [ +folder ]
+.RI [ msgs ]
+.RB [ \-link " | " \-nolink ]
+.RB [ \-version ]
+.RB [ \-help ]
.SH DESCRIPTION
-By default, \fIrmm\fR will remove the specified messages by renaming
+By default,
+.B rmm
+will remove the specified messages by renaming
the message files with preceding commas. Such files will then need to
be removed in some manner after a certain amount of time. Many sites
-arrange for \fIcron\fR\0(8) to remove these files once a day, so check
+arrange for
+.B cron
+to remove these files once a day, so check
with your system administrator.
-
-Alternately, if you wish for \fIrmm\fR to really remove the files
-representing these messages, you can use the `-unlink' switch. But
+.PP
+Alternately, if you wish for
+.B rmm
+to really remove the files
+representing these messages, you can use the
+.B \-unlink
+switch. But
messages removed by this method cannot be later recovered.
-
+.PP
If you prefer a more sophisticated method of `removing' messages, you
-can define the \fIrmmproc\fR profile component. For example, you can
+can define the
+.I rmmproc
+profile component. For example, you can
add a profile component such as
-
- rmmproc: /home/coleman/bin/rmm_msgs
-
-then instead of simply renaming the message file, \fIrmm\fR will call
+.PP
+.RS 5
+rmmproc: /home/foouser/bin/rmm_msgs
+.RE
+.PP
+then instead of simply renaming the message file,
+.B rmm
+will call
the named program or script to handle the files that represent the
messages to be deleted.
-
-Some users of csh prefer the following:
-
- alias rmm 'refile +d'
-
-where folder +d is a folder for deleted messages, and
-
- alias mexp 'rm `mhpath +d all`'
-
+.PP
+Some users of
+.B csh
+prefer the following:
+.PP
+.RS 5
+alias rmm 'refile +d'
+.RE
+.PP
+where folder `+d' is a folder for deleted messages, and
+.PP
+.RS 5
+alias mexp 'rm `mhpath +d all`'
+.RE
+.PP
is used to \*(lqexpunge\*(rq deleted messages.
-
-The current message is not changed by \fIrmm\fR, so a \fInext\fR will
+.PP
+The current message is not changed by
+.BR rmm ,
+so a
+.B next
+ will
advance to the next message in the folder as expected.
-.Fi
+
+.SH FILES
+.fc ^ ~
+.nf
+.ta \w'/usr/local/nmh/etc/ExtraBigFileName 'u
^$HOME/\&.mh\(ruprofile~^The user profile
-.Pr
+.fi
+
+.SH "PROFILE COMPONENTS"
+.fc ^ ~
+.nf
+.ta 2.4i
+.ta \w'ExtraBigProfileName 'u
^Path:~^To determine the user's nmh directory
-.Ps
^Current\-Folder:~^To find the default current folder
-.Ps
^rmmproc:~^Program to delete the message
-.Sa
+.fi
+
+.SH "SEE ALSO"
refile(1), rmf(1)
-.De
-`+folder' defaults to the current folder
-.Ds
-`msgs' defaults to cur
-.Ds
-`-nounlink'
-.Co
+
+.SH DEFAULTS
+.nf
+.RB ` +folder "' defaults to the current folder"
+.RB ` msgs "' defaults to cur"
+.RB ` -nounlink '
+.fi
+
+.SH CONTEXT
If a folder is given, it will become the current folder.
-.Bu
-Since \fIrefile\fR uses your \fIrmmproc\fP to delete the message,
-the \fIrmmproc\fP must \fBNOT\fP call \fIrefile\fP without specifying
-`\-normmproc', or you will create an infinte loop.
-.En
+
+.SH BUGS
+Since
+.B refile
+uses your
+.I rmmproc
+to delete the message,
+the
+.I rmmproc
+must
+.B NOT
+call
+.B refile
+without specifying
+.BR \-normmproc ,
+or you will create an infinte loop.
.\" %nmhwarning%
.\" $Id$
.\"
-.\" include the -mh macro file
-.so %etcdir%/tmac.h
-.\"
.TH SCAN %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
.SH NAME
scan \- produce a one line per message scan listing
.SH SYNOPSIS
-.in +.5i
-.ti -.5i
-scan
-\%[+folder] \%[msgs]
-\%[\-clear] \%[\-noclear]
-\%[\-form\ formatfile]
-\%[\-format\ string]
-\%[\-header] \%[\-noheader]
-\%[\-width\ columns]
-\%[\-reverse] \%[\-noreverse]
-\%[\-file filename]
-.br
-\%[\-version]
-\%[\-help]
-.in -.5i
+.HP 5
+.B scan
+.RI [ +folder ]
+.RI [ msgs ]
+.RB [ \-clear " | " \-noclear ]
+.RB [ \-form
+.IR formatfile ]
+.RB [ \-format
+.IR string ]
+.RB [ \-header " | " \-noheader ]
+.RB [ \-width
+.IR columns ]
+.RB [ \-reverse " | " \-noreverse ]
+.RB [ \-file
+.IR filename ]
+.RB [ \-version ]
+.RB [ \-help ]
.SH DESCRIPTION
-\fIScan\fR produces a one\-line\-per\-message listing of the specified
-folder or messages. Each \fIscan\fR line contains the message number
+.B Scan
+produces a one\-line\-per\-message listing of the specified
+folder or messages. Each
+.B scan
+line contains the message number
(name), the date, the \*(lqFrom:\*(rq field, the \*(lqSubject\*(rq field,
and, if room allows, some of the body of the message. For example:
-
+.PP
+.RS 5
.nf
-.in +.5i
.ta \w'15+- 'u +\w'07/\|05x 'u +\w'Dcrocker 'u
15+ 10/\|05 crocker nned\0\0\*(<<Last week I asked some of
16\- 10/\|05 crocker message id format\0\0\*(<<I recommend
18 10/\|06 brien Re: Exit status from mkdir
19 10/\|07*brien \*(lqscan\*(rq listing format in nmh
-.re
-.in -.5i
.fi
-
+.RE
+.PP
The `+' on message 15 indicates that it is the current message.
-
+.PP
The `\-' on message 16 indicates that it has been replied to, as indicated
-by a \*(lqReplied:\*(rq component (produced by the `\-annotate' switch
-to the \fIrepl\fR command).
-
+by a \*(lqReplied:\*(rq component (produced by the
+.B \-annotate
+switch
+to the
+.B repl
+command).
+.PP
The `*' on message 19 indicates that no \*(lqDate:\*(rq header was
present. The time of last modification of the message is given instead.
-
-If there is sufficient room left on the \fIscan\fR line after the
+.PP
+If there is sufficient room left on the
+.B scan
+line after the
subject, the line will be filled with text from the body, preceded by
-<<, and terminated by >> if the body is sufficiently short. \fIScan\fR
+\*(lq<<\*(rq, and terminated by \*(lq>>\*(rq if the body is sufficiently short.
+.B Scan
actually reads each of the specified messages and parses them to extract
the desired fields. During parsing, appropriate error messages will be
produced if there are format errors in any of the messages.
-
-By default, \fIscan\fR will decode RFC-2047 (MIME) encoding in
-these scan listings. \fIScan\fR will only decode these fields if your
+.PP
+By default,
+.B scan
+will decode RFC-2047 (MIME) encoding in
+these scan listings.
+.B Scan
+will only decode these fields if your
terminal can natively display the character set used in the encoding.
You should set the MM_CHARSET environment variable to your native
character set, if it is not US-ASCII. See the mh-profile(5) man
page for details about this environment variable.
-
-The switch `\-reverse', makes \fIscan\fR list the messages in reverse
+.PP
+The switch
+.BR \-reverse ,
+makes
+.B scan
+list the messages in reverse
order.
-
-The `\-file filename' switch allows the user to obtain a \fIscan\fP
-listing of a maildrop file as produced by \fIpackf\fP. This listing
+.PP
+The
+.B \-file
+.I filename
+switch allows the user to obtain a
+.B scan
+listing of a maildrop file as produced by
+.BR packf .
+This listing
includes every message in the file (you can't scan individual messages).
-The switch `\-reverse' is ignored with this option.
-
-The switch `\-width\ columns' may be used to specify the width of
+The switch
+.B \-reverse
+is ignored with this option.
+.PP
+The switch
+.B \-width
+.I columns
+may be used to specify the width of
the scan line. The default is to use the width of the terminal.
-
-The `\-header' switch produces a header line prior to the \fIscan\fR
+.PP
+The
+.B \-header
+switch produces a header line prior to the
+.B scan
listing. Currently, the name of the folder and the current date and
-time are output (see the \fBHISTORY\fR section for more information).
-
-If the `\-clear' switch is used and \fIscan's\fR output is directed
-to a terminal, then \fIscan\fR will consult the environment variables
-\fB$TERM\fR and \fB$TERMCAP\fR to determine your terminal type in order
-to find out how to clear the screen prior to exiting. If the `\-clear'
-switch is used and \fIscan's\fR output is not directed to a terminal
-(e.g., a pipe or a file), then \fIscan\fR will send a formfeed prior
+time are output (see the
+.B HISTORY
+section for more information).
+.PP
+If the
+.B \-clear
+switch is used and
+.BR scan 's
+output is directed
+to a terminal, then
+.B scan
+will consult the environment variables
+.B $TERM
+and
+.B $TERMCAP
+to determine your terminal type in order
+to find out how to clear the screen prior to exiting. If the
+.B \-clear
+switch is used and
+.BR scan 's
+output is not directed to a terminal
+(e.g., a pipe or a file), then
+.B scan
+will send a formfeed prior
to exiting.
-
+.PP
For example, the command:
-
-.ti +.5i
+.PP
+.RS 5
(scan \-clear \-header; show all \-show pr \-f) | lpr
-
+.RE
+.PP
produces a scan listing of the current folder, followed by a formfeed,
followed by a formatted listing of all messages in the folder, one
-per page. Omitting `\-show\ pr\ \-f' will cause the messages to be
+per page. Omitting
+.RB \*(lq "\-show\ pr\ \-f" \*(rq
+will cause the messages to be
concatenated, separated by a one\-line header and two blank lines.
-
-To override the output format used by \fIscan\fR, the `\-format\ string'
-or `\-form\ file' switches are used. This permits individual fields of
+.PP
+To override the output format used by
+.BR scan ,
+the
+.B \-format
+.I string
+or
+.B \-form
+.I file
+switches are used. This permits individual fields of
the scan listing to be extracted with ease. The string is simply a format
-string and the file is simply a format file. See \fImh\-format\fR(5)
+string and the file is simply a format file. See
+.BR mh\-format (5)
for the details.
-
-In addition to the standard \fImh\-format\fR(5) escapes, \fIscan\fR
-also recognizes the following additional \fIcomponent\fR escapes:
-.sp 1
+.PP
+In addition to the standard
+.BR mh\-format (5)
+escapes,
+.B scan
+also recognizes the following additional
+.I component
+escapes:
+.PP
+.RS 5
.nf
.ta \w'Dtimenow 'u +\w'Returns 'u
-\fIEscape\fR \fIReturns\fR \fIDescription\fR
+.I Escape Returns Description
body string the (compressed) first part of the body
dtimenow date the current date
folder string the name of the current folder
-.re
.fi
-
-If no date header is present in the message, the \fIfunction\fR escapes
-which operate on {\fIdate\fP\|} will return values for the date of last
+.RE
+.PP
+If no date header is present in the message, the
+.I function
+escapes
+which operate on
+.RB { date }
+will return values for the date of last
modification of the message file itself. This feature is handy for
-scanning a \fIdraft folder\fR, as message drafts usually aren't allowed
+scanning a draft folder, as message drafts usually aren't allowed
to have dates in them.
+.PP
+.B scan
+will update the
+.B nmh
+context prior to starting the listing,
+so interrupting a long
+.B scan
+listing preserves the new context.
+.B nmh
+purists hate this idea.
-\fIscan\fR will update the \fInmh\fR context prior to starting the listing,
-so interrupting a long \fIscan\fR listing preserves the new context.
-\fInmh\fR purists hate this idea.
-.Fi
+.SH FILES
+.fc ^ ~
+.nf
+.ta \w'/usr/local/nmh/etc/ExtraBigFileName 'u
^$HOME/\&.mh\(ruprofile~^The user profile
-.Pr
+.fi
+
+.SH "PROFILE COMPONENTS"
+.fc ^ ~
+.nf
+.ta 2.4i
+.ta \w'ExtraBigProfileName 'u
^Path:~^To determine the user's nmh directory
-.Ps
^Alternate\-Mailboxes:~^To determine the user's mailboxes
-.Ps
^Current\-Folder:~^To find the default current folder
-.Sa
+.fi
+
+.SH "SEE ALSO"
inc(1), pick(1), show(1), mh\-format(5)
-.De
-`+folder' defaults to the current folder
-.Ds
-`msgs' defaults to all
-.Ds
-`\-format' defaulted as described above
-.Ds
-`\-noheader'
-.Ds
-`\-width' defaulted to the width of the terminal
-.Co
+
+.SH DEFAULTS
+.nf
+.RB ` +folder "' defaults to the current folder"
+.RB ` msgs "' defaults to all"
+.RB ` \-format "' defaulted as described above"
+.RB ` \-noheader '
+.RB ` \-width "' defaulted to the width of the terminal"
+.fi
+
+.SH CONTEXT
If a folder is given, it will become the current folder.
-.Hi
-Prior to using the format string mechanism, `\-header' used to generate
+
+.SH HISTORY
+Prior to using the format string mechanism,
+.B \-header
+used to generate
a heading saying what each column in the listing was. Format strings
prevent this from happening.
-.Bu
-The argument to the `\-format' switch must be interpreted as a single
-token by the shell that invokes \fIscan\fR. Therefore, one must usually
-place the argument to this switch inside double\-quotes.
-The value of each \fIcomponent\fR escape is set by \fIscan\fR to the
-contents of the first message header \fIscan\fR encounters with the
+.SH BUGS
+The argument to the
+.B \-format
+switch must be interpreted as a single
+token by the shell that invokes
+.BR scan .
+Therefore, one must usually
+place the argument to this switch inside double\-quotes.
+.PP
+The value of each
+.I component
+escape is set by
+.B scan
+to the
+contents of the first message header
+.B scan
+encounters with the
corresponding component name; any following headers with the same
component name are ignored.
-.En
.\" %nmhwarning%
.\" $Id$
.\"
-.\" include the -mh macro file
-.so %etcdir%/tmac.h
-.\"
.TH SEND %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
.SH NAME
send \- send a message
.SH SYNOPSIS
-.in +.5i
-.ti -.5i
-send
-\%[\-alias\ aliasfile]
-\%[\-draft]
-\%[\-draftfolder\ +folder]
-.br
-\%[\-draftmessage\ msg] \%[\-nodraftfolder]
-.br
-\%[\-filter\ filterfile] \%[\-nofilter]
-\%[\-format] \%[\-noformat]
-.br
-\%[\-forward] \%[\-noforward]
-\%[\-mime] \%[\-nomime]
-\%[\-msgid]
-.br
-\%[\-nomsgid]
-\%[\-push] \%[\-nopush]
-\%[\-split\ seconds]
-.br
-\%[\-verbose] \%[\-noverbose]
-\%[\-watch] \%[\-nowatch]
-\%[\-sasl] \%[\-saslmech\ mechanism] \%[\-user\ username]
-.br
-\%[\-width\ columns]
-\%[file\ ...]
-\%[\-version]
-\%[\-help]
-.in -.5i
+.HP 5
+.B send
+.RB [ \-alias
+.IR aliasfile ]
+.RB [ \-draft ]
+.RB [ \-draftfolder
+.IR +folder ]
+.RB [ \-draftmessage
+.IR msg ]
+.RB [ \-nodraftfolder ]
+.RB [ \-filter
+.IR filterfile ]
+.RB [ \-nofilter ]
+.RB [ \-format " | " \-noformat ]
+.RB [ \-forward " | " \-noforward ]
+.RB [ \-mime " | " \-nomime ]
+.RB [ \-msgid " | " \-nomsgid ]
+.RB [ \-push " | " \-nopush ]
+.RB [ \-split
+.IR seconds ]
+.RB [ \-verbose " | " \-noverbose ]
+.RB [ \-watch " | " \-nowatch ]
+.RB [ \-sasl ]
+.RB [ \-saslmech
+.IR mechanism ]
+.RB [ \-user
+.IR username ]
+.RB [ \-width
+.IR columns ]
+.RB [ file
+\&...]
+.RB [ \-version ]
+.RB [ \-help ]
.SH DESCRIPTION
-\fISend\fR will cause each of the specified files to be delivered
+.B Send
+will cause each of the specified files to be delivered
to each of the destinations in the \*(lqTo:\*(rq, \*(lqcc:\*(rq,
-\*(lqBcc:\*(rq, and \*(lqFcc:\*(rq fields of the message. If \fIsend\fR
-is re\-distributing a message, as invoked from \fIdist\fR, then the
+\*(lqBcc:\*(rq, and \*(lqFcc:\*(rq fields of the message. If
+.B send
+is re\-distributing a message, as invoked from
+.BR dist ,
+then the
corresponding \*(lqResent\-xxx\*(rq fields are examined instead.
-
-By default, \fIsend\fR uses the program \fIpost\fR(8) to do the actual
+.PP
+By default,
+.B send
+uses the program
+.B post
+to do the actual
delivery of the messages, although this can be changed by defining the
-\fIpostproc\fR profile component. Most of the features attributed to
-\fIsend\fR are actually performed by \fIpost\fR.
-
-If `\-push' is specified, \fIsend\fR will detach itself from the user's
-terminal and perform its actions in the background. If \fIpush\fR\0'd
+.I postproc
+profile component. Most of the features attributed to
+.B send
+are actually performed by
+.BR post .
+.PP
+If
+.B \-push
+is specified,
+.B send
+will detach itself from the user's
+terminal and perform its actions in the background. If
+.BR push 'd
and the draft can't be sent, then an error message will be sent (using
-the mailproc) back to the user. If `\-forward' is given, then a copy
-of the draft will be attached to this failure notice. Using `\-push'
-differs from putting \fIsend\fR in the background because the output is
-trapped and analyzed by \fInmh\fR.
-
-If `\-verbose' is specified, \fIsend\fR will indicate the interactions
+the mailproc) back to the user. If
+.B \-forward
+is given, then a copy
+of the draft will be attached to this failure notice. Using
+.B \-push
+differs from putting
+.B send
+in the background because the output is
+trapped and analyzed by
+.BR nmh .
+.PP
+If
+.B \-verbose
+is specified,
+.B send
+will indicate the interactions
occurring with the transport system, prior to actual delivery.
-If `\-watch' is specified \fIsend\fR will monitor the delivery of local
+If
+.B \-watch
+is specified
+.B send
+will monitor the delivery of local
and network mail. Hence, by specifying both switches, a large detail
of information can be gathered about each step of the message's entry
into the transport system.
-
-The `\-draftfolder\ +folder' and `\-draftmessage\ msg' switches invoke
-the \fInmh\fR draft folder facility. This is an advanced (and highly
-useful) feature. Consult the \fImh-draft\fR(5) man page for more
+.PP
+The
+.B \-draftfolder
+.I +folder
+and
+.B \-draftmessage
+.I msg
+switches invoke
+the
+.B nmh
+draft folder facility. This is an advanced (and highly
+useful) feature. Consult the
+.BR mh-draft (5)
+man page for more
information.
-
-If `\-split' is specified, \fIsend\fR will split the draft into one
+.PP
+If
+.B \-split
+is specified,
+.B send
+will split the draft into one
or more partial messages prior to sending. This makes use of the
-MIME features in nmh. Note however that if \fIsend\fR is
-invoked under \fIdist\fR\0(1), then this switch is ignored\0--\0it makes
+MIME features in
+.BR nmh .
+Note however that if
+.B send
+is
+invoked under
+.BR dist ,
+then this switch is ignored\0--\0it makes
no sense to redistribute a message in this fashion. Sometimes you want
-\fIsend\fR to pause after posting a partial message. This is usually
-the case when you are running \fIsendmail\fR and expect to generate a
-lot of partial messages. The argument to `\-split' tells it how long
+.B send
+to pause after posting a partial message. This is usually
+the case when you are running
+.B sendmail
+and expect to generate a
+lot of partial messages. The argument to
+.B \-split
+tells it how long
to pause between postings.
-
-\fISend\fR with no \fIfile\fR argument will query whether the draft
-is the intended file, whereas `\-draft' will suppress this question.
+.PP
+.B Send
+with no
+.I file
+argument will query whether the draft
+is the intended file, whereas
+.B \-draft
+will suppress this question.
Once the transport system has successfully accepted custody of the
message, the file will be renamed with a leading comma, which allows
it to be retrieved until the next draft message is sent. If there are
-errors in the formatting of the message, \fIsend\fR will abort with a
+errors in the formatting of the message,
+.B send
+will abort with a
(hopefully) helpful error message.
-
+.PP
If a \*(lqBcc:\*(rq field is encountered, its addresses will be used for
delivery, and the \*(lqBcc:\*(rq field will be removed from the message
sent to sighted recipients. The blind recipients will receive an entirely
new message with a minimal set of headers. Included in the body of the
message will be a copy of the message sent to the sighted recipients.
-If `\-filter\ filterfile' is specified, then this copy is filtered
-(re\-formatted) by \fImhl\fR prior to being sent to the blind recipients.
-Alternately, if you specify the `-mime' switch, then \fIsend\fR will
+If
+.B \-filter
+.I filterfile
+is specified, then this copy is filtered
+(re\-formatted) by
+.B mhl
+prior to being sent to the blind recipients.
+Alternately, if you specify the
+.B -mime
+switch, then
+.B send
+will
use the MIME rules for encapsulation.
-
+.PP
Prior to sending the message, the fields \*(lqFrom:\ user@local\*(rq,
and \*(lqDate:\ now\*(rq will be appended to the headers in the message.
-If the environment variable \fB$SIGNATURE\fR is set, then its value
+If the environment variable
+.B $SIGNATURE
+is set, then its value
is used as your personal name when constructing the \*(lqFrom:\*(rq
line of the message. If this environment variable is not set, then
-\fIsend\fR will consult the profile entry \*(lqSignature\*(rq for
-this information. On hosts where \fInmh\fR was configured with the UCI
-option, if \fB$SIGNATURE\fR is not set and the \*(lqSignature\*(rq profile
-entry is not present, then the file \fB$HOME\fR/.signature is consulted.
-If `\-msgid' is specified, then a \*(lqMessage\-ID:\*(rq field will also
+.B send
+will consult the profile entry \*(lqSignature\*(rq for
+this information.
+If
+.B \-msgid
+is specified, then a \*(lqMessage\-ID:\*(rq field will also
be added to the message.
-
-If \fIsend\fR is re\-distributing a message (when invoked by
-\fIdist\fR\0), then \*(lqResent\-\*(rq will be prepended to each of these
+.PP
+If
+.B send
+is re\-distributing a message (when invoked by
+.BR dist ),
+then \*(lqResent\-\*(rq will be prepended to each of these
fields: \*(lqFrom:\*(rq, \*(lqDate:\*(rq, and \*(lqMessage\-ID:\*(rq.
If the message already contains a \*(lqFrom:\*(rq field, then a
\*(lqSender: user@local\*(rq field will be added as well. (An already
existing \*(lqSender:\*(rq field is an error!)
-
-By using the `\-format' switch, each of the entries in the \*(lqTo:\*(rq
+.PP
+By using the
+.B \-format
+switch, each of the entries in the \*(lqTo:\*(rq
and \*(lqcc:\*(rq fields will be replaced with \*(lqstandard\*(rq
format entries. This standard format is designed to be usable by all
of the message handlers on the various systems around the Internet.
-If `\-noformat' is given, then headers are output exactly as they appear
+If
+.B \-noformat
+is given, then headers are output exactly as they appear
in the message draft.
-
+.PP
If an \*(lqFcc:\ folder\*(rq is encountered, the message will be copied
to the specified folder for the sender in the format in which it will
appear to any non\-Bcc receivers of the message. That is, it will have
the appended fields and field reformatting. The \*(lqFcc:\*(rq fields
will be removed from all outgoing copies of the message.
-
-By using the `\-width\ columns' switch, the user can direct \fIsend\fR
+.PP
+By using the
+.B \-width
+.I columns
+switch, the user can direct
+.B send
as to how long it should make header lines containing addresses.
-
-If nmh has been compiled with SASL support, the `\-sasl' switch will enable
+.PP
+If
+.B nmh
+has been compiled with SASL support, the
+.B \-sasl
+switch will enable
the use of SASL authentication with the SMTP MTA. Depending on the
SASL mechanism used, this may require an additional password prompt from the
-user (but the \*(lq.netrc\*(rq file can be used to store this password).
-`\-saslmech' switch can be used to select a particular SASL mechanism,
-and the the `\-user' switch can be used to select a authorization userid
+user (but the
+.RI \*(lq \&.netrc \*(rq
+file can be used to store this password).
+.B \-saslmech
+switch can be used to select a particular SASL mechanism,
+and the the
+.B \-user
+switch can be used to select a authorization userid
to provide to SASL other than the default.
-
-Currently SASL security layers are not supported for SMTP. nmh's SMTP SASL code
+.PP
+Currently SASL security layers are not supported for SMTP.
+.BR nmh 's
+SMTP SASL code
will always negotiate an unencrypted connection. This means that while the SMTP
authentication can be encrypted, the subsequent data stream can not. This is in
-contrast to nmh's POP3 SASL support, where encryption is supported for both the
+contrast to
+.BR nmh 's
+POP3 SASL support, where encryption is supported for both the
authentication and the data stream.
-
+.PP
The files specified by the profile entry \*(lqAliasfile:\*(rq and any
-additional alias files given by the `\-alias aliasfile' switch will be
-read (more than one file, each preceded by `\-alias', can be named).
-See \fImh\-alias\fR\0(5) for more information.
-.Fi
+additional alias files given by the
+.B \-alias
+.I aliasfile
+switch will be
+read (more than one file, each preceded by
+.BR \-alias ,
+can be named).
+See
+.BR mh\-alias (5)
+for more information.
+
+.SH FILES
+.fc ^ ~
+.nf
+.ta \w'/usr/local/nmh/etc/ExtraBigFileName 'u
^$HOME/\&.mh\(ruprofile~^The user profile
-.Pr
+.fi
+
+.SH "PROFILE COMPONENTS"
+.fc ^ ~
+.nf
+.ta 2.4i
+.ta \w'ExtraBigProfileName 'u
^Path:~^To determine the user's nmh directory
-.Ps
^Draft\-Folder:~^To find the default draft\-folder
-.Ps
^Aliasfile:~^For a default alias file
-.Ps
^Signature:~^To determine the user's mail signature
-.Ps
^mailproc:~^Program to post failure notices
-.Ps
^postproc:~^Program to post the message
-.Sa
+.fi
+
+.SH "SEE ALSO"
comp(1), dist(1), forw(1), repl(1), mh\-alias(5), post(8)
-.De
-`file' defaults to <mh\-dir>/draft
-.Ds
-`\-alias %etcdir%/MailAliases'
-.Ds
-`\-nodraftfolder'
-.Ds
-`\-nofilter'
-.Ds
-`\-format'
-.Ds
-`\-forward'
-.Ds
-`\-nomime'
-.Ds
-`\-nomsgid'
-.Ds
-`\-nopush'
-.Ds
-`\-noverbose'
-.Ds
-`\-nowatch'
-.Ds
-`\-width\ 72'
-.Co
+
+.SH DEFAULTS
+.nf
+.RB ` file "' defaults to <mh\-dir>/draft"
+.RB ` \-alias "' defaults to %etcdir%/MailAliases"
+.RB ` \-nodraftfolder '
+.RB ` \-nofilter '
+.RB ` \-format '
+.RB ` \-forward '
+.RB ` \-nomime '
+.RB ` \-nomsgid '
+.RB ` \-nopush '
+.RB ` \-noverbose '
+.RB ` \-nowatch '
+.RB ` "\-width\ 72" '
+.fi
+
+.SH CONTEXT
None
-.Bu
+
+.SH BUGS
Under some configurations, it is not possible to monitor the mail delivery
-transaction; `\-watch' is a no-op on those systems.
-.sp
-Using `\-split\00' doesn't work correctly.
-.En
+transaction;
+.B \-watch
+is a no-op on those systems.
+.PP
+Using
+.B \-split
+.I 0
+doesn't work correctly.
.\" %nmhwarning%
.\" $Id$
.\"
-.\" include the -mh macro file
-.so %etcdir%/tmac.h
-.\"
.TH SENDFILES %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
.SH NAME
sendfiles \- send multiple files via a MIME message
.SH SYNOPSIS
-.in +.5i
-.ti -.5i
-sendfiles \%[delay] mailpath subject file1 \%[file2]...
-.in -.5i
-
+.HP
+.B sendfiles
+.RB [ delay ]
+.I mailpath
+.I subject
+.I file1
+.RI [ file2
+\&...]
.SH DESCRIPTION
-The shell script \fIsendfiles\fR, is used to send a collection
+The shell script
+.BR sendfiles ,
+is used to send a collection
of files and directories via electronic mail.
-.sp
-.in +.5i
+.PP
+.RS 5
sendfiles mailpath \*(lqsubject\*(rq files\0...
-.in -.5i
-.sp
-\fIsendfiles\fR will archive the files and directories you name
-with the \fItar\fR\0(1) command, and then mail the compressed
-archive to the `mailpath' with the given `subject'. The archive
+.RE
+.PP
+.B Isendfiles
+will archive the files and directories you name
+with the
+.B tar
+command, and then mail the compressed
+archive to the \*(lqmailpath\*(rq with the given \*(lqsubject\*(rq.
+The archive
will be automatically split up into as many messages as necessary
in order to get past most mailers.
-
-Sometimes you want \fIsendfiles\fR to pause after posting a partial
-message. This is usually the case when you are running \fIsendmail\fR
+.PP
+Sometimes you want
+.B sendfiles
+to pause after posting a partial
+message. This is usually the case when you are running
+.B sendmail
and expect to generate a lot of partial messages. If the first
-argument given to \fIsendfiles\fR starts with a dash, then it is
+argument given to
+.B sendfiles
+starts with a dash, then it is
interpreted as the number of seconds to pause in between postings,
-.ne 6
e.g.,
-.sp
-.in +.5i
+.PP
+.RS 5
sendfiles -30 mailpath \*(lqsubject\*(rq files\0...
-.in -.5i
-.sp
+.RE
+.PP
will pause 30 seconds in between each posting.
-
-.Uh "Extracting the Received Files"
-When these messages are received, invoke \fImhstore\fR once for
-the list of messages. The default is for \fImhstore\fR to store
+.PP
+.SS "Extracting the Received Files"
+When these messages are received, invoke
+.B mhstore
+once for
+the list of messages. The default is for
+.B mhstore
+to store
the combined parts as a new message in the current folder, although
this can be changed using storage formatting strings. You can then
-use \fImhlist\fR to find out what's inside; possibly followed by
-\fImhstore\fR again to write the archive to a file where you can
+use
+.B mhlist
+to find out what's inside; possibly followed by
+.B mhstore
+again to write the archive to a file where you can
subsequently uncompress and untar it. For instance:
-.sp
+.PP
+.RS 5
.nf
-.in +.5i
% mhlist 5-8
msg part type/subtype size description
5 message/partial 47K part 1 of 4
conversions=compress
% mhstore 9
% uncompress < 9.tar.Z | tar xvpf -
-.in -.5i
.fi
-.sp
-Alternately, by using the `\-auto' switch, \fImhstore\fR will
-automatically do the extraction for you:
-.sp
+.RE
+.PP
+Alternately, by using the
+.B \-auto
+switch,
+.B mhstore
+will automatically do the extraction for you:
+.PP
+.RS 5
.nf
-.in +.5i
% mhlist 5-8
msg part type/subtype size description
5 message/partial 47K part 1 of 4
type=tar
conversions=compress
% mhstore -auto 9
--- \fItar\fR listing appears here as files are extracted
-.in -.5i
+-- tar listing appears here as files are extracted
.fi
-.sp
-As the second \fItar\fR listing is generated, the files are extracted.
-A prudent user will never put `\-auto' in the \&.mh\(ruprofile
-file. The correct procedure is to first use \fImhlist\fR to find
-out what will be extracted. Then \fImhstore\fR can be invoked with
-`\-auto' to perform the extraction.
-.Fi
+.RE
+.PP
+As the second
+.B tar
+listing is generated, the files are extracted.
+A prudent user will never put
+.B \-auto
+in the
+.I \&.mh\(ruprofile
+file. The correct procedure is to first use
+.B mhlist
+to find out what will be extracted. Then
+.B mhstore
+can be invoked with
+.B \-auto
+to perform the extraction.
+
+.SH FILES
+.fc ^ ~
+.nf
+.ta \w'/usr/local/nmh/etc/ExtraBigFileName 'u
^$HOME/\&.mh\(ruprofile~^The user profile
-.Pr
+.fi
+
+.SH "PROFILE COMPONENTS"
+.fc ^ ~
+.nf
+.ta 2.4i
+.ta \w'ExtraBigProfileName 'u
^Path:~^To determine the user's nmh directory
-.Ps
^Current\-Folder:~^To find the default current folder
-.Sa
-mhbuild(1), mhlist(1), mhshow(1), mhstore(1)
-.br
-RFC\-934:
-.br
- \fIProposed Standard for Message Encapsulation\fR,
-.br
-RFC\-2045:
-.br
- \fIMultipurpose Internet Mail Extensions (MIME) Part One:
-.br
- Format of Internet Message Bodies\fR,
-.br
-RFC\-2046:
-.br
- \fIMultipurpose Internet Mail Extensions (MIME) Part Two:
-.br
- Media Types\fR,
-.br
-RFC\-2047:
-.br
- \fIMultipurpose Internet Mail Extensions (MIME) Part Three:
-.br
- Message Header Extensions for Non-ASCII Text\fR,
-.br
-RFC\-2048:
-.br
- \fIMultipurpose Internet Mail Extensions (MIME) Part Four:
-.br
- Registration Procedures\fR,
-.br
-RFC\-2049:
-.br
- \fIMultipurpose Internet Mail Extensions (MIME) Part Five:
-.br
- Conformance Criteria and Examples\fR.
-.De
-`\-noverbose'
-.Co
-None.
-.En
+.fi
+
+.SH "SEE ALSO"
+mhbuild(1), mhlist(1), mhshow(1), mhstore(1).
+.I "Proposed Standard for Message Encapsulation"
+(RFC\-934)
+
+.SH DEFAULTS
+.nf
+.RB ` \-noverbose '
+.fi
+
+.SH CONTEXT
+None
projects / mmh / commitdiff