From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.bugs Subject: bug#8287: 24.0.50; regexp-builder, rx, sregex: (a) in manuals, (b) in action Date: Fri, 18 Mar 2011 11:14:23 -0700 Message-ID: <849EF5CA70DA4BC794B0D9A0DFA203DD@us.oracle.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: dough.gmane.org 1300473452 25277 80.91.229.12 (18 Mar 2011 18:37:32 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Fri, 18 Mar 2011 18:37:32 +0000 (UTC) To: 8287@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Mar 18 19:37:25 2011 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1Q0eY3-0003NG-4V for geb-bug-gnu-emacs@m.gmane.org; Fri, 18 Mar 2011 19:37:20 +0100 Original-Received: from localhost ([127.0.0.1]:46639 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Q0eY1-0005VO-O5 for geb-bug-gnu-emacs@m.gmane.org; Fri, 18 Mar 2011 14:37:17 -0400 Original-Received: from [140.186.70.92] (port=52808 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Q0eXo-0005U6-Qo for bug-gnu-emacs@gnu.org; Fri, 18 Mar 2011 14:37:06 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Q0eXm-0006CB-Cc for bug-gnu-emacs@gnu.org; Fri, 18 Mar 2011 14:37:03 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:36760) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Q0eXm-0006C7-BE for bug-gnu-emacs@gnu.org; Fri, 18 Mar 2011 14:37:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1Q0eCU-0006QP-MN; Fri, 18 Mar 2011 14:15:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 18 Mar 2011 18:15:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 8287 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: Original-Received: via spool by submit@debbugs.gnu.org id=B.130047209124664 (code B ref -1); Fri, 18 Mar 2011 18:15:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 18 Mar 2011 18:14:51 +0000 Original-Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Q0eCI-0006Pl-Ng for submit@debbugs.gnu.org; Fri, 18 Mar 2011 14:14:50 -0400 Original-Received: from eggs.gnu.org ([140.186.70.92]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Q0eCG-0006Pa-Hj for submit@debbugs.gnu.org; Fri, 18 Mar 2011 14:14:49 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Q0eCA-00014c-G8 for submit@debbugs.gnu.org; Fri, 18 Mar 2011 14:14:43 -0400 Original-Received: from lists.gnu.org ([199.232.76.165]:60480) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Q0eCA-00014N-3A for submit@debbugs.gnu.org; Fri, 18 Mar 2011 14:14:42 -0400 Original-Received: from [140.186.70.92] (port=33881 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Q0eC8-0006r3-Fq for bug-gnu-emacs@gnu.org; Fri, 18 Mar 2011 14:14:41 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Q0eBu-00012C-5W for bug-gnu-emacs@gnu.org; Fri, 18 Mar 2011 14:14:28 -0400 Original-Received: from rcsinet10.oracle.com ([148.87.113.121]:63942) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Q0eBu-00011u-0R for bug-gnu-emacs@gnu.org; Fri, 18 Mar 2011 14:14:26 -0400 Original-Received: from rcsinet13.oracle.com (rcsinet13.oracle.com [148.87.113.125]) by rcsinet10.oracle.com (Switch-3.4.2/Switch-3.4.2) with ESMTP id p2IIENIe023700 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Fri, 18 Mar 2011 18:14:24 GMT Original-Received: from acsmt358.oracle.com (acsmt358.oracle.com [141.146.40.158]) by rcsinet13.oracle.com (Switch-3.4.2/Switch-3.4.1) with ESMTP id p2IIEMxT020084 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Fri, 18 Mar 2011 18:14:23 GMT Original-Received: from abhmt008.oracle.com (abhmt008.oracle.com [141.146.116.17]) by acsmt358.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id p2IIEMft020181 for ; Fri, 18 Mar 2011 13:14:22 -0500 Original-Received: from dradamslap1 (/10.159.39.7) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Fri, 18 Mar 2011 11:14:22 -0700 X-Mailer: Microsoft Office Outlook 11 Thread-Index: AcvlmE7You9BFwNARe61o2/ZPHh9EA== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.5994 X-Source-IP: acsmt358.oracle.com [141.146.40.158] X-Auth-Type: Internal IP X-CT-RefId: str=0001.0A090208.4D83A0FF.0118,ss=1,fgs=0 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Fri, 18 Mar 2011 14:15:02 -0400 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-Received-From: 140.186.70.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: , Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:45153 Archived-At: 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. 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. 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. If this is a "builder" with a "convenient interface", then it should assist users. 4. The comments in `re-builder.el' are of some help. But even there things are unclear and incomplete. It refers to "`rx' syntax". What is that? Try to find `rx' in the index of either Emacs manual - nothing. 5. Consider mentioning `rx' features in the manuals. The only mention is of Gerd's contribution of `rx.el' to Emacs. Sheesh. 6. In the Commentary of `rx.el' we find mention of "the Sregex package coming with Emacs" and a comparison of rx with sregex. Again, there is nothing about sregex in either manual, except for an acknowledgement to Bob Glickstein for contributing it. Sheesh. In GNU Emacs 24.0.50.1 (i386-mingw-nt5.1.2600) of 2011-03-07 on 3249CTO Windowing system distributor `Microsoft Corp.', version 5.1.2600 configured using `configure --with-gcc (4.5) --no-opt --cflags -Ic:/imagesupport/include'