From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Lars Ingebrigtsen Newsgroups: gmane.emacs.bugs 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 Message-ID: <877ffiqbi3.fsf@gnus.org> References: <849EF5CA70DA4BC794B0D9A0DFA203DD@us.oracle.com> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1461839002 30489 80.91.229.3 (28 Apr 2016 10:23:22 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Thu, 28 Apr 2016 10:23:22 +0000 (UTC) Cc: 8287@debbugs.gnu.org To: "Drew Adams" Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Thu Apr 28 12:23:11 2016 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1avj6E-0006dT-Ja for geb-bug-gnu-emacs@m.gmane.org; Thu, 28 Apr 2016 12:23:10 +0200 Original-Received: from localhost ([::1]:47821 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1avj6D-00013K-Vd for geb-bug-gnu-emacs@m.gmane.org; Thu, 28 Apr 2016 06:23:09 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:40132) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1avj6A-0000xv-0Q for bug-gnu-emacs@gnu.org; Thu, 28 Apr 2016 06:23:07 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1avj66-0002m5-QV for bug-gnu-emacs@gnu.org; Thu, 28 Apr 2016 06:23:05 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:38902) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1avj66-0002lz-Na for bug-gnu-emacs@gnu.org; Thu, 28 Apr 2016 06:23:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1avj66-0007zH-Gf for bug-gnu-emacs@gnu.org; Thu, 28 Apr 2016 06:23:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Lars Ingebrigtsen Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 28 Apr 2016 10:23:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 8287 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 8287-submit@debbugs.gnu.org id=B8287.146183892230601 (code B ref 8287); Thu, 28 Apr 2016 10:23:02 +0000 Original-Received: (at 8287) by debbugs.gnu.org; 28 Apr 2016 10:22:02 +0000 Original-Received: from localhost ([127.0.0.1]:51236 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1avj57-0007xV-Um for submit@debbugs.gnu.org; Thu, 28 Apr 2016 06:22:02 -0400 Original-Received: from hermes.netfonds.no ([80.91.224.195]:34488) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1avj56-0007x7-HF for 8287@debbugs.gnu.org; Thu, 28 Apr 2016 06:22:00 -0400 Original-Received: from cm-84.215.1.64.getinternet.no ([84.215.1.64] helo=mouse) by hermes.netfonds.no with esmtpsa (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.84_2) (envelope-from ) id 1avj54-0000MF-04; Thu, 28 Apr 2016 12:21:59 +0200 In-Reply-To: <849EF5CA70DA4BC794B0D9A0DFA203DD@us.oracle.com> (Drew Adams's message of "Fri, 18 Mar 2011 11:14:23 -0700") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.1.50 (gnu/linux) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 208.118.235.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.org gmane.emacs.bugs:117025 Archived-At: "Drew Adams" 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