From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Mattias =?UTF-8?Q?Engdeg=C3=A5rd?= Newsgroups: gmane.emacs.bugs Subject: bug#36496: [PATCH] Describe the rx notation in the lisp manual Date: Sun, 7 Jul 2019 13:31:06 +0200 Message-ID: References: <0C783D67-9502-408B-B845-5599BD596361@acm.org> <838stdbw8e.fsf@gnu.org> <83r2738r9j.fsf@gnu.org> <83k1cv8k5z.fsf@gnu.org> <83zhlr6ksx.fsf@gnu.org> <83y31a7f27.fsf@gnu.org> Mime-Version: 1.0 (Mac OS X Mail 12.4 \(3445.104.11\)) Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="135256"; mail-complaints-to="usenet@blaine.gmane.org" Cc: 36496@debbugs.gnu.org, Noam Postavsky , Richard Stallman To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Jul 07 13:32:22 2019 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([209.51.188.17]) by blaine.gmane.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1hk5P0-000Yzy-Bq for geb-bug-gnu-emacs@m.gmane.org; Sun, 07 Jul 2019 13:32:18 +0200 Original-Received: from localhost ([::1]:34750 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hk5Oy-0007ew-OE for geb-bug-gnu-emacs@m.gmane.org; Sun, 07 Jul 2019 07:32:16 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:46834) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hk5Ou-0007ep-Be for bug-gnu-emacs@gnu.org; Sun, 07 Jul 2019 07:32:13 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hk5Os-0004Wb-DC for bug-gnu-emacs@gnu.org; Sun, 07 Jul 2019 07:32:12 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:47385) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1hk5Ok-0004Te-JH for bug-gnu-emacs@gnu.org; Sun, 07 Jul 2019 07:32:05 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1hk5Ok-0007aT-Ew for bug-gnu-emacs@gnu.org; Sun, 07 Jul 2019 07:32:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Mattias =?UTF-8?Q?Engdeg=C3=A5rd?= Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 07 Jul 2019 11:32:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 36496 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch Original-Received: via spool by 36496-submit@debbugs.gnu.org id=B36496.156249907326610 (code B ref 36496); Sun, 07 Jul 2019 11:32:02 +0000 Original-Received: (at 36496) by debbugs.gnu.org; 7 Jul 2019 11:31:13 +0000 Original-Received: from localhost ([127.0.0.1]:56206 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hk5Nx-0006uo-8m for submit@debbugs.gnu.org; Sun, 07 Jul 2019 07:31:13 -0400 Original-Received: from mail200c50.megamailservers.eu ([91.136.10.210]:40648 helo=mail193c50.megamailservers.eu) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hk5Nu-0006qz-KZ for 36496@debbugs.gnu.org; Sun, 07 Jul 2019 07:31:11 -0400 X-Authenticated-User: mattiase@bredband.net DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=megamailservers.eu; s=maildub; t=1562499068; bh=sN869RvdiTIood+hApdij6VbsBiSu/zjmGHed82LhBk=; h=Subject:From:In-Reply-To:Date:Cc:References:To:From; b=S6igiTg7dZBg8bg1LcUfNSYZAuoGWZ5mj1JnudvzNWrbHo41vtQQY0PotwF0ur8WH gRn5F8N/vttmv0P4EGHgZpGHrFecquYFRNWiREXq4aOTeM1ww2m/zBqNjrarECbDib ktvkaJKlMWNhlUG+/eOE7iRK32ttvvj9FgAYlJDA= Feedback-ID: mattiase@acm.or Original-Received: from [192.168.0.4] ([188.150.171.71]) (authenticated bits=0) by mail193c50.megamailservers.eu (8.14.9/8.13.1) with ESMTP id x67BV6QD004526; Sun, 7 Jul 2019 11:31:08 +0000 In-Reply-To: <83y31a7f27.fsf@gnu.org> X-Mailer: Apple Mail (2.3445.104.11) X-CTCH-RefID: str=0001.0A0B020E.5D21D7FC.0049, ss=1, re=0.000, recu=0.000, reip=0.000, cl=1, cld=1, fgs=0 X-CTCH-VOD: Unknown X-CTCH-Spam: Unknown X-CTCH-Score: 0.000 X-CTCH-Flags: 0 X-CTCH-ScoreCust: 0.000 X-CSC: 0 X-CHA: v=2.3 cv=KsZjJ1eN c=1 sm=1 tr=0 a=SF+I6pRkHZhrawxbOkkvaA==:117 a=SF+I6pRkHZhrawxbOkkvaA==:17 a=jpOVt7BSZ2e4Z31A5e1TngXxSK0=:19 a=kj9zAlcOel0A:10 a=mDV3o1hIAAAA:8 a=N0D_jAryGqMWON5PpPIA:9 a=CjuIK1q_8ugA:10 a=_FVE-zBwftR9WsbkzFJk:22 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: 209.51.188.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:162273 Archived-At: 7 juli 2019 kl. 04.29 skrev Eli Zaretskii : > Thanks, LGTM. Thanks for reviewing! Pushed to master. 7 juli 2019 kl. 01.56 skrev Richard Stallman : > Would it be feasible to format it differently so that it comes out as > fewer pages? That might be possible by using Texinfo a different way. One way, already mentioned, would be to merge the character class = descriptions for rx and string regexps. That would save about one page, = at the cost of making the list slightly messier since rx has synonyms = for each item which are not legal in string regexps ([:digit:] vs = `digit', `numeric' and `num'). Eliding the categories table would save another page, if we accept a = reference to other formats or the rx doc string. I see little room beyond that. We could remove the examples, but they = are short and doing so would make an already dry section even drier. > Here's another idea: document the two syntaxes in a single table, > where each item says how to do the job in a regexp > and how to do it in rx. Probably not a bad idea and one that would put the syntaxes on equal = footing, but it involves a complete rewrite of all the regexp sections; = more than I am prepared to do right now. Should this bug be kept open for possible improvements to the print = manual, or can we regard that as a separate issue?