From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.ciao.gmane.io!not-for-mail From: Richard Stallman Newsgroups: gmane.emacs.bugs Subject: bug#41006: 26.3; regular expressions documentation Date: Fri, 08 May 2020 23:53:58 -0400 Message-ID: References: <64E29F93-5A92-4F8D-9BA2-C6F14AEC2F64@acm.org> <824a1116-8e91-409f-95ff-69ef168a359d@default> <87k11s221z.fsf@stefankangas.se> Reply-To: rms@gnu.org Content-Type: text/plain; charset=Utf-8 Injection-Info: ciao.gmane.io; posting-host="ciao.gmane.io:159.69.161.202"; logging-data="3731"; mail-complaints-to="usenet@ciao.gmane.io" Cc: mattiase@acm.org, stefan@marxist.se, 41006@debbugs.gnu.org, rtm443x@googlemail.com To: Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sat May 09 05:55:09 2020 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1jXGZx-0000qP-Tw for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 09 May 2020 05:55:09 +0200 Original-Received: from localhost ([::1]:49658 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jXGZw-0003aG-FO for geb-bug-gnu-emacs@m.gmane-mx.org; Fri, 08 May 2020 23:55:08 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:54390) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jXGZq-0003a4-13 for bug-gnu-emacs@gnu.org; Fri, 08 May 2020 23:55:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:35012) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1jXGZp-0007td-Nh for bug-gnu-emacs@gnu.org; Fri, 08 May 2020 23:55:01 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1jXGZp-0002ui-MX for bug-gnu-emacs@gnu.org; Fri, 08 May 2020 23:55:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Richard Stallman Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 09 May 2020 03:55:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 41006 X-GNU-PR-Package: emacs Original-Received: via spool by 41006-submit@debbugs.gnu.org id=B41006.158899644711100 (code B ref 41006); Sat, 09 May 2020 03:55:01 +0000 Original-Received: (at 41006) by debbugs.gnu.org; 9 May 2020 03:54:07 +0000 Original-Received: from localhost ([127.0.0.1]:46552 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jXGYw-0002sy-Qz for submit@debbugs.gnu.org; Fri, 08 May 2020 23:54:07 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:51068) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jXGYv-0002sU-6b for 41006@debbugs.gnu.org; Fri, 08 May 2020 23:54:05 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:43870) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jXGYp-0006V9-OL; Fri, 08 May 2020 23:53:59 -0400 Original-Received: from rms by fencepost.gnu.org with local (Exim 4.82) (envelope-from ) id 1jXGYo-00053H-Lt; Fri, 08 May 2020 23:53:58 -0400 In-Reply-To: (message from Drew Adams on Fri, 8 May 2020 09:49:11 -0700 (PDT)) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list 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-mx.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.io gmane.emacs.bugs:179947 Archived-At: [[[ To any NSA and FBI agents reading my email: please consider ]]] [[[ whether defending the US Constitution against all enemies, ]]] [[[ foreign or domestic, requires you to follow Snowden's example. ]]] > 1. Some high-level description of regexps - an idea > of what they are and what you can use them for. > 2. How to use them to match/search: regexp search. > 3. Details of what they are - syntax, etc. This suggestion is rather vague because it doesn't relate to the node structure. The node structure is crucial for a manual in Info. The overall node for regexps, Regular Expressions, should start with a brief introduction. (Every node that has subnodes should start with a brief introduction.) It could be as much as 10 or 12 lines. But the subnode menu should fit on the screen, so more than 10 or 12 lines is too many. The node intro normally does NOT start to teach those topics; it only says what the topics are. We can't describe very much of regexp syntax there. It could say a little bit about some very simple regexps, but no more. So the first subnodes need to describe how to write a regexp. I am thinking about the Lisp Manual here. -- Dr Richard Stallman Chief GNUisance of the GNU Project (https://gnu.org) Founder, Free Software Foundation (https://fsf.org) Internet Hall-of-Famer (https://internethalloffame.org)