From debbugs-submit-bounces@debbugs.gnu.org Fri Feb 26 00:17:48 2016 Received: (at submit) by debbugs.gnu.org; 26 Feb 2016 05:17:48 +0000 Received: from localhost ([127.0.0.1]:46590 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84) (envelope-from ) id 1aZAmh-0003M4-Vb for submit@debbugs.gnu.org; Fri, 26 Feb 2016 00:17:48 -0500 Received: from eggs.gnu.org ([208.118.235.92]:36122) by debbugs.gnu.org with esmtp (Exim 4.84) (envelope-from ) id 1aZAmf-0003Lq-Nd for submit@debbugs.gnu.org; Fri, 26 Feb 2016 00:17:46 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aZAmZ-0003fK-Ud for submit@debbugs.gnu.org; Fri, 26 Feb 2016 00:17:40 -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]:38586) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aZAmZ-0003fG-RU for submit@debbugs.gnu.org; Fri, 26 Feb 2016 00:17:39 -0500 Received: from eggs.gnu.org ([2001:4830:134:3::10]:55324) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aZAmZ-0006vb-0H for bug-gnu-emacs@gnu.org; Fri, 26 Feb 2016 00:17:39 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aZAmV-0003ep-0X for bug-gnu-emacs@gnu.org; Fri, 26 Feb 2016 00:17:38 -0500 Received: from userp1040.oracle.com ([156.151.31.81]:34573) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aZAmU-0003eT-Om for bug-gnu-emacs@gnu.org; Fri, 26 Feb 2016 00:17:34 -0500 Received: from aserv0022.oracle.com (aserv0022.oracle.com [141.146.126.234]) by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id u1Q5HWEI032552 (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Fri, 26 Feb 2016 05:17:32 GMT Received: from aserv0121.oracle.com (aserv0121.oracle.com [141.146.126.235]) by aserv0022.oracle.com (8.13.8/8.13.8) with ESMTP id u1Q5HVQn006453 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL) for ; Fri, 26 Feb 2016 05:17:31 GMT Received: from abhmp0018.oracle.com (abhmp0018.oracle.com [141.146.116.24]) by aserv0121.oracle.com (8.13.8/8.13.8) with ESMTP id u1Q5HVOn023566 for ; Fri, 26 Feb 2016 05:17:31 GMT MIME-Version: 1.0 Message-ID: Date: Thu, 25 Feb 2016 21:17:30 -0800 (PST) From: Drew Adams To: bug-gnu-emacs@gnu.org Subject: 24.5; doc string of `apropos-variable' - mention C-u X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9 (901082) [OL 12.0.6691.5000 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Source-IP: aserv0022.oracle.com [141.146.126.234] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 2001:4830:134:3::11 X-Spam-Score: 1.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: 1.0 (+) Subject line says it all. The doc string says something about Lisp argument DO-NOT-ALL, but it does not speak to an interactive user, telling her that C-u gives that behavior. In GNU Emacs 24.5.1 (i686-pc-mingw32) of 2015-04-11 on LEG570 Windowing system distributor `Microsoft Corp.', version 6.1.7601 Configured using: `configure --prefix=3D/c/usr --host=3Di686-pc-mingw32' From debbugs-submit-bounces@debbugs.gnu.org Fri Feb 26 08:16:14 2016 Received: (at 22813) by debbugs.gnu.org; 26 Feb 2016 13:16:14 +0000 Received: from localhost ([127.0.0.1]:47020 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84) (envelope-from ) id 1aZIFi-0001Y5-HA for submit@debbugs.gnu.org; Fri, 26 Feb 2016 08:16:14 -0500 Received: from mail-oi0-f51.google.com ([209.85.218.51]:33786) by debbugs.gnu.org with esmtp (Exim 4.84) (envelope-from ) id 1aZIFh-0001Xr-0B for 22813@debbugs.gnu.org; Fri, 26 Feb 2016 08:16:13 -0500 Received: by mail-oi0-f51.google.com with SMTP id j125so62195225oih.0 for <22813@debbugs.gnu.org>; Fri, 26 Feb 2016 05:16:12 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:from:date:message-id:subject:to; bh=dfQjij18LGXjMQ6IHxDCn5mosQu9m7B7dCv3Uo0zTAk=; b=NKlZfgPmYCmmBCwTqAq8gztbuzOHnnz7aiah2StsIFp/D86Uie34Xcd2EILhhbQPmn 8aXCukJdTvOYmLkR3kdiNadIvRLQL3xU/4WmkcOdLBDsvSNFwJL0vZKXXbO0lHjtDd02 X+YnRELWvfnErdjJ22AnXj8sUevBGf+u2MkfOQc0kEKk9VCg6fjoiY6hdUoLXjonLVgK YauaSWUZIUXJlo/12Gu4TKSqAAcJxJwpna6JAcnqPcBHZacxvc4RyeB78RGfhrRNerxm hRrmup3Oy+NyvSQpt6oVQ4BU8uZvdN2OCznOWYgxfhRhaUIolSTt3f8QbdUtSQTI61SE p6+Q== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:mime-version:from:date:message-id:subject:to; bh=dfQjij18LGXjMQ6IHxDCn5mosQu9m7B7dCv3Uo0zTAk=; b=aL4VXceZGDhin5Q2Nvpf5vZ2boMshftlDd65nFC2NMFyykYHbyiM4NjFkqs1hJUU7B 32nOxIaR0Od1yO+vnvXGZPqeDRbt9MnCOBZYd7v3U/NYR3/8iVRznQdkkc0MRYZW7ycE aeuKTdHQbOEzXPSmyDlBK9S3e+3q/Ca6l+VC04lLxcQAp9jOTqWBZrcbf9CcgPnaWa/t 25iTq/ahsvSk6T0ZsS0rAiiIvJQxu6BJWb8z+oL5OswtaUdg+LSyytIsM878/s5vSuHi oqoeFzTPm/VquchQE5VTh7gj7vum96MRebfOQa9dHOD4Jit3INnmvQ6TBHEX48+MOWJv zJow== X-Gm-Message-State: AD7BkJLgJw80eL5m1g5zkQeTGrc931VCl3pPzc8hvwnHMSzbNOVNFt1JKxU5p4Y6uSE8vI7dJYTBVnE9R/YYxg== X-Received: by 10.202.77.11 with SMTP id a11mr1028980oib.23.1456492567082; Fri, 26 Feb 2016 05:16:07 -0800 (PST) MIME-Version: 1.0 Received: by 10.202.172.198 with HTTP; Fri, 26 Feb 2016 05:15:27 -0800 (PST) From: Kaushal Modi Date: Fri, 26 Feb 2016 08:15:27 -0500 Message-ID: Subject: 24.5; doc string of `apropos-variable' - mention C-u To: 22813@debbugs.gnu.org Content-Type: multipart/alternative; boundary=001a11494d0e1441df052cac1aee X-Spam-Score: -0.7 (/) X-Debbugs-Envelope-To: 22813 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: -0.7 (/) --001a11494d0e1441df052cac1aee Content-Type: text/plain; charset=UTF-8 In the emacs-25 branch, I see the doc-string for apropos-variable as: "Show variables that match PATTERN. When DO-NOT-ALL is non-nil, show user options only, i.e. behave like `apropos-user-option'." How about the below patch: diff --git a/lisp/apropos.el b/lisp/apropos.el index 3c1a413..fdd85b4 100644 --- a/lisp/apropos.el +++ b/lisp/apropos.el @@ -505,7 +505,7 @@ apropos-user-option ;;;###autoload (defun apropos-variable (pattern &optional do-not-all) "Show variables that match PATTERN. -When DO-NOT-ALL is non-nil, show user options only, i.e. behave +With prefix argument DO-NOT-ALL non-nil, show user options only, i.e. behave like `apropos-user-option'." (interactive (list (apropos-read-pattern (if current-prefix-arg "user option" "variable")) I simply added the term "prefix argument" (based on the doc-string of quit-window). -- Kaushal Modi --001a11494d0e1441df052cac1aee Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable
In the emacs-25 branch, I see the doc-string for apropos-v= ariable as:

