From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#33541: 26; Doc string of `align-regexp' Date: Thu, 29 Nov 2018 09:23:36 +0200 Message-ID: <83bm68e493.fsf@gnu.org> References: <8aa04dea-d34b-4d58-9671-07e6e575c54d@default> <54ba7381c515b5019d5a0322ece9b35a@webmail.orcon.net.nz> NNTP-Posting-Host: blaine.gmane.org X-Trace: blaine.gmane.org 1543476339 6030 195.159.176.226 (29 Nov 2018 07:25:39 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Thu, 29 Nov 2018 07:25:39 +0000 (UTC) Cc: 33541@debbugs.gnu.org To: Phil Sainty Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Thu Nov 29 08:25:35 2018 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gSGha-0001Ub-Pr for geb-bug-gnu-emacs@m.gmane.org; Thu, 29 Nov 2018 08:25:34 +0100 Original-Received: from localhost ([::1]:52615 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gSGjh-0003rE-32 for geb-bug-gnu-emacs@m.gmane.org; Thu, 29 Nov 2018 02:27:45 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:53701) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gSGjM-0003mk-DN for bug-gnu-emacs@gnu.org; Thu, 29 Nov 2018 02:27:30 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1gSGgB-0006Uy-46 for bug-gnu-emacs@gnu.org; Thu, 29 Nov 2018 02:24:11 -0500 Original-Received: from debbugs.gnu.org ([208.118.235.43]:49770) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1gSGg8-0006R1-4M for bug-gnu-emacs@gnu.org; Thu, 29 Nov 2018 02:24:05 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1gSGg6-0006QR-3g for bug-gnu-emacs@gnu.org; Thu, 29 Nov 2018 02:24:03 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 29 Nov 2018 07:24:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 33541 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 33541-submit@debbugs.gnu.org id=B33541.154347621624666 (code B ref 33541); Thu, 29 Nov 2018 07:24:02 +0000 Original-Received: (at 33541) by debbugs.gnu.org; 29 Nov 2018 07:23:36 +0000 Original-Received: from localhost ([127.0.0.1]:54028 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gSGfg-0006Pm-K2 for submit@debbugs.gnu.org; Thu, 29 Nov 2018 02:23:36 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:42344) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gSGff-0006Pa-7I for 33541@debbugs.gnu.org; Thu, 29 Nov 2018 02:23:35 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1gSGfV-0005ff-BK for 33541@debbugs.gnu.org; Thu, 29 Nov 2018 02:23:30 -0500 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:44126) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gSGfV-0005fM-4V; Thu, 29 Nov 2018 02:23:25 -0500 Original-Received: from [176.228.60.248] (port=2631 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1gSGfT-0002NN-BY; Thu, 29 Nov 2018 02:23:25 -0500 In-reply-to: <54ba7381c515b5019d5a0322ece9b35a@webmail.orcon.net.nz> (message from Phil Sainty on Thu, 29 Nov 2018 12:22:18 +1300) 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: 208.118.235.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:152878 Archived-At: > Date: Thu, 29 Nov 2018 12:22:18 +1300 > From: Phil Sainty > Cc: 33541@debbugs.gnu.org > > I think the docstring is clear, provided that you read all of it; but > it could undoubtedly be improved, especially as this is a slightly > fiddly command to get to grips with. > > Perhaps your concern could be addressed by tweaking the paragraph > starting "REGEXP must contain at least one parenthesized subexpression" > so that it says: > > "Non-interactively, REGEXP must contain at least one parenthesized...." > > (which strictly speaking is perhaps less correct than what it says now, > yet I think in practice would make things slightly clearer.) > > I would also change "automatically added" to "automatically prefixed". Patches to improve that doc string are welcome.