X-Git-Url: http://git.marmaro.de/?a=blobdiff_plain;f=man%2Fmh-sequence.man7;h=516b8afd67ca368936b3b305deee57f88004c756;hb=2abb9a7cfb0930e27062088734d306e7d78e4cc2;hp=60568edc8f2a13079fbf1cfb95f8f90b21d656c4;hpb=5c43bb739797c078c3fd6aa982183e15af456d31;p=mmh diff --git a/man/mh-sequence.man7 b/man/mh-sequence.man7 index 60568ed..516b8af 100644 --- a/man/mh-sequence.man7 +++ b/man/mh-sequence.man7 @@ -28,20 +28,19 @@ or one of these `reserved' message names: .nf .ta +\w'\fIName\fP 'u .I "Name Description -first the first message in the folder -last the last message in the folder -cur the most recently accessed message -prev the message numerically preceding `cur' -next the message numerically following `cur' +f the first message in the folder +p the message numerically preceding `c' +c the most recently accessed message +n the message numerically following `c' +l the last message in the folder .fi .RE .PP -In commands that take a `msg' argument, the default is `cur'. -As a shorthand, `\&.' is equivalent to `cur'. +In commands that take a `msg' argument, the default is `c'. .PP For example: In a folder containing five messages numbered 5, 10, 94, 177 -and 325, `first' is 5 and `last' is 325. If `cur' -is 94, then `prev' is 10 and `next' is 177. +and 325, `f' is 5 and `l' is 325. If `c' +is 94, then `p' is 10 and `n' is 177. .PP The word `msgs' indicates that one or more messages may be specified. Such a specification consists of one message designation or of several @@ -49,32 +48,51 @@ message designations separated by spaces. A message designation consists either of a message name as defined above, or a message range. .PP A message range is specified as `name1\-name2' or -`name:n', where `name', `name1' and `name2' are message names, -and `n' is an integer. +`name:i', where `name', `name1' and `name2' are message names, +and `i' is an integer. .PP The specification `name1\-name2' designates all currently existing messages from `name1' to `name2' inclusive. The `reserved' -message name `all' is a shorthand for the message range -`first\-last'. +message name `a' (``all'') is a shorthand for the message range +`f\-l'. .PP -The specification `name:n' designates up to `n' messages. +.RS 5 +.nf +.ta +\w'\fIName\fP 'u +.I "Name Description +a all messages in the folder (i.e. `f\-l') +.fi +.RE +.PP +The specification `name:i' designates up to `i' messages. These messages start with `name' if `name' is a message number or one of -the reserved names `first' `cur', or `next', The -messages end with `name' if `name' is `prev' or `last'. -The interpretation of `n' may be overridden by preceding `n' with a -plus or minus sign; `+n' always means up to `n' messages starting with -`name', and `\-n' always means up to `n' messages ending with `name'. +the reserved names `f' `c', or `n', The +messages end with `name' if `name' is `p' or `l'. +The interpretation of `i' may be overridden by preceding `i' with a +plus or minus sign; `+i' always means up to `i' messages starting with +`name', and `\-i' always means up to `i' messages ending with `name'. .PP In commands which accept a `msgs' argument, the default is either -`cur' or `all', depending on which makes more sense -for each command (see the individual man pages for details). Repeated +`c' or `a', depending on which makes more sense +for each command (see the individual man pages for details). +.PP +Repeated specifications of the same message have the same effect as a single specification of the message. .PP -There is also a special `reserved' message name `new' -which is used by the +There is also a special `reserved' message name `b' (``beyond'') +which can be used with the .B mhpath -command. +command. It refers to the next (not yet used) message number +after `l'. +.PP +.RS 5 +.nf +.ta +\w'\fIName\fP 'u +.I "Name Description +b the next message number beyond `l' +.fi +.RE .SS "User\-Defined Message Sequences" In addition to the `reserved' (pre-defined) message names given @@ -96,17 +114,17 @@ command expects a `msg' or `msgs' argument. .PP Some forms of message ranges are allowed with user-defined sequences. -The specification `name:n' may be used, and it designates up -to the first `n' messages (or last `n' messages for `\-n') which are +The specification `name:i' may be used, and it designates up +to the first `i' messages (or last `i' messages for `\-i') which are elements of the user-defined sequence `name'. .PP -The specifications `name:next' and `name:prev' may also +The specifications `name:n' and `name:p' may also be used, and they designate the next or previous message (relative to the current message) which is an element of the user-defined sequence `name'. -The specifications `name:first' and `name:last' are +The specifications `name:f' and `name:l' are equivalent to `name:1' and `name:\-1', respectively. The -specification `name:cur' is not allowed (use just `cur' -instead). The syntax of these message range specifications is subject +specification `name:c' is not allowed (use just `c' instead). +Note: The syntax of these message range specifications is subject to change in the future. .PP User-defined sequence names are specific to each folder. They are @@ -115,7 +133,7 @@ defined using the and .B mark commands. -.PP + .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