"Show variables that match PATTERN.When DO-NOT-ALL is non-nil, show user options only, i.e. behave
= like `apropos-user-option'."

How about th= e below patch:

diff --git a/lisp/apropos.el b= /lisp/apropos.el
index 3c1a413..fdd85b4 100644
--- a/li= sp/apropos.el
+++ b/lisp/apropos.el
@@ -505,7 +505,7 @@= apropos-user-option
=C2=A0;;;###autoload
=C2=A0(defun = apropos-variable (pattern &optional do-not-all)
=C2=A0 =C2=A0= "Show variables that match PATTERN.
-When DO-NOT-ALL is non-= nil, show user options only, i.e. behave
+With prefix argument DO= -NOT-ALL non-nil, show user options only, i.e. behave
=C2=A0like = `apropos-user-option'."
=C2=A0 =C2=A0(interactive (list = (apropos-read-pattern
=C2=A0 =C2=A0 =C2=A0 =C2=A0(if current-prefix-arg "user optio= n" "variable"))


I simply added the term "prefix argument" (based on the doc-str= ing of quit-window).

--
Kaushal Modi
--001a11494d0e1441df052cac1aee-- From debbugs-submit-bounces@debbugs.gnu.org Fri Feb 26 09:15:18 2016 Received: (at 22813) by debbugs.gnu.org; 26 Feb 2016 14:15:18 +0000 Received: from localhost ([127.0.0.1]:47052 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84) (envelope-from ) id 1aZJAs-0004dN-MA for submit@debbugs.gnu.org; Fri, 26 Feb 2016 09:15:18 -0500 Received: from eggs.gnu.org ([208.118.235.92]:58162) by debbugs.gnu.org with esmtp (Exim 4.84) (envelope-from ) id 1aZJAr-0004dA-Cd for 22813@debbugs.gnu.org; Fri, 26 Feb 2016 09:15:17 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aZJAi-0004Sk-BW for 22813@debbugs.gnu.org; Fri, 26 Feb 2016 09:15:12 -0500 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00,RP_MATCHES_RCVD autolearn=disabled version=3.3.2 Received: from fencepost.gnu.org ([2001:4830:134:3::e]:49069) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aZJAi-0004SW-84; Fri, 26 Feb 2016 09:15:08 -0500 Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:2234 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_128_CBC_SHA1:128) (Exim 4.82) (envelope-from ) id 1aZJAg-0001GM-1T; Fri, 26 Feb 2016 09:15:06 -0500 Date: Fri, 26 Feb 2016 16:14:54 +0200 Message-Id: <834mcveext.fsf@gnu.org> From: Eli Zaretskii To: Kaushal Modi In-reply-to: (message from Kaushal Modi on Fri, 26 Feb 2016 08:15:27 -0500) Subject: Re: bug#22813: 24.5; doc string of `apropos-variable' - mention C-u References: 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: 22813 Cc: 22813@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: , Reply-To: Eli Zaretskii Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -5.0 (-----) > From: Kaushal Modi > Date: Fri, 26 Feb 2016 08:15:27 -0500 > > --- a/lisp/apropos.el > +++ b/lisp/apropos.el > @@ -505,7 +505,7 @@ apropos-user-option > ;;;###autoload > (defun apropos-variable (pattern &optional do-not-all) > "Show variables that match PATTERN. > -When DO-NOT-ALL is non-nil, show user options only, i.e. behave > +With prefix argument DO-NOT-ALL non-nil, show user options only, i.e. behave > like `apropos-user-option'." Thanks. However, this is not the best way of expressing the behavior wrt prefix arguments. Here's an example of how we do this elsewhere: (defun jump-to-register (register &optional delete) "Move point to location stored in a register. If the register contains a file name, find that file. \(To put a file name in a register, you must use `set-register'.) If the register contains a window configuration (one frame) or a frameset \(all frames), restore that frame or all frames accordingly. First argument is a character, naming the register. Optional second arg non-nil (interactively, prefix argument) says to ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ delete any existing frames that the frameset doesn't mention. ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ From debbugs-submit-bounces@debbugs.gnu.org Fri Feb 26 09:33:31 2016 Received: (at 22813) by debbugs.gnu.org; 26 Feb 2016 14:33:31 +0000 Received: from localhost ([127.0.0.1]:47061 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84) (envelope-from ) id 1aZJSV-00054z-8b for submit@debbugs.gnu.org; Fri, 26 Feb 2016 09:33:31 -0500 Received: from userp1040.oracle.com ([156.151.31.81]:43500) by debbugs.gnu.org with esmtp (Exim 4.84) (envelope-from ) id 1aZJST-00054m-EY for 22813@debbugs.gnu.org; Fri, 26 Feb 2016 09:33:29 -0500 Received: from aserv0022.oracle.com (aserv0022.oracle.com [141.146.126.234]) by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id u1QEXMgu027015 (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Fri, 26 Feb 2016 14:33:23 GMT Received: from userv0122.oracle.com (userv0122.oracle.com [156.151.31.75]) by aserv0022.oracle.com (8.13.8/8.13.8) with ESMTP id u1QEXMAV017747 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL); Fri, 26 Feb 2016 14:33:22 GMT Received: from abhmp0018.oracle.com (abhmp0018.oracle.com [141.146.116.24]) by userv0122.oracle.com (8.14.4/8.14.4) with ESMTP id u1QEXLxk000685; Fri, 26 Feb 2016 14:33:21 GMT MIME-Version: 1.0 Message-ID: <3c8ac019-cb35-4654-b747-c2eb6493cdd6@default> Date: Fri, 26 Feb 2016 06:33:20 -0800 (PST) From: Drew Adams To: Kaushal Modi , 22813@debbugs.gnu.org Subject: RE: bug#22813: 24.5; doc string of `apropos-variable' - mention C-u References: In-Reply-To: X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9 (901082) [OL 12.0.6691.5000 (x86)] Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Source-IP: aserv0022.oracle.com [141.146.126.234] X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 22813 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: -2.3 (--) > How about the below patch: >=20 > -When DO-NOT-ALL is non-nil, show user options only, i.e. behave > +With prefix argument DO-NOT-ALL non-nil, show user options only, Conventionally we address doc strings for commands to an interactive user. We say something like "With a prefix argument...", not mentioning it by name as a parameter. We may also (at the end) say something like "When called from Lisp, DO-NOT-ALL..." IOW, the interactive user gets a coherent description that does not involve Lisp parameters s?he need not bother with. From debbugs-submit-bounces@debbugs.gnu.org Fri Feb 26 09:40:24 2016 Received: (at 22813) by debbugs.gnu.org; 26 Feb 2016 14:40:24 +0000 Received: from localhost ([127.0.0.1]:47070 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84) (envelope-from ) id 1aZJZA-0005FK-7f for submit@debbugs.gnu.org; Fri, 26 Feb 2016 09:40:24 -0500 Received: from aserp1040.oracle.com ([141.146.126.69]:30011) by debbugs.gnu.org with esmtp (Exim 4.84) (envelope-from ) id 1aZJZ8-0005F4-Hd for 22813@debbugs.gnu.org; Fri, 26 Feb 2016 09:40:22 -0500 Received: from userv0022.oracle.com (userv0022.oracle.com [156.151.31.74]) by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id u1QEeGAj023863 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 26 Feb 2016 14:40:16 GMT Received: from aserv0121.oracle.com (aserv0121.oracle.com [141.146.126.235]) by userv0022.oracle.com (8.14.4/8.13.8) with ESMTP id u1QEeFbQ008672 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL); Fri, 26 Feb 2016 14:40:16 GMT Received: from abhmp0018.oracle.com (abhmp0018.oracle.com [141.146.116.24]) by aserv0121.oracle.com (8.13.8/8.13.8) with ESMTP id u1QEeFUQ001139; Fri, 26 Feb 2016 14:40:15 GMT MIME-Version: 1.0 Message-ID: Date: Fri, 26 Feb 2016 06:40:14 -0800 (PST) From: Drew Adams To: Kaushal Modi , 22813@debbugs.gnu.org Subject: RE: bug#22813: 24.5; doc string of `apropos-variable' - mention C-u References: <3c8ac019-cb35-4654-b747-c2eb6493cdd6@default> In-Reply-To: <3c8ac019-cb35-4654-b747-c2eb6493cdd6@default> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9 (901082) [OL 12.0.6691.5000 (x86)] Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Source-IP: userv0022.oracle.com [156.151.31.74] X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 22813 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: -2.3 (--) > Conventionally we address doc strings for commands to an interactive > user. >=20 > We say something like "With a prefix argument...", not mentioning it > by > name as a parameter. We may also (at the end) say something like > "When called from Lisp, DO-NOT-ALL..." IOW, the interactive user > gets a coherent description that does not involve Lisp parameters > s?he need not bother with. Eli's response was better than mine. From debbugs-submit-bounces@debbugs.gnu.org Fri Feb 26 09:53:21 2016 Received: (at 22813) by debbugs.gnu.org; 26 Feb 2016 14:53:21 +0000 Received: from localhost ([127.0.0.1]:47079 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84) (envelope-from ) id 1aZJlh-0005Yl-KE for submit@debbugs.gnu.org; Fri, 26 Feb 2016 09:53:21 -0500 Received: from mail-oi0-f42.google.com ([209.85.218.42]:33511) by debbugs.gnu.org with esmtp (Exim 4.84) (envelope-from ) id 1aZJlg-0005YX-4N for 22813@debbugs.gnu.org; Fri, 26 Feb 2016 09:53:20 -0500 Received: by mail-oi0-f42.google.com with SMTP id j125so63962823oih.0 for <22813@debbugs.gnu.org>; Fri, 26 Feb 2016 06:53:20 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:in-reply-to:references:from:date:message-id:subject:to :cc; bh=VPoeKRF9jsJ/Xcnw7cpsAND8U8a8iY8XVDef8p0Vf0Y=; b=hs4F7VJOcPqZ3AoafRTCmiHGoGvRswPsIYAXaTgAv98kSpM29BpBCTGC6gWGOhchLc aiWHjJDGul5WhTowSj7ziB6TKzneVBzw6Gi8peHrVaYwO/LfCMoSO+C5re2y4V54wkoL 4RQhdV7k3H3dNIJ36FR0GG5UT/tm+2R6nS3UbvHiYwwKaSIilBEB1Zp+x1HfQmbwxMvJ qaEXKSwhnobLIpYD4Hw3kKk+MRoVrj4ZLNLE7TMCkiSi7VqUNhq8JfrTimPb+9KHlIYj neeraB+qzAr0KonjPzE/CFqAySAhEsdYs05qVJqWir6tIpFEoc2sUP+eysZ/fpkkREcx hYIg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:mime-version:in-reply-to:references:from:date :message-id:subject:to:cc; bh=VPoeKRF9jsJ/Xcnw7cpsAND8U8a8iY8XVDef8p0Vf0Y=; b=O0NHTlDqC4+TypA7VWF6dccjCIFUffsWM5Bp51HdP/W7ZNJAtzdvpv2+GtMhn/Sp2T TgHzXwPgIeZ7tUom1bfGvAzPq/wECEydgBS1k2c7Lfvv/cmuD2ihqf1FJV74FwW6jfhj HBFTGYi++KgMOACu1cat/bWLb3hR/wdp/yzOoRBfdhIK1GcC9aMJpePfATFwkaFYGKC1 qWj+j0YS+c+l2ECiAwcZahZEmupsAFrXCVB6jG6lnf9Oy1qsqDy2co6i4ECf9l8FYN2W 03U+cbWihJ+RIkZayYnA+FFjoIaElFTQE7mYW0PkJmFkriWsxd6xhhThAStbJVGfJsjd ZJcg== X-Gm-Message-State: AD7BkJJbn4rGyYOaTP3uByMfvNcxoP0KkN6kDlL8P5+lqpn5xTLLtxMbSov5pVmorATFerqUL3HjQPbbdFiJOw== X-Received: by 10.202.72.129 with SMTP id v123mr1384571oia.116.1456498394401; Fri, 26 Feb 2016 06:53:14 -0800 (PST) MIME-Version: 1.0 Received: by 10.202.172.198 with HTTP; Fri, 26 Feb 2016 06:52:34 -0800 (PST) In-Reply-To: References: <3c8ac019-cb35-4654-b747-c2eb6493cdd6@default> From: Kaushal Modi Date: Fri, 26 Feb 2016 09:52:34 -0500 Message-ID: Subject: Re: bug#22813: 24.5; doc string of `apropos-variable' - mention C-u To: Drew Adams , Eli Zaretskii Content-Type: multipart/alternative; boundary=001a1135a77c6a1256052cad7566 X-Spam-Score: -0.7 (/) X-Debbugs-Envelope-To: 22813 Cc: 22813@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: -0.7 (/) --001a1135a77c6a1256052cad7566 Content-Type: text/plain; charset=UTF-8 I get the point now. How about this: diff --git a/lisp/apropos.el b/lisp/apropos.el index 3c1a413..a2bfee9 100644 --- a/lisp/apropos.el +++ b/lisp/apropos.el @@ -505,7 +505,8 @@ apropos-user-option ;;;###autoload (defun apropos-variable (pattern &optional do-not-all) "Show variables that match PATTERN. -When DO-NOT-ALL is non-nil, show user options only, i.e. behave +With the optional argument DO-NOT-ALL non-nil (or when called interactively with +the prefix \\[universal-argument]), show user options only, i.e. behave like `apropos-user-option'." (interactive (list (apropos-read-pattern (if current-prefix-arg "user option" "variable")) --001a1135a77c6a1256052cad7566 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable
I get the point now. How about = this:

=
diff --git a/lisp/apropos.el b/lisp/apropos.el
index 3c1a413..a2bfee9 100644
--- a/lisp/apropos.el
+++= b/lisp/apropos.el
@@ -505,7 +505,8 @@ apro= pos-user-option
=C2=A0;;;###autoload
<= div class=3D"gmail_extra">=C2=A0(defun apropos-variable (pattern &optio= nal do-not-all)
=C2=A0 =C2=A0"Show var= iables that match PATTERN.
-When DO-NOT-ALL= is non-nil, show user options only, i.e. behave
+With the optional argument DO-NOT-ALL non-nil (or when called intera= ctively with
+the prefix \\[universal-argum= ent]), show user options only, i.e. behave
= =C2=A0like `apropos-user-option'."
=C2=A0 =C2=A0(interactive (list (apropos-read-pattern
=C2=A0 =C2= =A0 =C2=A0 =C2=A0(if current-prefix-arg "user option" "varia= ble"))

--001a1135a77c6a1256052cad7566-- From debbugs-submit-bounces@debbugs.gnu.org Fri Feb 26 10:42:03 2016 Received: (at 22813) by debbugs.gnu.org; 26 Feb 2016 15:42:03 +0000 Received: from localhost ([127.0.0.1]:47805 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84) (envelope-from ) id 1aZKWp-0006vU-J2 for submit@debbugs.gnu.org; Fri, 26 Feb 2016 10:42:03 -0500 Received: from eggs.gnu.org ([208.118.235.92]:54244) by debbugs.gnu.org with esmtp (Exim 4.84) (envelope-from ) id 1aZKWo-0006ux-97 for 22813@debbugs.gnu.org; Fri, 26 Feb 2016 10:42:02 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aZKWe-0005LR-9g for 22813@debbugs.gnu.org; Fri, 26 Feb 2016 10:41:56 -0500 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00,RP_MATCHES_RCVD autolearn=disabled version=3.3.2 Received: from fencepost.gnu.org ([2001:4830:134:3::e]:50256) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aZKWe-0005LG-6u; Fri, 26 Feb 2016 10:41:52 -0500 Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:3239 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_128_CBC_SHA1:128) (Exim 4.82) (envelope-from ) id 1aZKWc-0002OP-Ua; Fri, 26 Feb 2016 10:41:51 -0500 Date: Fri, 26 Feb 2016 17:41:37 +0200 Message-Id: <8337sfeaxa.fsf@gnu.org> From: Eli Zaretskii To: Kaushal Modi In-reply-to: (message from Kaushal Modi on Fri, 26 Feb 2016 09:52:34 -0500) Subject: Re: bug#22813: 24.5; doc string of `apropos-variable' - mention C-u References: <3c8ac019-cb35-4654-b747-c2eb6493cdd6@default> 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: 22813 Cc: 22813@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: , Reply-To: Eli Zaretskii Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -5.0 (-----) > From: Kaushal Modi > Date: Fri, 26 Feb 2016 09:52:34 -0500 > Cc: 22813@debbugs.gnu.org > > I get the point now. How about this: > > diff --git a/lisp/apropos.el b/lisp/apropos.el > index 3c1a413..a2bfee9 100644 > --- a/lisp/apropos.el > +++ b/lisp/apropos.el > @@ -505,7 +505,8 @@ apropos-user-option > ;;;###autoload > (defun apropos-variable (pattern &optional do-not-all) > "Show variables that match PATTERN. > -When DO-NOT-ALL is non-nil, show user options only, i.e. behave > +With the optional argument DO-NOT-ALL non-nil (or when called interactively with > +the prefix \\[universal-argument]), show user options only, i.e. behave > like `apropos-user-option'." > (interactive (list (apropos-read-pattern > (if current-prefix-arg "user option" "variable")) LGTM, thanks. However, the line you changed is too long now, so please reformat the doc string to have shorter lines, before you push. From debbugs-submit-bounces@debbugs.gnu.org Fri Feb 26 10:49:31 2016 Received: (at 22813) by debbugs.gnu.org; 26 Feb 2016 15:49:31 +0000 Received: from localhost ([127.0.0.1]:47813 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84) (envelope-from ) id 1aZKe2-00076Q-Kx for submit@debbugs.gnu.org; Fri, 26 Feb 2016 10:49:30 -0500 Received: from mail-oi0-f43.google.com ([209.85.218.43]:33355) by debbugs.gnu.org with esmtp (Exim 4.84) (envelope-from ) id 1aZKe0-00076D-MN for 22813@debbugs.gnu.org; Fri, 26 Feb 2016 10:49:28 -0500 Received: by mail-oi0-f43.google.com with SMTP id j125so65113036oih.0 for <22813@debbugs.gnu.org>; Fri, 26 Feb 2016 07:49:28 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:in-reply-to:references:from:date:message-id:subject:to :cc; bh=iaUDjEoPyyv9FeTjgtHAcwzBbLKhY65gc0JKj0N9xIg=; b=h+1mW/M0/oOeaTYLT5Bj4BNBMV0l0QJcUKGD+B4xLfJOraa/ggB4JeG+4Gv1MyG8Yz XYPDT4JUdGhhbaiXicCVYcII+7Jn58AdM4mprokCu9Bam+gxBN/8GWFenZtpusDlhc1d tQ7siTeRVWOHxZxjzGxGQi3eRiNPhmgKat4tDEGEW5d5fXCVkpOkCiaaRSfI9jEQc9As +rvkm93HZLpdusI7zj+FGoyZSSghh5Vd1qQPEfZZVQES3y9nb+y9toCgs55Xei42JZWD jwwIv14eM8IQ5knTA8nGf1JPa61gYQHYFDk6QXaq2QzK/1hIKjhcnwgCmnz09fVoETgx kuFg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:mime-version:in-reply-to:references:from:date :message-id:subject:to:cc; bh=iaUDjEoPyyv9FeTjgtHAcwzBbLKhY65gc0JKj0N9xIg=; b=UkFzLol25/IKraGCYd9MxkTRTquPTvqnO8/clXxxGtJns8fpKkOm788kLg6rFHu3Gh 2ObwWMhIU2GilF8CPTmb5jdPof7uFDnbr0zEnN5hrGRjE8uWLrsPJpzjLs5AlShvt8js z78Ze5FC26+Ep2afgJv2YPczMfru/vOtFqg5wJUoHnpMHCInsW3Ue2ee8wtN10Hl8y41 Jb4fV9TnfeYZ8kd6OWr5RuhQMNRSwAt6up+ykYkNQpA0v2PJiBEpSXoxBCgRwpbHxPi3 znW4EUeVEz+9W83zlapkTeFzVRa9i3wLlPOsHg6TdPfOqJW4zduO+ucO0aN9WxVGtl8m OLzA== X-Gm-Message-State: AD7BkJIpvXhS4FtEgSHGfNTSETYQ7/96ag9td6N4tLbzJyokkuoTaM4KbXVAQRu6DU6efNWKohGTIrnQCRUrsg== X-Received: by 10.202.177.3 with SMTP id a3mr1689897oif.2.1456501762958; Fri, 26 Feb 2016 07:49:22 -0800 (PST) MIME-Version: 1.0 Received: by 10.202.172.198 with HTTP; Fri, 26 Feb 2016 07:48:43 -0800 (PST) In-Reply-To: <8337sfeaxa.fsf@gnu.org> References: <3c8ac019-cb35-4654-b747-c2eb6493cdd6@default> <8337sfeaxa.fsf@gnu.org> From: Kaushal Modi Date: Fri, 26 Feb 2016 10:48:43 -0500 Message-ID: Subject: Re: bug#22813: 24.5; doc string of `apropos-variable' - mention C-u To: Eli Zaretskii Content-Type: multipart/alternative; boundary=001a113cfa163231c2052cae3eef X-Spam-Score: -0.7 (/) X-Debbugs-Envelope-To: 22813 Cc: 22813@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: -0.7 (/) --001a113cfa163231c2052cae3eef Content-Type: text/plain; charset=UTF-8 Thanks. Can you commit it? I don't have push rights. I would like to get commit right for next time :) For now, here's the reformatted patch: diff --git a/lisp/apropos.el b/lisp/apropos.el index 3c1a413..eb145bd 100644 --- a/lisp/apropos.el +++ b/lisp/apropos.el @@ -505,8 +505,9 @@ apropos-user-option ;;;###autoload (defun apropos-variable (pattern &optional do-not-all) "Show variables that match PATTERN. -When DO-NOT-ALL is non-nil, show user options only, i.e. behave -like `apropos-user-option'." +With the optional argument DO-NOT-ALL non-nil (or when called +interactively with the prefix \\[universal-argument]), show user +options only, i.e. behave like `apropos-user-option'." (interactive (list (apropos-read-pattern (if current-prefix-arg "user option" "variable")) current-prefix-arg)) PS: I just did M-x fill-region on that doc-string.. I guess that's what needed to be done. --001a113cfa163231c2052cae3eef Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable
Thanks.

Can you commit it? I don't = have push rights.

I would like to get commit right= for next time :)
For now, here's the reformatted patch:

diff --git a/lisp/apropos.el b/lisp/apropos.el
index 3c1a413..eb145bd 100644
--- a/lisp/apropos.el
=
+++ b/lisp/apropos.el
@@ -505,8 +505,9 @@ apropos-user-optio= n
=C2=A0;;;###autoload
=C2=A0(defun apropos-variable (p= attern &optional do-not-all)
=C2=A0 =C2=A0"Show variable= s that match PATTERN.
-When DO-NOT-ALL is non-nil, show user opti= ons only, i.e. behave
-like `apropos-user-option'."
+With the optional argument DO-NOT-ALL non-nil (or when called
<= div>+interactively with the prefix \\[universal-argument]), show user
=
+options only, i.e. behave like `apropos-user-option'."
=
=C2=A0 =C2=A0(interactive (list (apropos-read-pattern
=C2=A0= =C2=A0 =C2=A0 =C2=A0(i= f current-prefix-arg "user option" "variable"))
=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 = =C2=A0 current-prefix-arg))

PS: I just did M= -x fill-region on that doc-string.. I guess that's what needed to be do= ne.
--001a113cfa163231c2052cae3eef-- From debbugs-submit-bounces@debbugs.gnu.org Fri Feb 26 13:33:32 2016 Received: (at 22813-done) by debbugs.gnu.org; 26 Feb 2016 18:33:32 +0000 Received: from localhost ([127.0.0.1]:47872 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84) (envelope-from ) id 1aZNCm-0002bF-Fz for submit@debbugs.gnu.org; Fri, 26 Feb 2016 13:33:32 -0500 Received: from eggs.gnu.org ([208.118.235.92]:41070) by debbugs.gnu.org with esmtp (Exim 4.84) (envelope-from ) id 1aZNCl-0002b3-I2 for 22813-done@debbugs.gnu.org; Fri, 26 Feb 2016 13:33:31 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aZNCc-0000QB-Ey for 22813-done@debbugs.gnu.org; Fri, 26 Feb 2016 13:33:26 -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,RP_MATCHES_RCVD autolearn=disabled version=3.3.2 Received: from fencepost.gnu.org ([2001:4830:134:3::e]:54125) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aZNCc-0000Q7-Bk; Fri, 26 Feb 2016 13:33:22 -0500 Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:3383 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_128_CBC_SHA1:128) (Exim 4.82) (envelope-from ) id 1aZNCb-0005zy-LF; Fri, 26 Feb 2016 13:33:22 -0500 Date: Fri, 26 Feb 2016 20:33:04 +0200 Message-Id: <83wpprcof3.fsf@gnu.org> From: Eli Zaretskii To: Kaushal Modi In-reply-to: (message from Kaushal Modi on Fri, 26 Feb 2016 10:48:43 -0500) Subject: Re: bug#22813: 24.5; doc string of `apropos-variable' - mention C-u References: <3c8ac019-cb35-4654-b747-c2eb6493cdd6@default> <8337sfeaxa.fsf@gnu.org> 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: 22813-done Cc: 22813-done@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: , Reply-To: Eli Zaretskii Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -5.0 (-----) > From: Kaushal Modi > Date: Fri, 26 Feb 2016 10:48:43 -0500 > Cc: Drew Adams , 22813@debbugs.gnu.org > > > Can you commit it? I don't have push rights. Done. From unknown Fri Aug 15 16:01:06 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Sat, 26 Mar 2016 11:24:03 +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