bug-gnu-emacs
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

bug#36496: [PATCH] Describe the rx notation in the lisp manual


From: Mattias Engdegård
Subject: bug#36496: [PATCH] Describe the rx notation in the lisp manual
Date: Sun, 7 Jul 2019 13:31:06 +0200

7 juli 2019 kl. 04.29 skrev Eli Zaretskii <eliz@gnu.org>:

> Thanks, LGTM.

Thanks for reviewing! Pushed to master.

7 juli 2019 kl. 01.56 skrev Richard Stallman <rms@gnu.org>:

> 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?






reply via email to

[Prev in Thread] Current Thread [Next in Thread]