X-Git-Url: http://git.marmaro.de/?p=mmh;a=blobdiff_plain;f=man%2Fmh-sequence.man7;h=0ad2c4a4e73ba4e0c4326035d53720b00d95a4d0;hp=516b8afd67ca368936b3b305deee57f88004c756;hb=18591f8e001ecedbee48a51c1d1f08ebaa1c15c8;hpb=1ba1ca6484d35f40b87d515302ea76e7b7b01f32 diff --git a/man/mh-sequence.man7 b/man/mh-sequence.man7 index 516b8af..0ad2c4a 100644 --- a/man/mh-sequence.man7 +++ b/man/mh-sequence.man7 @@ -3,22 +3,18 @@ .\" .TH MH-SEQUENCE %manext7% "%nmhdate%" MH.6.8 [%nmhversion%] .SH NAME -mh-sequence \- sequence specification for nmh message system -.SH SYNOPSIS -most -.B nmh -commands +mh-sequence \- sequence specification for mh message system .SH DESCRIPTION A sequence (or sequence set) is a symbolic name representing a message or collection of messages. -.B nmh +.B mmh has several internally defined sequences, as well as allowing users to define their own sequences. .SS "Message Specification and Pre\-Defined Message Sequences" Most -.B nmh +.B mmh commands accept a `msg' or `msgs' specification, where `msg' indicates one message and `msgs' indicates one or more messages. To designate a message, you may use either its number (e.g., 1, 10, 234) @@ -97,10 +93,10 @@ b the next message number beyond `l' .SS "User\-Defined Message Sequences" In addition to the `reserved' (pre-defined) message names given above, -.B nmh +.B mmh supports user-defined sequence names. User-defined sequences allow the -.B nmh +.B mmh user a tremendous amount of power in dealing with groups of messages in the same folder by allowing the user to bind a group of messages to a meaningful symbolic name. @@ -109,7 +105,7 @@ The name used to denote a message sequence must consist of an alphabetic character followed by zero or more alphanumeric characters, and can not be one of the `reserved' message names above. After defining a sequence, it can be used wherever an -.B nmh +.B mmh command expects a `msg' or `msgs' argument. .PP @@ -137,17 +133,17 @@ commands. .SS "Public and Private User-Defined Sequences" There are two varieties of user-defined sequences: public and private. Public sequences of a folder are accessible to any -.B nmh +.B mmh user that can read that folder. They are kept in each folder in the file determined by the `Mh\-Sequences' profile entry (default is .IR \&.mh_sequences ). Private sequences are accessible only to the -.B nmh +.B mmh user that defined those sequences and are kept in the user's -.B nmh +.B mh context file. .PP In general, the commands that create sequences (such as @@ -156,7 +152,7 @@ and .BR mark ) will create public sequences if the folder for which the sequences are being defined is writable by the -.B nmh +.B mmh user. For most commands, this can be overridden by using the switches .B \-public @@ -167,7 +163,7 @@ the `Mh\-Sequences' profile entry is defined but empty, then \fIprivate\fR sequences will be created instead. .SS "Sequence Negation" -.B Nmh +.B Mmh provides the ability to select all messages .B not elements of a user-defined sequence. @@ -177,7 +173,7 @@ messages not elements of the specified sequence name. The default negation prefix is the exlamation mark `!', but it may be change to any string, by defining the entry `Sequence\-Negation' in the -.B nmh +.B mmh profile file. For example, if the profile entry is: .PP @@ -186,7 +182,7 @@ Sequence\-Negation: not .RE .PP then anytime an -.B nmh +.B mmh command is given `notfoo' as a `msg' or `msgs' argument, it would substitute all messages that are not elements of the sequence `foo'. @@ -202,17 +198,17 @@ To deactivate the negation mechanism, define Sequence\-Negation in your profile to an empty value. .SS "The Previous Sequence" -.B Nmh +.B Mmh provides the ability to remember the `msgs' or `msg' argument last given to an -.B nmh +.B mmh command. The entry `Previous\-Sequence' should be defined in the -.B nmh +.B mmh profile; its value should be a sequence name or multiple sequence names separated by spaces. If this entry is defined, when an -.B nmh +.B mmh command finishes, it will define the sequence(s) named in the value of this entry to be those messages that were specified to the command. Hence, a profile entry of @@ -222,7 +218,7 @@ Previous\-Sequence: pseq .RE .PP directs any -.B nmh +.B mmh command that accepts a `msg' or `msgs' argument to define the sequence `pseq' as those messages when it finishes. .PP @@ -230,7 +226,7 @@ define the sequence `pseq' as those messages when it finishes. there can be a performance penalty in using the `Previous\-Sequence' facility. If it is used, .B all -.B nmh +.B mmh programs have to write the sequence information to the .I \&.mh_sequences file for the folder each time they run. If the