diff options
author | Chong Yidong <[email protected]> | 2010-06-02 13:26:31 -0400 |
---|---|---|
committer | Chong Yidong <[email protected]> | 2010-06-02 13:26:31 -0400 |
commit | ba3bf1d9519b4f5aafba9a87109ef1e7a29f7fcc (patch) | |
tree | c5fd5f0eceba7b0d82e511d0cac4823458d86047 /doc | |
parent | 2c3a3c1d035e06250db54fb17ee7aec6b7c2c70a (diff) |
Better doc fix for Bug#6283.
searching.texi (Regexp Special): Remove obsolete information
about matching non-ASCII characters, and suggest using char
classes (Bug#6283).
Diffstat (limited to 'doc')
-rw-r--r-- | doc/lispref/ChangeLog | 5 | ||||
-rw-r--r-- | doc/lispref/searching.texi | 26 |
2 files changed, 13 insertions, 18 deletions
diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog index b871c44280..281f3e9ad7 100644 --- a/doc/lispref/ChangeLog +++ b/doc/lispref/ChangeLog @@ -1,7 +1,8 @@ 2010-06-02 Chong Yidong <[email protected]> - * searching.texi (Regexp Special): Replace "octal 377" - with "#o377" (Bug#6283). + * searching.texi (Regexp Special): Remove obsolete information + about matching non-ASCII characters, and suggest using char + classes (Bug#6283). 2010-05-30 Juanma Barranquero <[email protected]> diff --git a/doc/lispref/searching.texi b/doc/lispref/searching.texi index d1e8c54967..722f76cdd7 100644 --- a/doc/lispref/searching.texi +++ b/doc/lispref/searching.texi @@ -362,7 +362,7 @@ the two brackets are what this character alternative can match. Thus, @samp{[ad]} matches either one @samp{a} or one @samp{d}, and @samp{[ad]*} matches any string composed of just @samp{a}s and @samp{d}s -(including the empty string), from which it follows that @samp{c[ad]*r} +(including the empty string). It follows that @samp{c[ad]*r} matches @samp{cr}, @samp{car}, @samp{cdr}, @samp{caddaar}, etc. You can also include character ranges in a character alternative, by @@ -400,21 +400,11 @@ is @samp{@var{c}..?\377}, the other is @samp{@var{c1}..@var{c2}}, where @var{c1} is the first character of the charset to which @var{c2} belongs. -You cannot always match all non-@acronym{ASCII} characters with the -regular expression @code{"[\200-\377]"}. This works when searching a -unibyte buffer or string (@pxref{Text Representations}), but not in a -multibyte buffer or string, because many non-@acronym{ASCII} -characters have codes above @code{#o377}. However, the regular -expression @code{"[^\000-\177]"} does match all non-@acronym{ASCII} -characters (see below regarding @samp{^}), in both multibyte and -unibyte representations, because only the @acronym{ASCII} characters -are excluded. - -A character alternative can also specify named -character classes (@pxref{Char Classes}). This is a POSIX feature whose -syntax is @samp{[:@var{class}:]}. Using a character class is equivalent -to mentioning each of the characters in that class; but the latter is -not feasible in practice, since some classes include thousands of +A character alternative can also specify named character classes +(@pxref{Char Classes}). This is a POSIX feature whose syntax is +@samp{[:@var{class}:]}. Using a character class is equivalent to +mentioning each of the characters in that class; but the latter is not +feasible in practice, since some classes include thousands of different characters. @item @samp{[^ @dots{} ]} @@ -432,6 +422,10 @@ A complemented character alternative can match a newline, unless newline is mentioned as one of the characters not to match. This is in contrast to the handling of regexps in programs such as @code{grep}. +You can specify named character classes, just like in character +alternatives. For instance, @samp{[^[:ascii:]]} matches any +non-@acronym{ASCII} character. @xref{Char Classes}. + @item @samp{^} @cindex beginning of line in regexp When matching a buffer, @samp{^} matches the empty string, but only at the |