Activated default sequence negation (exclamation mark).

[mmh] / man / mh-sequence.man7

diff --git a/man/mh-sequence.man7 b/man/mh-sequence.man7
index b96230e..98564e0 100644 (file)
--- a/man/mh-sequence.man7
+++ b/man/mh-sequence.man7
@@ -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