From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#33541: 26; Doc string of `align-regexp' Date: Wed, 28 Nov 2018 09:26:25 -0800 (PST) Message-ID: <8aa04dea-d34b-4d58-9671-07e6e575c54d@default> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Trace: blaine.gmane.org 1543425923 5101 195.159.176.226 (28 Nov 2018 17:25:23 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Wed, 28 Nov 2018 17:25:23 +0000 (UTC) To: 33541@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Wed Nov 28 18:25:19 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 1gS3aQ-0001DE-I4 for geb-bug-gnu-emacs@m.gmane.org; Wed, 28 Nov 2018 18:25:18 +0100 Original-Received: from localhost ([::1]:49131 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gS3cW-0000T2-Of for geb-bug-gnu-emacs@m.gmane.org; Wed, 28 Nov 2018 12:27:28 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:35531) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gS3cH-0000O2-NL for bug-gnu-emacs@gnu.org; Wed, 28 Nov 2018 12:27:16 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1gS3cA-0001mt-E6 for bug-gnu-emacs@gnu.org; Wed, 28 Nov 2018 12:27:10 -0500 Original-Received: from debbugs.gnu.org ([208.118.235.43]:49462) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1gS3c6-0001dA-2g for bug-gnu-emacs@gnu.org; Wed, 28 Nov 2018 12:27:04 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1gS3c5-0003nQ-Pm for bug-gnu-emacs@gnu.org; Wed, 28 Nov 2018 12:27:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 28 Nov 2018 17:27:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 33541 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.154342601514578 (code B ref -1); Wed, 28 Nov 2018 17:27:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 28 Nov 2018 17:26:55 +0000 Original-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 Original-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 Original-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 Original-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 Original-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 Original-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 Original-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 Original-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== Original-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 Original-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 Original-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 X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4771.0 (x86)] 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-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:152862 Archived-At: 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''