From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#31698: 27.0; `rx' help: Show equivalent regexp constructs Date: Sun, 3 Jun 2018 10:01:07 -0700 (PDT) Message-ID: <66469700-731c-4a05-a06e-51dba8dd8149@default> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Trace: blaine.gmane.org 1528045207 12337 195.159.176.226 (3 Jun 2018 17:00:07 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Sun, 3 Jun 2018 17:00:07 +0000 (UTC) To: 31698@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Jun 03 19:00:03 2018 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fPWMM-00036a-W5 for geb-bug-gnu-emacs@m.gmane.org; Sun, 03 Jun 2018 19:00:03 +0200 Original-Received: from localhost ([::1]:35994 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fPWOU-0003tK-3K for geb-bug-gnu-emacs@m.gmane.org; Sun, 03 Jun 2018 13:02:14 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:48064) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fPWOM-0003t2-Al for bug-gnu-emacs@gnu.org; Sun, 03 Jun 2018 13:02:07 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fPWOI-0005Yo-Dt for bug-gnu-emacs@gnu.org; Sun, 03 Jun 2018 13:02:06 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:52590) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1fPWOI-0005YX-9g for bug-gnu-emacs@gnu.org; Sun, 03 Jun 2018 13:02:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1fPWOH-0004Ud-WD for bug-gnu-emacs@gnu.org; Sun, 03 Jun 2018 13:02:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 03 Jun 2018 17:02:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 31698 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.152804528617229 (code B ref -1); Sun, 03 Jun 2018 17:02:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 3 Jun 2018 17:01:26 +0000 Original-Received: from localhost ([127.0.0.1]:60487 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fPWNi-0004Tp-E3 for submit@debbugs.gnu.org; Sun, 03 Jun 2018 13:01:26 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:56927) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fPWNg-0004Tc-I4 for submit@debbugs.gnu.org; Sun, 03 Jun 2018 13:01:25 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fPWNa-0004ZW-Ge for submit@debbugs.gnu.org; Sun, 03 Jun 2018 13:01:19 -0400 Original-Received: from lists.gnu.org ([2001:4830:134:3::11]:50704) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1fPWNa-0004ZN-D5 for submit@debbugs.gnu.org; Sun, 03 Jun 2018 13:01:18 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:47896) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fPWNZ-0003oO-9K for bug-gnu-emacs@gnu.org; Sun, 03 Jun 2018 13:01:18 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fPWNV-0004Ry-DP for bug-gnu-emacs@gnu.org; Sun, 03 Jun 2018 13:01:17 -0400 Original-Received: from userp2130.oracle.com ([156.151.31.86]:57742) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1fPWNV-0004PN-3k for bug-gnu-emacs@gnu.org; Sun, 03 Jun 2018 13:01:13 -0400 Original-Received: from pps.filterd (userp2130.oracle.com [127.0.0.1]) by userp2130.oracle.com (8.16.0.22/8.16.0.22) with SMTP id w53H0U8G116801 for ; Sun, 3 Jun 2018 17:01:10 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : subject : content-type : content-transfer-encoding; s=corp-2017-10-26; bh=VMwsV8bGlaV1vkZbkL/yqxHR7cO/yPEyS+aHsR0ftV8=; b=v7ZqcSlaeG5LjykBJL4EB+MtPQCO2//Lwjlj4/F2pn7Cq8d5AcBbJ0tXqW0CBClHNqUV TX41XzWAj3WRgAFjSUgz225+fsCAYMK1ZZdj7JrP1hcfROq29at5yXaMXr54S7bPlBhj 8FCx5Z7OsWSNyB503F5YfQKMvss8UkL5KOuxxV3t0bGlAe731k5Blra92uZgj5lg1sg9 sb+9SD9N5Uj+flI6BWpH5M/c3IPpvzN41W2Nso7i/pXM7eUirBuA1MRhpMdDlknrqLzB NM3LImo2epT8FlrbnQqAP3Z1Af7Bk5LLx5a+eEpxR3pzkpSZLVO0KZk9CEKSVzhwErkN kQ== Original-Received: from aserv0021.oracle.com (aserv0021.oracle.com [141.146.126.233]) by userp2130.oracle.com with ESMTP id 2jbvyp17mk-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Sun, 03 Jun 2018 17:01:10 +0000 Original-Received: from userv0121.oracle.com (userv0121.oracle.com [156.151.31.72]) by aserv0021.oracle.com (8.14.4/8.14.4) with ESMTP id w53H18bC015700 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Sun, 3 Jun 2018 17:01:09 GMT Original-Received: from abhmp0017.oracle.com (abhmp0017.oracle.com [141.146.116.23]) by userv0121.oracle.com (8.14.4/8.13.8) with ESMTP id w53H18sD024293 for ; Sun, 3 Jun 2018 17:01:08 GMT X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4690.0 (x86)] X-Proofpoint-Virus-Version: vendor=nai engine=5900 definitions=8913 signatures=668702 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=1 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 mlxlogscore=667 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1805220000 definitions=main-1806030211 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [generic] [fuzzy] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x 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:146916 Archived-At: Help for `rx' could use some improvement. 1. There seems to be no other help for `rx' than `C-h f rx'. Nothing in the Elisp manual, for instance. Perhaps it should have its own manual. Or perhaps it should be documented in the Elisp manual (?). It's hard to imagine someone trying to learn the use of `rx' just by looking at `C-h f rx'. Emacs should try to do better. 2. Please document (in the doc string of `rx', if nowhere else) the correspondences between each of the `rx' constructs and regexp syntax. At least please document the most important ones. For example, `zero-or-more' presumably corresponds to postfix regexp char `*'. 3. Please consider reordering the doc-string text to cover more commonly used and more important constructs before those less likely to be used. E.g., `not', `and', and `or', seem more common and more important than `category'. In GNU Emacs 27.0.50 (build 3, x86_64-w64-mingw32) of 2018-03-21 Repository revision: e70d0c9e66d7a8609450b2889869d16aeb0363b5 Windowing system distributor `Microsoft Corp.', version 6.1.7601 Configured using: `configure --without-dbus --host=3Dx86_64-w64-mingw32 --without-compress-install -C 'CFLAGS=3D-O2 -static -g3''