From: Stefan Monnier <monnier@iro.umontreal.ca>
Date: Thu, 21 Mar 2019 12:27:39 +0000 (-0400)
Subject: * doc: Recommend putting '-' as last char in Emacs charset regexps
X-Git-Tag: emacs-27.0.90~3377
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=c569cceb2d334564d320d2b4098c855db7eb88a0;p=emacs.git

* doc: Recommend putting '-' as last char in Emacs charset regexps

* doc/lispref/searching.texi (Regexp Special):
* doc/emacs/search.texi (Regexps): Recommend - as last char in [...].
---

diff --git a/doc/emacs/search.texi b/doc/emacs/search.texi
index 9c58ef471fe..a1c987c1252 100644
--- a/doc/emacs/search.texi
+++ b/doc/emacs/search.texi
@@ -974,11 +974,10 @@ character class inside a character alternative.  For instance,
 elisp, The Emacs Lisp Reference Manual}, for a list of character
 classes.
 
-To include a @samp{]} in a character set, you must make it the first
-character.  For example, @samp{[]a]} matches @samp{]} or @samp{a}.  To
-include a @samp{-}, write @samp{-} as the first or last character of the
-set, or put it after a range.  Thus, @samp{[]-]} matches both @samp{]}
-and @samp{-}.
+To include a @samp{]} in a character set, you must make it the first character.
+For example, @samp{[]a]} matches @samp{]} or @samp{a}.  To include a @samp{-},
+write @samp{-} as the last character of the set, tho you can also put it first
+or after a range.  Thus, @samp{[]-]} matches both @samp{]} and @samp{-}.
 
 To include @samp{^} in a set, put it anywhere but at the beginning of
 the set.  (At the beginning, it complements the set---see below.)
diff --git a/doc/lispref/searching.texi b/doc/lispref/searching.texi
index 740be2a31ff..0f312915f9e 100644
--- a/doc/lispref/searching.texi
+++ b/doc/lispref/searching.texi
@@ -406,13 +406,13 @@ Note also that the usual regexp special characters are not special inside a
 character alternative.  A completely different set of characters is
 special inside character alternatives: @samp{]}, @samp{-} and @samp{^}.
 
-To include a @samp{]} in a character alternative, you must make it the
-first character.  For example, @samp{[]a]} matches @samp{]} or @samp{a}.
-To include a @samp{-}, write @samp{-} as the first or last character of
-the character alternative, or put it after a range.  Thus, @samp{[]-]}
-matches both @samp{]} and @samp{-}.  (As explained below, you cannot
-use @samp{\]} to include a @samp{]} inside a character alternative,
-since @samp{\} is not special there.)
+To include a @samp{]} in a character alternative, you must make it the first
+character.  For example, @samp{[]a]} matches @samp{]} or @samp{a}.  To include
+a @samp{-}, write @samp{-} as the last character of the character alternative,
+tho you can also put it first or after a range.  Thus, @samp{[]-]} matches both
+@samp{]} and @samp{-}.  (As explained below, you cannot use @samp{\]} to
+include a @samp{]} inside a character alternative, since @samp{\} is not
+special there.)
 
 To include @samp{^} in a character alternative, put it anywhere but at
 the beginning.