From: Lars Ingebrigtsen <larsi@gnus.org>
To: "Drew Adams" <drew.adams@oracle.com>
Cc: 8287@debbugs.gnu.org
Subject: bug#8287: 24.0.50; regexp-builder, rx, sregex: (a) in manuals, (b) in action
Date: Thu, 28 Apr 2016 12:21:56 +0200 [thread overview]
Message-ID: <877ffiqbi3.fsf@gnus.org> (raw)
In-Reply-To: <849EF5CA70DA4BC794B0D9A0DFA203DD@us.oracle.com> (Drew Adams's message of "Fri, 18 Mar 2011 11:14:23 -0700")
"Drew Adams" <drew.adams@oracle.com> writes:
> 1. Only `re-builder', not `regexp-builder', is indexed in the Elisp
> manual. This is incomplete and backwards - users will look for "regexp"
> before "re-" when looking for help with regexps.
There's already a @cindex to "regexp" in the same node, so that seems
unnecessary.
> 2. There is no explanation of this command in either manual. Node
> `Regular Expressions' of Elisp just mentions it in passing, with no
> help. It says that the command provides "a convenient interface"
> without providing any explanation of that nifty interface or how to use
> it. The Emacs manual doesn't even mention the command.
@findex re-builder
@cindex regular expressions, developing
For interactive development of regular expressions, you
can use the @kbd{M-x re-builder} command. It provides a convenient
interface for creating regular expressions, by giving immediate visual
feedback in a separate buffer. As you edit the regexp, all its
matches in the target buffer are highlighted. Each parenthesized
sub-expression of the regexp is shown in a distinct face, which makes
it easier to verify even very complex regexps.
Looks fine now, at least...
> See also bug #8286, about the hopeless doc string.
>
> 3. There is no real doc for `re-builder' - no help for users, including
> after they actually try to use the command. `C-h m' in buffer
> *RE-Builder* simply lists the key bindings. To understand anything
> about this "convenient interface" users will need to drill down from the
> list of key bindings and check the doc for each command. And even then
> they will discover nothing of any real help AFAICT.
Chong fixed this in 2011, apparently. Closing.
--
(domestic pets only, the antidote for overdose, milk.)
bloggy blog: http://lars.ingebrigtsen.no
prev parent reply other threads:[~2016-04-28 10:21 UTC|newest]
Thread overview: 2+ messages / expand[flat|nested] mbox.gz Atom feed top
2011-03-18 18:14 bug#8287: 24.0.50; regexp-builder, rx, sregex: (a) in manuals, (b) in action Drew Adams
2016-04-28 10:21 ` Lars Ingebrigtsen [this message]
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=877ffiqbi3.fsf@gnus.org \
--to=larsi@gnus.org \
--cc=8287@debbugs.gnu.org \
--cc=drew.adams@oracle.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this external index
https://git.savannah.gnu.org/cgit/emacs.git
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.