From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.ciao.gmane.io!not-for-mail From: jan via "Bug reports for GNU Emacs, the Swiss army knife of text editors" Newsgroups: gmane.emacs.bugs Subject: bug#41006: 26.3; regular expressions documentation Date: Mon, 4 May 2020 10:13:06 +0100 Message-ID: References: <64E29F93-5A92-4F8D-9BA2-C6F14AEC2F64@acm.org> Reply-To: jan Mime-Version: 1.0 Content-Type: text/plain; charset="UTF-8" Injection-Info: ciao.gmane.io; posting-host="ciao.gmane.io:159.69.161.202"; logging-data="34556"; mail-complaints-to="usenet@ciao.gmane.io" Cc: Mattias =?UTF-8?Q?Engdeg=C3=83=C2=A5rd?= , 41006@debbugs.gnu.org To: rms@gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Mon May 04 11:14:17 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 1jVXB3-0008tb-3d for geb-bug-gnu-emacs@m.gmane-mx.org; Mon, 04 May 2020 11:14:17 +0200 Original-Received: from localhost ([::1]:36910 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jVXB2-0005ll-4u for geb-bug-gnu-emacs@m.gmane-mx.org; Mon, 04 May 2020 05:14:16 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:48328) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jVXAo-0005kU-3D for bug-gnu-emacs@gnu.org; Mon, 04 May 2020 05:14:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:47418) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1jVXAn-00042S-QZ for bug-gnu-emacs@gnu.org; Mon, 04 May 2020 05:14:01 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1jVXAn-00038M-LR for bug-gnu-emacs@gnu.org; Mon, 04 May 2020 05:14:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: jan Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 04 May 2020 09:14: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.158858359411980 (code B ref 41006); Mon, 04 May 2020 09:14:01 +0000 Original-Received: (at 41006) by debbugs.gnu.org; 4 May 2020 09:13:14 +0000 Original-Received: from localhost ([127.0.0.1]:58964 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jVXA2-00037A-I4 for submit@debbugs.gnu.org; Mon, 04 May 2020 05:13:14 -0400 Original-Received: from mail-pg1-f179.google.com ([209.85.215.179]:45895) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jVXA1-00036w-MG for 41006@debbugs.gnu.org; Mon, 04 May 2020 05:13:14 -0400 Original-Received: by mail-pg1-f179.google.com with SMTP id s18so8202036pgl.12 for <41006@debbugs.gnu.org>; Mon, 04 May 2020 02:13:13 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=googlemail.com; s=20161025; h=mime-version:in-reply-to:references:from:date:message-id:subject:to :cc; bh=bI1Bq6iont4vJvJSjNeGIPr54zuO7QEXVXe4/PuEAG8=; b=vYk9UeCPVrCx/jX7B47grVcskJAMTXB4S9PQuerigyOf9YXUbD/1b6tTpiz/HM+GR1 YsdoCXAmw/EA91iOR7yY3L1v470iu+IeqDt5j3RXyAJIxvbow73zR3w/BJDW44bj21tm v/aFtVquKc3WxtKr48MB/vyKv+ytw9fwe5qN6jg5ebYRGtOVcwP8zqp428MskLAUuwp2 kQuaaA+dV6hNeCMzq1SN/1yrwu6fozuk5qIYev8wv5T2GavkapQdv/GE0z0AHK7RdW+E Zf2PmihTpP64vszEoyfSuWtTM8DX+H7S/akeqS7JK0ghHx+qPGMnYOiyKkS0tMfAdXWD efJw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:in-reply-to:references:from:date :message-id:subject:to:cc; bh=bI1Bq6iont4vJvJSjNeGIPr54zuO7QEXVXe4/PuEAG8=; b=RjDMdXL1DBBN1UBZwafwtrdsXGPTHarRfqXg7JRqeCDLjUuV3m1BpfIS0A173FA/ZW cBq56+MmIyLDRzPjM/pWXktNcBRy0wuqLt9wxRoVLKzVF4k/cOn+UzN7Ou/Lt/Mz7acQ Ip3WnXA5/cLtqY1ICBkQMXyLvtz3I5fmXeEGCWmtp67Upf1lEPaFuxnr9F1gUPh5zaD+ x56YIa1HDp49/mM7C2XGNii5Meg3Cv/WeDztN0yRNUVJenY/Uv3aXVQV42VkA3cdzaG1 Ioz3xFukzDyikCSqco0apJXc7n+G4Iq27jAPTfiopExHPxqU6bOTwd0jxeziMAiIfzEo 9YMw== X-Gm-Message-State: AGi0PuYQ925C4mb/uAdtWlphs97HCWulkxS1OFCqAmWW/5AFXZ8Vvdwt KyH1Ubn5YHSPdE6lvrjb239sl0c8b4ViSzsh4xQ= X-Google-Smtp-Source: APiQypI/3ZMBQchNSBNcqXrpbU6UEbHvtwvop8rWHerpl+d7CXmNoZy501U7WD4yUUn8QvuD7ateqe4VxZEuCIqeFsY= X-Received: by 2002:a63:1210:: with SMTP id h16mr15714774pgl.328.1588583587644; Mon, 04 May 2020 02:13:07 -0700 (PDT) Original-Received: by 2002:a17:90a:9a86:0:0:0:0 with HTTP; Mon, 4 May 2020 02:13:06 -0700 (PDT) In-Reply-To: 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:179662 Archived-At: Hi all, I'd like to push back here a little, to what I originally raised because it's simple. In my case I couldn't find ~50% of the regex docs. I only continued to hunt because I knew it was there. In the linked question I gave () the questioner had to be actually told of the other section in the manual. The problem is the information is split into sections but without visibility from one section that the other exists. Solution: that's up to you. I'd say simply make one long list instead of 2 shorter, but if not that then *make a clear link between them*. The fact that they're split by some historic classification is true, but not IMO important any more - all I want is the basic property of findability. Unify these 2 islands or show a clear bridge between them, anything that stops one being being marooned for lack of visibility. Stefan's experience indicates a third island, also unbridged if I read him right. Make the relationship between these semantically related places highly visible is all I'm suggesting. cheers jan On 04/05/2020, Richard Stallman wrote: > [[[ 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. ]]] > > > The disposition of the regexp documentation could be improved, > > yes. Currently it's arranged by syntax, which is the implementor's > > view, rather than by function, which is the user's. > > Would you like to propose an ordering and classification by function? > Then we could think about whether it is better. > > -- > 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) > > >