From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#36496: [PATCH] Describe the rx notation in the lisp manual Date: Sat, 06 Jul 2019 12:08:08 +0300 Message-ID: <83r2738r9j.fsf@gnu.org> References: <0C783D67-9502-408B-B845-5599BD596361@acm.org> <838stdbw8e.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="9290"; mail-complaints-to="usenet@blaine.gmane.org" Cc: 36496@debbugs.gnu.org To: Mattias =?UTF-8?Q?Engdeg=C3=A5rd?= Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Jul 06 11:09:10 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 1hjggw-0002Jk-LO for geb-bug-gnu-emacs@m.gmane.org; Sat, 06 Jul 2019 11:09:10 +0200 Original-Received: from localhost ([::1]:58436 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hjggv-0000j7-0I for geb-bug-gnu-emacs@m.gmane.org; Sat, 06 Jul 2019 05:09:09 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:50362) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hjggp-0000io-GD for bug-gnu-emacs@gnu.org; Sat, 06 Jul 2019 05:09:04 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hjggo-0004kW-E3 for bug-gnu-emacs@gnu.org; Sat, 06 Jul 2019 05:09:03 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:45398) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1hjggo-0004kR-AE for bug-gnu-emacs@gnu.org; Sat, 06 Jul 2019 05:09:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1hjggo-0004dX-23 for bug-gnu-emacs@gnu.org; Sat, 06 Jul 2019 05:09:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 06 Jul 2019 09:09: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.156240410517779 (code B ref 36496); Sat, 06 Jul 2019 09:09:02 +0000 Original-Received: (at 36496) by debbugs.gnu.org; 6 Jul 2019 09:08:25 +0000 Original-Received: from localhost ([127.0.0.1]:54219 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hjggC-0004ch-TU for submit@debbugs.gnu.org; Sat, 06 Jul 2019 05:08:25 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:37803) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hjgg8-0004cR-79 for 36496@debbugs.gnu.org; Sat, 06 Jul 2019 05:08:22 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:52185) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hjgg2-0004Kc-Px; Sat, 06 Jul 2019 05:08:14 -0400 Original-Received: from [176.228.60.248] (port=1390 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1hjgg1-0005hD-TQ; Sat, 06 Jul 2019 05:08:14 -0400 In-reply-to: (message from Mattias =?UTF-8?Q?Engdeg=C3=A5rd?= on Fri, 5 Jul 2019 16:13:52 +0200) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] 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:162195 Archived-At: > From: Mattias EngdegÄrd > Date: Fri, 5 Jul 2019 16:13:52 +0200 > Cc: 36496@debbugs.gnu.org > > > This is a large section. The ELisp reference is already a large book, > > printed in two separate volumes. So I think if we want to include > > this section, it will have to be on a separate file that is > > conditionally included @ifnottex. > > > > Alternatively, we could make this a separate manual. > > It is about 7-8 pages in all. It's more that 2500 lines. We have in doc/misc/ separate manuals much smaller than this. So making a separate manual out of this is not radically different from what we have already. > One page could be saved by combining the character class descriptions with the existing ones; they are basically the same. However, that would probably preclude separation into separate files or manuals. > > The category names also take up about one page, but that information isn't available anywhere else, since those names are specific to rx. (It would be nice if the names were defined along with the categories, but that isn't the case at present.) I don't think we should go out of our way to make this text shorter. it is well written, and doesn't waste words, so any attempt to make it shorter will IMO make it less useful. > I would prefer @ifnottex to having a separate manual Either alternative is fine with me. > The revised patch (attached) does not separate the contents, because I wanted to hear your opinion on the matter first. Opinion on which matter? on whether or not make it a separate manual? If so, you now have my opinion. > >> +@xref{Syntax Class Table} for details. Please note that > > ^ > > Comma missing there. > > Ah, yes. Apparently, a comma is inserted automatically in the TeX version, so that we get the desired "See Section XIV, page 123, for details"; this is documented. In the info and html versions there is no page number, so a comma doesn't feel like proper English: "See Section XIV, for details" has a distinct German tone to my ears. > Explicit comma after @xref seems to be common in the Emacs manuals, so rather than to fight it out I castled the clauses. The comma is common because older versions of makeinfo insisted on having it, and would complain if there weren't one. The latest versions no longer complain, but we would still like to support the old versions, as they are ~15 times faster, so some people still keep them around. Thanks.