From debbugs-submit-bounces@debbugs.gnu.org Wed Nov 28 12:26:55 2018 Received: (at submit) by debbugs.gnu.org; 28 Nov 2018 17:26:55 +0000 Received: from localhost ([127.0.0.1]:53720 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gS3by-0003n3-NU for submit@debbugs.gnu.org; Wed, 28 Nov 2018 12:26:55 -0500 Received: from eggs.gnu.org ([208.118.235.92]:53827) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gS3bs-0003mj-Sq for submit@debbugs.gnu.org; Wed, 28 Nov 2018 12:26:49 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1gS3bl-0000iH-Cl for submit@debbugs.gnu.org; Wed, 28 Nov 2018 12:26:43 -0500 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=0.8 required=5.0 tests=BAYES_50 autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:50170) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1gS3bl-0000hs-5w for submit@debbugs.gnu.org; Wed, 28 Nov 2018 12:26:41 -0500 Received: from eggs.gnu.org ([2001:4830:134:3::10]:35158) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gS3bi-0008Rq-By for bug-gnu-emacs@gnu.org; Wed, 28 Nov 2018 12:26:41 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1gS3bf-0000Pv-G6 for bug-gnu-emacs@gnu.org; Wed, 28 Nov 2018 12:26:38 -0500 Received: from aserp2120.oracle.com ([141.146.126.78]:54098) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1gS3bb-00009J-Ej for bug-gnu-emacs@gnu.org; Wed, 28 Nov 2018 12:26:33 -0500 Received: from pps.filterd (aserp2120.oracle.com [127.0.0.1]) by aserp2120.oracle.com (8.16.0.22/8.16.0.22) with SMTP id wASHJQsv064873 for ; Wed, 28 Nov 2018 17:26:27 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : subject : content-type : content-transfer-encoding; s=corp-2018-07-02; bh=EZxWthGqQzJw7wrnh8/Bt+BZ/Bao4yuMHM6ype+98xI=; b=2l57CUFz8nvF4u+ETGTP3Ipc6pi1ySZuxKZVzrW6zCvQvZOWs2yIQpstA5IDnvst9Hu/ 4rgJni+dbMCYACa4JNplTByOMgBGx7+Y5c0LiFK38qP5od4ENYcXYXVb+2EEEPQz7hL2 LHlR6l3kHAU4TZMvA4B75hE1953UOkV9kuZHDhMQOhzTgxio6F6hSP+WyS8cNi6b3J2v 30Ir9/TpordZ2HUo6CiIr2b6amrUveUIp6WFHARvtEmBq5Thu9UydHTtMnwdEC81kFIq MbWcS3rDnxEpd8TInbSQHIrBLIZSCrdzSOioD9ejByH2BxooEXnO+W5CUe5xMWPPInlP Aw== Received: from userv0021.oracle.com (userv0021.oracle.com [156.151.31.71]) by aserp2120.oracle.com with ESMTP id 2nxxkqkm2g-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Wed, 28 Nov 2018 17:26:27 +0000 Received: from userv0121.oracle.com (userv0121.oracle.com [156.151.31.72]) by userv0021.oracle.com (8.14.4/8.14.4) with ESMTP id wASHQQvM008568 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Wed, 28 Nov 2018 17:26:26 GMT Received: from abhmp0007.oracle.com (abhmp0007.oracle.com [141.146.116.13]) by userv0121.oracle.com (8.14.4/8.13.8) with ESMTP id wASHQQRn029166 for ; Wed, 28 Nov 2018 17:26:26 GMT MIME-Version: 1.0 Message-ID: <8aa04dea-d34b-4d58-9671-07e6e575c54d@default> Date: Wed, 28 Nov 2018 09:26:25 -0800 (PST) From: Drew Adams To: bug-gnu-emacs@gnu.org Subject: 26; Doc string of `align-regexp' X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4771.0 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Proofpoint-Virus-Version: vendor=nai engine=5900 definitions=9091 signatures=668686 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=1 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1811280151 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [generic] [fuzzy] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 2001:4830:134:3::11 X-Spam-Score: -4.0 (----) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -5.0 (-----) These two paragraphs seem to contradict each other: There is no predefined rule to handle this, but you could easily do it using a REGEXP like "(". Interactively, all you would have to do is to mark the region, call 'align-regexp' and enter that regular expression. REGEXP must contain at least one parenthesized subexpression, typically whitespace of the form "\\(\\s-*\\)". In normal interactive use, this is automatically added to the start of your regular expression after you enter it. You only need to supply the characters to be lined up, and any preceding whitespace is replaced. It cannot be the case that both (1) all you have to input as regexp is "(" and (2) the input regexp must contain a group subexpression. It's also unclear to say that REGEXP must contain... and also say that something gets added automatically to it. Yes, it's correct, provided a user interprets "REGEXP" only as the Lisp argument and not directly as the regexp she enters. Clearer wording would be welcome, distinguishing (1) what you have to input (do you need to include a group subexpression? even if it is the whitespace prefix "\\(\\s-*\\)"?) from what is required as the REGEXP argument to the function. In particular (minimum fix), it is incorrect to say 'you could easily do it using a REGEXP like "("'. There, REGEXP clearly must be the Lisp argument, not what you type interactively. REGEXP presumably always requires a group subexpression. In GNU Emacs 26.1 (build 1, x86_64-w64-mingw32) of 2018-05-30 Repository revision: 07f8f9bc5a51f5aa94eb099f3e15fbe0c20ea1ea Windowing system distributor `Microsoft Corp.', version 10.0.16299 Configured using: `configure --without-dbus --host=3Dx86_64-w64-mingw32 --without-compress-install 'CFLAGS=3D-O2 -static -g3'' From debbugs-submit-bounces@debbugs.gnu.org Wed Nov 28 18:22:22 2018 Received: (at 33541) by debbugs.gnu.org; 28 Nov 2018 23:22:22 +0000 Received: from localhost ([127.0.0.1]:53881 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gS99y-0003Ea-66 for submit@debbugs.gnu.org; Wed, 28 Nov 2018 18:22:22 -0500 Received: from smtp-1.orcon.net.nz ([60.234.4.34]:43554) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gS99w-0003ES-Fb for 33541@debbugs.gnu.org; Wed, 28 Nov 2018 18:22:20 -0500 Received: from [10.253.37.70] (port=41874 helo=webmail.orcon.net.nz) by smtp-1.orcon.net.nz with esmtpa (Exim 4.86_2) (envelope-from ) id 1gS99u-0007OC-5o; Thu, 29 Nov 2018 12:22:18 +1300 Received: from wlgwil-nat-office.catalyst.net.nz ([202.78.240.7]) via [10.253.37.253] by webmail.orcon.net.nz with HTTP (HTTP/1.1 POST); Thu, 29 Nov 2018 12:22:18 +1300 MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII; format=flowed Content-Transfer-Encoding: 7bit Date: Thu, 29 Nov 2018 12:22:18 +1300 From: Phil Sainty To: Drew Adams Subject: Re: bug#33541: 26; Doc string of `align-regexp' In-Reply-To: <8aa04dea-d34b-4d58-9671-07e6e575c54d@default> References: <8aa04dea-d34b-4d58-9671-07e6e575c54d@default> Message-ID: <54ba7381c515b5019d5a0322ece9b35a@webmail.orcon.net.nz> X-Sender: psainty@orcon.net.nz User-Agent: Orcon Webmail X-GeoIP: -- X-Spam_score: -2.9 X-Spam_score_int: -28 X-Spam_bar: -- X-Spam-Score: -0.7 (/) X-Debbugs-Envelope-To: 33541 Cc: 33541@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.7 (-) 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". -Phil On 2018-11-29 06:26, Drew Adams wrote: > These two paragraphs seem to contradict each other: > > There is no predefined rule to handle this, but you could easily do it > using a REGEXP like "(". Interactively, all you would have to do is > to mark the region, call 'align-regexp' and enter that regular > expression. > > REGEXP must contain at least one parenthesized subexpression, > typically > whitespace of the form "\\(\\s-*\\)". In normal interactive use, > this is automatically added to the start of your regular expression > after > you enter it. You only need to supply the characters to be lined up, > and > any preceding whitespace is replaced. > > It cannot be the case that both (1) all you have to input as regexp is > "(" and (2) the input regexp must contain a group subexpression. > > It's also unclear to say that REGEXP must contain... and also say that > something gets added automatically to it. > > Yes, it's correct, provided a user interprets "REGEXP" only as the Lisp > argument and not directly as the regexp she enters. Clearer wording > would be welcome, distinguishing (1) what you have to input (do you > need > to include a group subexpression? even if it is the whitespace prefix > "\\(\\s-*\\)"?) from what is required as the REGEXP argument to the > function. > > In particular (minimum fix), it is incorrect to say 'you could easily > do > it using a REGEXP like "("'. There, REGEXP clearly must be the Lisp > argument, not what you type interactively. REGEXP presumably always > requires a group subexpression. From debbugs-submit-bounces@debbugs.gnu.org Wed Nov 28 18:46:24 2018 Received: (at 33541) by debbugs.gnu.org; 28 Nov 2018 23:46:24 +0000 Received: from localhost ([127.0.0.1]:53892 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gS9XE-0003ng-Fw for submit@debbugs.gnu.org; Wed, 28 Nov 2018 18:46:24 -0500 Received: from userp2130.oracle.com ([156.151.31.86]:53280) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gS9XC-0003nS-N2 for 33541@debbugs.gnu.org; Wed, 28 Nov 2018 18:46:23 -0500 Received: from pps.filterd (userp2130.oracle.com [127.0.0.1]) by userp2130.oracle.com (8.16.0.22/8.16.0.22) with SMTP id wASNj85w012968; Wed, 28 Nov 2018 23:46:16 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : cc : subject : references : in-reply-to : content-type : content-transfer-encoding; s=corp-2018-07-02; bh=zx3bt7pmPBNpmBqTR6iLlUVu4As7cMdh10q6BGgJ/tM=; b=PH5Ajs/rCoJuJvti5ZxO7c36RzeBqcH5Q6ax3/08aphVHLdEHOkXRcD78riGaLVd6HWU Uc7gUPAvONgH1RwVgplbrnXhNU9M/O6V0Jq1PKRGGTJscjtIw7TcYIXMhTn8zbhOmy5R KGESLCEtyWEOZhHievVcTfuwbtALokZlIRm/pic6XtXzQRe1hxgu1wkmx9vlnHiW8fsQ X7R9DxckSuM8CfGs1G7TI84vozQSvFjs9XGGAiDLR6CMcL+Y5CurR0Gx1S6bLVHCkMcz /E1tT/NTG7e87GMtvzf7ObQclaOuTKdJ6MeRx78N58gk83Gxd3QdrFZ1HQ4KpaJn/nSv 1A== Received: from userv0021.oracle.com (userv0021.oracle.com [156.151.31.71]) by userp2130.oracle.com with ESMTP id 2nxx2udb0s-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Wed, 28 Nov 2018 23:46:16 +0000 Received: from aserv0121.oracle.com (aserv0121.oracle.com [141.146.126.235]) by userv0021.oracle.com (8.14.4/8.14.4) with ESMTP id wASNkADQ018219 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Wed, 28 Nov 2018 23:46:11 GMT Received: from abhmp0020.oracle.com (abhmp0020.oracle.com [141.146.116.26]) by aserv0121.oracle.com (8.14.4/8.13.8) with ESMTP id wASNkAdo004409; Wed, 28 Nov 2018 23:46:10 GMT MIME-Version: 1.0 Message-ID: Date: Wed, 28 Nov 2018 15:46:09 -0800 (PST) From: Drew Adams To: Phil Sainty Subject: RE: bug#33541: 26; Doc string of `align-regexp' References: <8aa04dea-d34b-4d58-9671-07e6e575c54d@default> <54ba7381c515b5019d5a0322ece9b35a@webmail.orcon.net.nz> In-Reply-To: <54ba7381c515b5019d5a0322ece9b35a@webmail.orcon.net.nz> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4771.0 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Proofpoint-Virus-Version: vendor=nai engine=5900 definitions=9091 signatures=668686 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=0 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1811280204 X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 33541 Cc: 33541@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > 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. I don't think so. > Perhaps your concern could be addressed by tweaking the paragraph > starting "REGEXP must contain at least one parenthesized subexpression" > so that it says: >=20 > "Non-interactively, REGEXP must contain at least one parenthesized...." >=20 > (which strictly speaking is perhaps less correct than what it says now, > yet I think in practice would make things slightly clearer.) That's in fact worse, as you say. The argument to the function is REGEXP. Just what REGEXP needs to be must be specified accurately. And what REGEXP needs to be has nothing to do with whether the function is invoked interactively. However, in addition to REGEXP needing to be specified precisely, we need to tell users what they need to input, to provide arg REGEXP to the function. Those are two different descriptions. Usually we describe a command first in terms of interactive use. In this case, that means in terms of describing what you need to input. Call it a pattern or whatever, or don't call it anything, but in any case don't call it REGEXP (the arg name) - what you input is not arg REGEXP. We can then say that from your input is constructed arg REGEXP, which is what is matched against... And there we can specify both REGEXP and how it is constructed from your input. The main problem is conflating arg REGEXP with the user input, which is a suffix of REGEXP. From debbugs-submit-bounces@debbugs.gnu.org Thu Nov 29 02:23:36 2018 Received: (at 33541) by debbugs.gnu.org; 29 Nov 2018 07:23:36 +0000 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 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 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 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-0.5 required=5.0 tests=BAYES_05 autolearn=disabled version=3.3.2 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 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 Date: Thu, 29 Nov 2018 09:23:36 +0200 Message-Id: <83bm68e493.fsf@gnu.org> From: Eli Zaretskii To: Phil Sainty In-reply-to: <54ba7381c515b5019d5a0322ece9b35a@webmail.orcon.net.nz> (message from Phil Sainty on Thu, 29 Nov 2018 12:22:18 +1300) Subject: Re: bug#33541: 26; Doc string of `align-regexp' References: <8aa04dea-d34b-4d58-9671-07e6e575c54d@default> <54ba7381c515b5019d5a0322ece9b35a@webmail.orcon.net.nz> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e X-Spam-Score: -5.0 (-----) X-Debbugs-Envelope-To: 33541 Cc: 33541@debbugs.gnu.org, drew.adams@oracle.com X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -6.0 (------) > 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. From debbugs-submit-bounces@debbugs.gnu.org Thu Nov 29 02:25:53 2018 Received: (at 33541) by debbugs.gnu.org; 29 Nov 2018 07:25:53 +0000 Received: from localhost ([127.0.0.1]:54032 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gSGht-0006TF-1m for submit@debbugs.gnu.org; Thu, 29 Nov 2018 02:25:53 -0500 Received: from eggs.gnu.org ([208.118.235.92]:43415) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gSGhr-0006T3-Ga for 33541@debbugs.gnu.org; Thu, 29 Nov 2018 02:25:51 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1gSGhh-0008BD-El for 33541@debbugs.gnu.org; Thu, 29 Nov 2018 02:25:46 -0500 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-0.0 required=5.0 tests=BAYES_20 autolearn=disabled version=3.3.2 Received: from fencepost.gnu.org ([2001:4830:134:3::e]:44154) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gSGhc-00087K-UQ; Thu, 29 Nov 2018 02:25:37 -0500 Received: from [176.228.60.248] (port=2767 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1gSGhc-0002b1-6Z; Thu, 29 Nov 2018 02:25:36 -0500 Date: Thu, 29 Nov 2018 09:25:49 +0200 Message-Id: <83a7lse45e.fsf@gnu.org> From: Eli Zaretskii To: Drew Adams In-reply-to: (message from Drew Adams on Wed, 28 Nov 2018 15:46:09 -0800 (PST)) Subject: Re: bug#33541: 26; Doc string of `align-regexp' References: <8aa04dea-d34b-4d58-9671-07e6e575c54d@default> <54ba7381c515b5019d5a0322ece9b35a@webmail.orcon.net.nz> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e X-Spam-Score: -5.0 (-----) X-Debbugs-Envelope-To: 33541 Cc: psainty@orcon.net.nz, 33541@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -6.0 (------) > Date: Wed, 28 Nov 2018 15:46:09 -0800 (PST) > From: Drew Adams > Cc: 33541@debbugs.gnu.org > > The argument to the function is REGEXP. Just what > REGEXP needs to be must be specified accurately. > And what REGEXP needs to be has nothing to do with > whether the function is invoked interactively. > > However, in addition to REGEXP needing to be specified > precisely, we need to tell users what they need to > input, to provide arg REGEXP to the function. > > Those are two different descriptions. > > Usually we describe a command first in terms of > interactive use. In this case, that means in terms > of describing what you need to input. Call it a > pattern or whatever, or don't call it anything, but > in any case don't call it REGEXP (the arg name) - > what you input is not arg REGEXP. > > We can then say that from your input is constructed > arg REGEXP, which is what is matched against... > And there we can specify both REGEXP and how it is > constructed from your input. > > The main problem is conflating arg REGEXP with the > user input, which is a suffix of REGEXP. I don't see how this doc string could be improved by just discussing it. Someone who understands well enough what the feature does should sit down and prepare more clear and coherent text, and then submit a patch. FWIW, I tried and didn't succeed too well. (Which should not discourage others from trying, of course.) TIA From debbugs-submit-bounces@debbugs.gnu.org Wed Oct 02 20:17:04 2019 Received: (at control) by debbugs.gnu.org; 3 Oct 2019 00:17:04 +0000 Received: from localhost ([127.0.0.1]:38541 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iFono-0002gZ-1m for submit@debbugs.gnu.org; Wed, 02 Oct 2019 20:17:04 -0400 Received: from mail-pf1-f175.google.com ([209.85.210.175]:32943) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iFonm-0002b9-BI for control@debbugs.gnu.org; Wed, 02 Oct 2019 20:17:02 -0400 Received: by mail-pf1-f175.google.com with SMTP id q10so578904pfl.0 for ; Wed, 02 Oct 2019 17:17:02 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:from:date:message-id:subject:to; bh=Qn7mwPEJ2L+3+W1eORoJ3c71GQZYF/4NYTnZOKFZgf0=; b=IzsAtCCKesUq01En9jWZdZBXevZFdp/zTNraHEDBIq2AZhcTALfJP7xo834pOGv3SJ x9R9OTictd8P0z0PwmwMpKDcFiwKRcfjdhU7ByCzNB4BZhktwr7WkDuC8iktgxBKde1Z lTifv1UTjTOwRg4F5MCdRSNcGQ2xkk9nY+b1TXM0YKLeK8bOo4QRnfmoSKb9ls5ohuyK oMZN9OSzQnjbFqKLJs9kz6HwOSjGPpoRI2WcuuRNpQLf/bR+ZwwsAgAw+XPwT4Tf47so LEBAB7Qxq+QjHaQYdbokDh6Iug83K4zpZ5NdH99TXoZRTLNoD/kLoruh4XXXuxMw8sbp 4GSQ== X-Gm-Message-State: APjAAAUWln/7DsUrnxfSJi9caf0QS2B91FNS29754XTOBckLAO/pUa7D JKABLydZH48DdkO0R5Q31VMfY9/EyaqvZQvv7f8sqy9f4IQ= X-Google-Smtp-Source: APXvYqwO3JI2OFWzYFIpNkJzFxgu6uaJ79n2j03bcmdJ32IXxulV8vh1s/T1tzMmv8S2cLmkK2X56i9dIHVesfLsHwo= X-Received: by 2002:a63:1310:: with SMTP id i16mr6122485pgl.200.1570061815961; Wed, 02 Oct 2019 17:16:55 -0700 (PDT) MIME-Version: 1.0 From: Stefan Kangas Date: Thu, 3 Oct 2019 02:16:44 +0200 Message-ID: Subject: To: control@debbugs.gnu.org Content-Type: text/plain; charset="UTF-8" X-Spam-Score: 2.3 (++) X-Spam-Report: Spam detection software, running on the system "debbugs.gnu.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see the administrator of that system for details. Content preview: severity 33541 wishlist quit Content analysis details: (2.3 points, 10.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- 0.0 SPF_HELO_NONE SPF: HELO does not publish an SPF Record -0.0 SPF_PASS SPF: sender matches SPF record 0.0 FREEMAIL_FROM Sender email is commonly abused enduser mail provider (stefankangas[at]gmail.com) 0.2 HEADER_FROM_DIFFERENT_DOMAINS From and EnvelopeFrom 2nd level mail domains are different -0.0 RCVD_IN_DNSWL_NONE RBL: Sender listed at https://www.dnswl.org/, no trust [209.85.210.175 listed in list.dnswl.org] 2.0 BLANK_SUBJECT Subject is present but empty 0.0 FREEMAIL_FORGED_FROMDOMAIN 2nd level domains in From and EnvelopeFrom freemail headers are different X-Debbugs-Envelope-To: control X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: 1.3 (+) X-Spam-Report: Spam detection software, running on the system "debbugs.gnu.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see the administrator of that system for details. Content preview: severity 33541 wishlist quit Content analysis details: (1.3 points, 10.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -0.0 RCVD_IN_DNSWL_NONE RBL: Sender listed at https://www.dnswl.org/, no trust [209.85.210.175 listed in list.dnswl.org] 0.0 SPF_HELO_NONE SPF: HELO does not publish an SPF Record -0.0 SPF_PASS SPF: sender matches SPF record 0.0 FREEMAIL_FROM Sender email is commonly abused enduser mail provider (stefankangas[at]gmail.com) 0.2 HEADER_FROM_DIFFERENT_DOMAINS From and EnvelopeFrom 2nd level mail domains are different -1.0 MAILING_LIST_MULTI Multiple indicators imply a widely-seen list manager 2.0 BLANK_SUBJECT Subject is present but empty 0.0 FREEMAIL_FORGED_FROMDOMAIN 2nd level domains in From and EnvelopeFrom freemail headers are different severity 33541 wishlist quit From debbugs-submit-bounces@debbugs.gnu.org Wed Sep 22 18:19:22 2021 Received: (at 33541) by debbugs.gnu.org; 22 Sep 2021 22:19:22 +0000 Received: from localhost ([127.0.0.1]:52062 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mTAaI-0008Qv-Dk for submit@debbugs.gnu.org; Wed, 22 Sep 2021 18:19:22 -0400 Received: from quimby.gnus.org ([95.216.78.240]:35158) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mTAaF-0008Qd-N0 for 33541@debbugs.gnu.org; Wed, 22 Sep 2021 18:19:20 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnus.org; s=20200322; h=Content-Type:MIME-Version:Message-ID:In-Reply-To:Date: References:Subject:Cc:To:From:Sender:Reply-To:Content-Transfer-Encoding: Content-ID:Content-Description:Resent-Date:Resent-From:Resent-Sender: Resent-To:Resent-Cc:Resent-Message-ID:List-Id:List-Help:List-Unsubscribe: List-Subscribe:List-Post:List-Owner:List-Archive; bh=ShSiayIl4ukjTevZo5TvWP4qKKUhcbU1o8IYK8h63Os=; b=KJWHhEw4n9Q3ghEYpTRCFHbksm /1J53LwZRsKqu4kK/vfepHGbZ4gZEopt86sSL4XagUL7qlaR2m8soWPJGvkMfaWtliVDJLlPBOhE/ XRVb7rywUKU4O4baCDCPYeptlIaZp9ejfaAK1MfyLSPEYy091BlnP3l6HlX00w9kdOcU=; Received: from [84.212.220.105] (helo=elva) by quimby.gnus.org with esmtpsa (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1mTAa3-00080C-8C; Thu, 23 Sep 2021 00:19:10 +0200 From: Lars Ingebrigtsen To: Eli Zaretskii Subject: Re: bug#33541: 26; Doc string of `align-regexp' References: <8aa04dea-d34b-4d58-9671-07e6e575c54d@default> <54ba7381c515b5019d5a0322ece9b35a@webmail.orcon.net.nz> <83a7lse45e.fsf@gnu.org> X-Now-Playing: The Meters's _Gettin' Funkier All The Time (6): Be My Lady [New Directions]_: "Be My Lady" Date: Thu, 23 Sep 2021 00:19:06 +0200 In-Reply-To: <83a7lse45e.fsf@gnu.org> (Eli Zaretskii's message of "Thu, 29 Nov 2018 09:25:49 +0200") Message-ID: <87v92sp82t.fsf@gnus.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Report: Spam detection software, running on the system "quimby.gnus.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see @@CONTACT_ADDRESS@@ for details. Content preview: Eli Zaretskii writes: > I don't see how this doc string could be improved by just discussing > it. Someone who understands well enough what the feature does should > sit down and prepare more clear and coherent text, and t [...] Content analysis details: (-2.9 points, 5.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -1.0 ALL_TRUSTED Passed through trusted hosts only via SMTP -1.9 BAYES_00 BODY: Bayes spam probability is 0 to 1% [score: 0.0000] X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 33541 Cc: psainty@orcon.net.nz, 33541@debbugs.gnu.org, Drew Adams X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) Eli Zaretskii writes: > I don't see how this doc string could be improved by just discussing > it. Someone who understands well enough what the feature does should > sit down and prepare more clear and coherent text, and then submit a > patch. I've now tried to make the doc string more coherent by emphasising what's being added interactively, and what REGEXP has to actually contain in Emacs 28. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no From debbugs-submit-bounces@debbugs.gnu.org Wed Sep 22 18:19:28 2021 Received: (at control) by debbugs.gnu.org; 22 Sep 2021 22:19:28 +0000 Received: from localhost ([127.0.0.1]:52065 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mTAaL-0008RA-KR for submit@debbugs.gnu.org; Wed, 22 Sep 2021 18:19:28 -0400 Received: from quimby.gnus.org ([95.216.78.240]:35174) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mTAaI-0008Qi-L6 for control@debbugs.gnu.org; Wed, 22 Sep 2021 18:19:22 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnus.org; s=20200322; h=Subject:From:To:Message-Id:Date:Sender:Reply-To:Cc: MIME-Version:Content-Type:Content-Transfer-Encoding:Content-ID: Content-Description:Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc :Resent-Message-ID:In-Reply-To:References:List-Id:List-Help:List-Unsubscribe: List-Subscribe:List-Post:List-Owner:List-Archive; bh=V5/RrZ6ZCqC/6ELAhgOfHFJ8Zpcvx1+8VgY/FqeyaX0=; b=hypRhzqFpLgw9IsM/06neAwxom Q2cGEx4mGswkUSFXAKqc/h1TCcrRh0Dw03CB56S9GZ1Pz6k1Tq5szO3f7EwKR05zjpsOQHp3Tuu0s 5PwY43G+C1I1oQnDDBmjcdc4QXvErAsHN1xtVxshvIgxc4liSFWWTT8w1meJz9hoNxAE=; Received: from [84.212.220.105] (helo=elva) by quimby.gnus.org with esmtpsa (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1mTAa9-00080K-SQ for control@debbugs.gnu.org; Thu, 23 Sep 2021 00:19:16 +0200 Date: Thu, 23 Sep 2021 00:19:13 +0200 Message-Id: <87tuicp82m.fsf@gnus.org> To: control@debbugs.gnu.org From: Lars Ingebrigtsen Subject: control message for bug #33541 X-Spam-Report: Spam detection software, running on the system "quimby.gnus.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see @@CONTACT_ADDRESS@@ for details. Content preview: close 33541 28.1 quit Content analysis details: (-2.9 points, 5.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -1.0 ALL_TRUSTED Passed through trusted hosts only via SMTP -1.9 BAYES_00 BODY: Bayes spam probability is 0 to 1% [score: 0.0000] X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: control X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) close 33541 28.1 quit From unknown Sun Jun 22 17:12:42 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Thu, 21 Oct 2021 11:24:07 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator