.SH DESCRIPTION
.B ap
is a program that parses addresses according to the ARPA
-Internet standard. It also understands many non\-standard formats.
+Internet standard. It also understands many non-standard formats.
It is useful for seeing how
.B nmh
will interpret an address.
It turns out that
.B burst
works equally well on forwarded messages
-and blind\-carbon\-copies as on Internet digests, provided
+and blind-carbon-copies as on Internet digests, provided
that the former were generated by
.B forw
or
.BR nmh .
It implies
.BR \-nowhatnowproc .
-It causes a file <mh\-dir>/draft to be created, containing the draft message that
+It causes a file <mh-dir>/draft to be created, containing the draft message that
would normally be presented to the user for editing.
No mail is actually sent.
.SH FILES
%nmhetcdir%/components
The default message skeleton.
.TP
-<mh\-dir>/components
+<mh-dir>/components
The user's message skeleton.
.TP
$HOME/.mh_profile
To determine the user's nmh directory.
.TP
Draft\-Folder:
-To find the default draft\-folder.
+To find the default draft-folder.
.TP
Editor:
To override the default editor.
.BR whatnow ,
then
.B comp
-uses a built\-in
+uses a built-in
.BR whatnow ,
it does not actually run the
.B whatnow
.BR dist ,
.RB \*(lq comp
.BR \-use \*(rq
-may be used to re\-edit and send the constructed
+may be used to re-edit and send the constructed
message, but the annotations won't take place. Normally annotations are
done in place in order to preserve any links to the message. You may use
the
%nmhetcdir%/distcomps
The default message skeleton.
.TP 20
-<mh\-dir>/distcomps
+<mh-dir>/distcomps
The user's message skeleton.
.TP 20
$HOME/.mh_profile
The user's profile.
.TP 20
-<mh\-dir>/draft
+<mh-dir>/draft
The draft file.
.PD
.SH "PROFILE COMPONENTS"
To find the default current folder.
.TP 20
Draft\-Folder:
-To find the default draft\-folder.
+To find the default draft-folder.
.TP 20
Editor:
To override the default editor.
.BR whatnow ,
then
.B comp
-uses a built\-in
+uses a built-in
.BR whatnow ,
it does not actually run the
.B whatnow
.SH DESCRIPTION
.B dp
is a program that parses dates according to the ARPA Internet standard.
-It also understands many non\-standard formats,
+It also understands many non-standard formats,
such as those produced by TOPS\-20 sites and some Unix sites using
.IR ctime (3).
It is useful for seeing how
.B flist
will search all the folders in the top
level of the users nmh directory. These folders are all preceded by
-the read\-only folders, which occur as
+the read-only folders, which occur as
.RI \*(lq atr\-cur\- \*(rq
entries in the user's
.B nmh
.B folder
to push the current folder
onto the
-.IR folder\-stack ,
+.IR folder-stack ,
and make the
.I +folder
argument the current folder. If
.I +folder
is not given, the current folder and the
top of the
-.I folder\-stack
+.I folder-stack
are exchanged. This corresponds to the
\*(lqpushd\*(rq operation in the shell.
.PP
switch directs
.B folder
to discard the top of the
-.IR folder\-stack ,
+.IR folder-stack ,
after setting the current folder to that value.
No
.I +folder
switch directs
.B folder
to list the
-.IR folder\-stack .
+.IR folder-stack .
No
.I +folder
argument is allowed. After a successful
.BR nmh .
It implies
.BR \-nowhatnowproc .
-It causes a file <mh\-dir>/draft
+It causes a file <mh-dir>/draft
to be created, containing the draft message that would normally be
presented to the user for editing. No mail is actually sent.
.PP
%nmhetcdir%/forwcomps
The default message skeleton.
.TP
-<mh\-dir>/forwcomps
+<mh-dir>/forwcomps
The user's message skeleton.
.TP
%nmhetcdir%/digestcomps
.B \-digest
is given.
.TP
-<mh\-dir>/digestcomps
+<mh-dir>/digestcomps
The user's
.B \-digest
skeleton.
^%nmhetcdir%/mhl.forward
The default message filter.
.TP
-<mh\-dir>/mhl.forward
+<mh-dir>/mhl.forward
The user's message filter.
.TP
^$HOME/.mh_profile
To find the default current folder.
.TP
Draft\-Folder:
-To find the default draft\-folder.
+To find the default draft-folder.
.TP
Editor:
To override the default editor.
.RB [ \-version ]
.RI [ +folder ]
.RB [ \-audit
-.IR audit\-file ]
+.IR audit-file ]
.RB [ \-noaudit ]
.RB [ \-changecur " | " \-nochangecur ]
.RB [ \-form
.PP
If the switch
.B \-audit
-.I audit\-file
+.I audit-file
is specified (usually as a default switch in the user's profile), then
.B inc
will append a header line and a line per message to the specified
may also output audit information to this (or another) file, perhaps with
.RI \*(lq Message\-Id \*(rq
information to keep an exact correspondence history.
-.RI \*(lq Audit\-file \*(rq
+.RI \*(lq Audit-file \*(rq
is assumed to be in the user's nmh directory unless a full path is specified.
.PP
.B inc
The
.B mark
command manipulates message sequences by adding or deleting
-message numbers from folder\-specific message sequences, or by listing
+message numbers from folder-specific message sequences, or by listing
those sequences and messages.
.PP
A message sequence is a keyword, just like one of the \*(lqreserved\*(rq
message names, such as \*(lqfirst\*(rq or \*(lqnext\*(rq. Unlike the
\*(lqreserved\*(rq message names, which have a fixed semantics on
-a per\-folder basis, the semantics of a message sequence may be
+a per-folder basis, the semantics of a message sequence may be
defined, modified, and removed by the user. Message sequences are
-folder\-specific, e.g., the sequence name \*(lqseen\*(rq in the context
+folder-specific, e.g., the sequence name \*(lqseen\*(rq in the context
of folder
.RI \*(lq +inbox \*(rq
need not have any relation whatsoever to the
\*(lqlast\*(rq, \*(lqall\*(rq, \*(lqnext\*(rq, or \*(lqprev\*(rq.
.PP
.IP \(bu 2
-Message ranges with user\-defined sequence names are restricted to the
+Message ranges with user-defined sequence names are restricted to the
form \*(lqname:n\*(rq, \*(lqname:+n\*(rq, or \*(lqname:-n\*(rq, and refer
to the first or last `n' messages of the sequence `name', respectively.
Constructs of the form \*(lqname1\-name2\*(rq are forbidden for user
.RS 5
.I alias
.B :
-.I address\-group
+.I address-group
.RE
.sp
.RS 5
.I alias
.B ;
-.I address\-group
+.I address-group
.RE
.sp
.RS 5
.B <
-.I alias\-file
+.I alias-file
.RE
.sp
.RS 5
.PP
.RS 5
.nf
-.IR address\-group " := " address\-list
+.IR address-group " := " address-list
.RI " | < " file
-.RI " | = " Unix\-group
-.RI " | + " Unix\-group
+.RI " | = " Unix-group
+.RI " | + " Unix-group
-.IR address\-list " := " address
-.RI " | " address\-list ", " address
+.IR address-list " := " address
+.RI " | " address-list ", " address
.fi
.RE
.PP
Continuation lines end with \*(lq\\\*(rq followed by a newline
character. This also applies to comment lines. Thus, the line following a
-\*(lq\\\*(rq\-terminated
+\*(lq\\\*(rq-terminated
comment line is a continuation of
that comment line.
.PP
-.I Alias\-file
+.I Alias-file
and
.I file
are Unix file names.
-.I Unix\-group
+.I Unix-group
is a group name or number from
the system's group database.
Alias file contents are case-insensitive, with the exception
\*(lq<\*(rq may occur in the beginning of an alias file with the expected results.
.PP
If the
-.I address\-group
+.I address-group
starts with a \*(lq<\*(rq, the file named after the
\*(lq<\*(rq is read and its contents are added to the
-.I address\-list
+.I address-list
for the alias.
.PP
If the
-.I address\-group
+.I address-group
starts with an \*(lq=\*(rq, the
system's group database
-is consulted for the Unix\-group named after the \*(lq=\*(rq. Each login name
+is consulted for the Unix-group named after the \*(lq=\*(rq. Each login name
occurring as a member of the group is added to the
-.I address\-list
+.I address-list
for the alias.
.PP
In contrast, if the
-.I address\-group
+.I address-group
starts with a \*(lq+\*(rq, the system's group database
-is consulted to determine the group\-id of the
-Unix\-group named after the \*(lq+\*(rq. Each login name occurring in the
+is consulted to determine the group-id of the
+Unix-group named after the \*(lq+\*(rq. Each login name occurring in the
system's password database
-whose group\-id is indicated by this group is
+whose group-id is indicated by this group is
added to the
-.I address\-list
+.I address-list
for the alias.
.PP
In match, a trailing \*(lq*\*(rq on an alias will match just about anything
.IP 3)
For each line in the alias file, compare \*(lqalias\*(rq against all of
the existing addresses. If a match, remove the matched \*(lqalias\*(rq
-from the address list, and add each new address in the address\-group to
+from the address list, and add each new address in the address-group to
the address list if it is not already on the list. The alias itself is
-not usually output, rather the address\-group that the alias maps to is
+not usually output, rather the address-group that the alias maps to is
output instead. If \*(lqalias\*(rq is terminated with a \*(lq;\*(rq instead of
a \*(lq:\*(rq, then both the \*(lqalias\*(rq and the address are output in the
correct format (with the alias quoted if necessary and the address
\*(lqstaff\*(rq is defined as all users who are listed as members of the
group \*(lqstaff\*(rq in the
system's group database, and \*(lqwheels\*(rq
-is defined as all users whose group\-id in
+is defined as all users whose group-id in
the system's password database
is equivalent to the \*(lqwheel\*(rq group.
.PP
Although the forward-referencing semantics of
mh\-alias
files prevent recursion, the
-.B alias\-file
+.B alias-file
directive may defeat this.
Since the number of file descriptors is finite, such
infinite recursion will terminate with a meaningless diagnostic when
.SH FILES
.PD 0
.TP 20
-<mh\-dir>/context
+<mh-dir>/context
The user's context.
.TP 20
$MHCONTEXT
.PP
(Extra white space is shown here only for clarity.)
These constructs, which may be nested without ambiguity, form a general
-.B if\-elseif\-else\-endif
+.B if-elseif-else-endif
block where only one of the format-texts is interpreted. In other
words, `%<' is like the "if", `%?' is like the "elseif", `%|' is like
"else", and `%>' is like "endif".
.PP
It should be noted here that the side effects of function and component
escapes are still in force and, as a result, each component test in the
-.B if\-elseif\-else\-endif
+.B if-elseif-else-endif
clause sets the
.I str
register.
family of programs. Each entry in the file is of the format
.PP
.RS 5
-.IR profile\-component ": " value
+.IR profile-component ": " value
.RE
.PP
If the text of a profile entry is long, you may extend it across several
See the
.B HISTORY
section below.
-(profile, default: <nmh\-dir>/context)
+(profile, default: <nmh-dir>/context)
.RE
.PP
.BR Current\-Folder :
172\0178\-181\0212
.RS 5
Keeps track of the private sequence called \*(lqseq\*(rq in the specified
-folder. Private sequences are generally used for read\-only folders.
+folder. Private sequences are generally used for read-only folders.
See the
.IR mh\-sequence (5)
man page for details about private sequences.
$HOME/.mh\-profile
The user's profile.
.TP
-<mh\-dir>/context
+<mh-dir>/context
The user's context
.TP
<folder>/.mh\-sequences
.B \-public
and
.BR \-private .
-But if the folder is read\-only, or if
+But if the folder is read-only, or if
the \*(lqmh\-sequences\*(rq profile entry is defined but empty, then
\fIprivate\fR sequences will be created instead.
.SS "Sequence Negation"
commands that modify the sequence file use transactional locks; the lock
is held from the time the sequence file is read until it it written out.
This ensures that modifications to the sequence file will not be lost
-if multiple commands are run simultaneously. Long\-running
+if multiple commands are run simultaneously. Long-running
.B nmh
commands, such as
.B inc
$HOME/.mh\-profile
The user's profile.
.TP 20
-<mh\-dir>/context
+<mh-dir>/context
The user's context.
.TP 20
<folder>/.mh\-sequences
.RB [ \-disposition " | " \-nodisposition ]
.RB [ \-check " | " \-nocheck ]
.RB [ \-headerencoding
-.IR encoding\-algorithm
+.IR encoding-algorithm
.RB " | " \-autoheaderencoding ]
.RB [ \-maxunencoded
-.IR line\-length ]
+.IR line-length ]
.RB [ \-dist ]
.ad
.SH DESCRIPTION
.PP
A minimum \*(lqexternal\-type\*(rq directive for the
.B url
-.I access\-type
+.I access-type
would be as follows:
.PP
.RS 3
nocomponent flag don't output \*(lqcomponent: \*(rq for this
component
center flag center component on line (works for
- one\-line components only)
+ one-line components only)
nocenter flag don't center
leftadjust flag strip off leading whitespace on each
line of text
.PP
specifies a list of components which are never output.
.PP
-The component \*(lqMessageName\*(rq (case\-insensitive) will output the
+The component \*(lqMessageName\*(rq (case-insensitive) will output the
actual message name (file name) preceded by the folder name if one is
specified or found in the environment. The format is identical to that
produced by the
.nf
.ta \w'%nmhetcdir%/ExtraBigFileName 'u
^%nmhetcdir%/mhl.format~^The message template
-^or <mh\-dir>/mhl.format~^Rather than the standard template
+^or <mh-dir>/mhl.format~^Rather than the standard template
^$HOME/.mh_profile~^The user profile
.fi
.SH "PROFILE COMPONENTS"
.nf
.ta 2.4i
.ta \w'ExtraBigProfileName 'u
-^moreproc:~^Program to use as interactive front\-end
+^moreproc:~^Program to use as interactive front-end
^formatproc:~^Program to use as a filter for components that
^^have the \*(lqformat\*(rq flag set.
.fi
None
.SH BUGS
There should be some way to pass `bell' and `clear' information to the
-front\-end.
+front-end.
.PP
The \*(lqnonewline\*(rq option interacts badly with \*(lqcompress\*(rq
and \*(lqsplit\*(rq.
The program should terminate with an exit status of zero if the
retrieval is successful, and a non-zero exit status otherwise.
.PP
-For the \*(lqurl\*(rq access\-type,
+For the \*(lqurl\*(rq access-type,
.B mhshow
will look for the \*(lqnmh-access-url\*(rq profile entry. See
.IR mhstore (1)
to determine the program to use to perform the HTTP retrieval. This program
is invoked with one argument: the URL of the content to retrieve. The program
should write the content to standard out, and should terminate with a status
-of zero if the retrieval is successful and a non\-zero exit status otherwise.
+of zero if the retrieval is successful and a non-zero exit status otherwise.
.SS "The Content Cache"
When
.B mhstore
to never report the status of
mail drops. This is useful if the user wishes to check
.BR msgchk 's
-exit status. A non\-zero exit status indicates that mail was
+exit status. A non-zero exit status indicates that mail was
.B not
waiting for at least one of the indicated users.
.PP
your link will act like
.B show
instead. To circumvent this, add a
-profile\-entry for the link to your
+profile-entry for the link to your
.B nmh
profile and add the argument
.I next
.B whatnow
command.
.B whatnow
-also supports easy\-to\-use management of MIME attachments via
+also supports easy-to-use management of MIME attachments via
its
.B attach
and related responses, as described in its man page.
your link will act like
.B show
instead. To circumvent this, add a
-profile\-entry for the link to your
+profile-entry for the link to your
.B nmh
profile and add the argument
.B prev
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.)
+.\" the draft file name and the replied-to message file name.)
.SH FILES
.fc ^ ~
.nf
.nf
.ta \w'%nmhetcdir%/ExtraBigFileName 'u
^%nmhetcdir%/rcvdistcomps~^Default message skeleton
-^or <mh\-dir>/rcvdistcomps~^User's message skeleton
+^or <mh-dir>/rcvdistcomps~^User's message skeleton
^%nmhetcdir%/mts.conf~^nmh mts configuration file
^%nmhetcdir%/maildelivery~^Default delivery file
^$HOME/.maildelivery~^User's delivery file
.B \-draft
switch tells
.B refile
-to file the <mh\-dir>/draft.
+to file the <mh-dir>/draft.
.SH FILES
.fc ^ ~
.nf
It implies
.BR \-nowhatnowproc .
It causes a file
-.I <mh\-dir>/reply
+.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.
.nf
.ta \w'%nmhetcdir%/ExtraBigFileName 'u
^%nmhetcdir%/replcomps~^The standard reply template
-^or <mh\-dir>/replcomps~^Rather than the standard template
+^or <mh-dir>/replcomps~^Rather than the standard template
^%nmhetcdir%/replgroupcomps~^The standard `reply -group' template
-^or <mh\-dir>/replgroupcomps~^Rather than the standard template
+^or <mh-dir>/replgroupcomps~^Rather than the standard template
^%nmhetcdir%/mhl.reply~^The standard message filter
-^or <mh\-dir>/mhl.reply~^Rather than the standard filter
+^or <mh-dir>/mhl.reply~^Rather than the standard filter
^$HOME/.mh_profile~^The user profile
-^<mh\-dir>/draft~^The draft file
+^<mh-dir>/draft~^The draft file
.fi
.SH "PROFILE COMPONENTS"
.fc ^ ~
^Path:~^To determine the user's nmh directory
^Alternate\-Mailboxes:~^To determine the user's mailboxes
^Current\-Folder:~^To find the default current folder
-^Draft\-Folder:~^To find the default draft\-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 message being replied\-to
+^mhlproc:~^Program to filter message being replied-to
^whatnowproc:~^Program to ask the \*(lqWhat now?\*(rq questions
.fi
.SH "SEE ALSO"
.ad
.SH DESCRIPTION
.B scan
-produces a one\-line\-per\-message listing of the specified
+produces a one-line-per-message listing of the specified
folder or messages. Each
.B scan
line contains the message number
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.
+concatenated, separated by a one-line header and two blank lines.
.PP
To override the output format used by
.BR scan ,
to each of the destinations in the \*(lqTo:\*(rq, \*(lqcc:\*(rq,
\*(lqBcc:\*(rq, \*(lqDcc:\*(rq, and \*(lqFcc:\*(rq fields of the message. If
.B send
-is re\-distributing a message, as invoked from
+is re-distributing a message, as invoked from
.BR dist ,
then the
corresponding \*(lqResent\-xxx\*(rq fields are examined instead.
.B \-filter
.I filterfile
is specified, then this copy is filtered
-(re\-formatted) by
+(re-formatted) by
.B mhl
prior to being sent to the blind recipients.
Alternately, if you specify the
.PP
If
.B send
-is re\-distributing a message (when invoked by
+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.
field, the \*(lqEnvelope\-From:\*(rq field will be used to construct
a \*(lqSender:\*(rq field.
.PP
-When using SMTP for mail submission, the envelope\-from used for the SMTP
+When using SMTP for mail submission, the envelope-from used for the SMTP
transaction is derived from the \*(lqEnvelope\-From:\*(rq field.
If no \*(lqEnvelope\-From:\*(rq field is present, the \*(lqSender:\*(rq
field is used. If neither the \*(lqEnvelope\-From:\*(rq nor the
.ta 2.4i
.ta \w'ExtraBigProfileName 'u
^Path:~^To determine the user's nmh directory
-^Draft\-Folder:~^To find the default draft\-folder
+^Draft\-Folder:~^To find the default draft-folder
^Aliasfile:~^For a default alias file
^Signature:~^To determine the user's mail signature
^mailproc:~^Program to post failure notices
.IR post (8)
.SH DEFAULTS
.nf
-.RB ` file "' defaults to <mh\-dir>/draft"
+.RB ` file "' defaults to <mh-dir>/draft"
.RB ` \-alias "' defaults to %nmhetcdir%/MailAliases"
.RB ` \-nodraftfolder '
.RB ` \-nofilter '
.B \-header
switch tells
.B show
-to display a one\-line
+to display a one-line
description of the message being shown. This description includes
the folder and the message number.
.PP
<SPACE> will print the next screenful.
.PP
If the standard output is not a terminal, no queries are made, and
-each file is listed with a one\-line header and two lines of
+each file is listed with a one-line header and two lines of
separation.
.PP
.RB \*(lq "show \-draft" \*(rq
-will list the file <mh\-dir>/draft if it
+will list the file <mh-dir>/draft if it
exists.
.PP
If the profile entry \*(lqUnseen\-Sequence\*(rq is present and
-non\-empty, then
+non-empty, then
.B show
will remove each of the messages shown
from each sequence named by the profile entry.
(the default), then
.B show
uses
-a built\-in
+a built-in
.BR mhl :
it does not actually run the
.B mhl
Due to a bug in
.BR more ,
show will go into a \*(lqtty input\*(rq state.
-To avoid this problem, re\-direct
+To avoid this problem, re-direct
.BR show 's
diagnostic output as well.
For users of
.B sortm
to sort messages by the specified text field. All characters except
letters and numbers are stripped and the resulting strings are sorted
-datefield\-major, textfield\-minor, using a case insensitive
+datefield-major, textfield-minor, using a case insensitive
comparison. If this field is \*(lqsubject\*(rq, any leading "re:" is
stripped off.
.PP
With
.B \-limit
.IR 0 ,
-the sort is instead simply textfield\-major.
+the sort is instead simply textfield-major.
.PP
For example, to order a folder by date-major, grouping messages with
the same subject on the same date together, use:
.RS 5
.TP \w'refilezzzzfolderz'u
.B edit
-re\-edit using the same editor that was used on the
+re-edit using the same editor that was used on the
preceding round unless a profile entry
\*(lq<lasteditor>\-next: <editor>\*(rq names an alternate editor
.TP \w'refilezzzzfolderz'u
by default)
.TP \w'refilezzzzfolderz'u
.B display
-list the message being distributed/replied\-to
+list the message being distributed/replied-to
on the terminal
.TP \w'refilezzzzfolderz'u
.B list
responses, any valid argument to
the
.I lproc
-is valid. If any non\-switch arguments are present, then
+is valid. If any non-switch arguments are present, then
the pathname of the draft will be excluded from the argument list given
to the
.I lproc
.nf
.ta \w'%nmhetcdir%/ExtraBigFileName 'u
^$HOME/.mh_profile~^The user profile
-^<mh\-dir>/draft~^The draft file
+^<mh-dir>/draft~^The draft file
.fi
.SH "PROFILE COMPONENTS"
.fc ^ ~
.ta 2.4i
.ta \w'ExtraBigProfileName 'u
^Path:~^To determine the user's nmh directory
-^Draft\-Folder:~^To find the default draft\-folder
+^Draft\-Folder:~^To find the default draft-folder
^Editor:~^To override the default editor
^<lasteditor>\-next:~^To name an editor to be used after exit
^~^from <lasteditor>
.BR forw ,
and
.B repl
-use a built\-in
+use a built-in
.BR whatnow ,
and do not actually run the
.B whatnow
.BR send ,
then
.B whatnow
-uses a built\-in
+uses a built-in
.BR send ,
it does not actually run the
.B send
.ta 2.4i
.ta \w'ExtraBigProfileName 'u
^Path:~^To determine the user's nmh directory
-^Draft\-Folder:~^To find the default draft\-folder
+^Draft\-Folder:~^To find the default draft-folder
^Aliasfile:~^For a default alias file
^postproc:~^Program to post the message
.fi
.IR post (8)
.SH DEFAULTS
.nf
-.RB ` file "' defaults to <mh\-dir>/draft"
+.RB ` file "' defaults to <mh-dir>/draft"
.RB ` \-nocheck '
.RB ` \-alias "' defaults to %nmhetcdir%/MailAliases"
.fi
projects / nmh / commitdiff