X-Git-Url: http://git.marmaro.de/?p=mmh;a=blobdiff_plain;f=man%2Fmh-sequence.man7;h=874f63e07e2263620bd446b3bd90db1e5960f42e;hp=b96230ea94aecfd3e959c2687c9969b2eaf9cfaa;hb=32b2354dbaf4bf934936eb5b102a4a3d2fdd209a;hpb=c2360569e1d8d3678e294eb7c1354cb8bf7501c1 diff --git a/man/mh-sequence.man7 b/man/mh-sequence.man7 index b96230e..874f63e 100644 --- a/man/mh-sequence.man7 +++ b/man/mh-sequence.man7 @@ -27,7 +27,7 @@ or one of these \*(lqreserved\*(rq message names: .RS 5 .nf .ta +\w'\fIName\fP 'u -.I Name Description +.I "Name Description first the first message in the folder last the last message in the folder cur the most recently accessed message @@ -150,15 +150,18 @@ the \*(lqMh\-Sequences\*(rq profile entry is defined but empty, then .SS "Sequence Negation" .B Nmh -provides the ability to select all messages not elements of a -user-defined sequence. To do this, the user should define the entry +provides the ability to select all messages +.B not +elements of a user-defined sequence. +A special string is used to preface an existing user-defined +sequence name. This specification then refers to those +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 \*(lqSequence\-Negation\*(rq in the .B nmh -profile file; its value -may be any string. This string is then used to preface an existing -user-defined sequence name. This specification then refers to those -messages not elements of the specified sequence name. For example, if -the profile entry is: +profile file. +For example, if the profile entry is: .PP .RS 5 Sequence\-Negation: not @@ -172,6 +175,13 @@ of the sequence \*(lqfoo\*(rq. .PP Obviously, the user should beware of defining sequences with names that begin with the value of the \*(lqSequence\-Negation\*(rq profile entry. +The default value `!' was chosen due to its similar meaning in the C +programming language, and because it cannot be part of a user-defined +sequence. But if your shell provides history expansion, +you might need to quote the exlamation mark (prefix it with a backslash). +.PP +To deactivate the negation mechanism, define Sequence\-Negation in your +profile to an empty value. .SS "The Previous Sequence" .B Nmh @@ -221,7 +231,6 @@ The commands .BR inc , .BR rcvstore , .BR show , -.BR mhshow , and .B flist honor the sequence. @@ -243,7 +252,6 @@ be zeroed by .PP Similarly, whenever .BR show , -.BR mhshow , .BR next , or .B prev