From unknown Fri Aug 15 22:18:19 2025 X-Loop: help-debbugs@gnu.org Subject: bug#22813: 24.5; doc string of `apropos-variable' - mention C-u Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 26 Feb 2016 05:18:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 22813 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 22813@debbugs.gnu.org X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.145646386812904 (code B ref -1); Fri, 26 Feb 2016 05:18:02 +0000 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 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-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 unknown Fri Aug 15 22:18:19 2025 X-Loop: help-debbugs@gnu.org Subject: bug#22813: 24.5; doc string of `apropos-variable' - mention C-u References: In-Reply-To: Resent-From: Kaushal Modi Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 26 Feb 2016 13:17:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 22813 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 22813@debbugs.gnu.org Received: via spool by 22813-submit@debbugs.gnu.org id=B22813.14564925745961 (code B ref 22813); Fri, 26 Feb 2016 13:17:02 +0000 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: Content-Type: multipart/alternative; boundary=001a11494d0e1441df052cac1aee X-Spam-Score: -0.7 (/) 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 unknown Fri Aug 15 22:18:19 2025 X-Loop: help-debbugs@gnu.org Subject: bug#22813: 24.5; doc string of `apropos-variable' - mention C-u Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 26 Feb 2016 14:16:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 22813 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Kaushal Modi Cc: 22813@debbugs.gnu.org Reply-To: Eli Zaretskii Received: via spool by 22813-submit@debbugs.gnu.org id=B22813.145649611817821 (code B ref 22813); Fri, 26 Feb 2016 14:16:02 +0000 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 In-reply-to: (message from Kaushal Modi on Fri, 26 Feb 2016 08:15:27 -0500) 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-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 (-----) > 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 unknown Fri Aug 15 22:18:19 2025 X-Loop: help-debbugs@gnu.org Subject: bug#22813: 24.5; doc string of `apropos-variable' - mention C-u Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 26 Feb 2016 14:34:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 22813 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Kaushal Modi , 22813@debbugs.gnu.org Received: via spool by 22813-submit@debbugs.gnu.org id=B22813.145649721119533 (code B ref 22813); Fri, 26 Feb 2016 14:34:01 +0000 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 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-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 unknown Fri Aug 15 22:18:19 2025 X-Loop: help-debbugs@gnu.org Subject: bug#22813: 24.5; doc string of `apropos-variable' - mention C-u Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 26 Feb 2016 14:41:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 22813 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Kaushal Modi , 22813@debbugs.gnu.org Received: via spool by 22813-submit@debbugs.gnu.org id=B22813.145649762420174 (code B ref 22813); Fri, 26 Feb 2016 14:41:02 +0000 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 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-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 unknown Fri Aug 15 22:18:19 2025 X-Loop: help-debbugs@gnu.org Subject: bug#22813: 24.5; doc string of `apropos-variable' - mention C-u Resent-From: Kaushal Modi Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 26 Feb 2016 14:54:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 22813 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Drew Adams , Eli Zaretskii Cc: 22813@debbugs.gnu.org Received: via spool by 22813-submit@debbugs.gnu.org id=B22813.145649840121380 (code B ref 22813); Fri, 26 Feb 2016 14:54:02 +0000 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: Content-Type: multipart/alternative; boundary=001a1135a77c6a1256052cad7566 X-Spam-Score: -0.7 (/) 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 unknown Fri Aug 15 22:18:19 2025 X-Loop: help-debbugs@gnu.org Subject: bug#22813: 24.5; doc string of `apropos-variable' - mention C-u Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 26 Feb 2016 15:43:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 22813 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Kaushal Modi Cc: 22813@debbugs.gnu.org, drew.adams@oracle.com Reply-To: Eli Zaretskii Received: via spool by 22813-submit@debbugs.gnu.org id=B22813.145650132326632 (code B ref 22813); Fri, 26 Feb 2016 15:43:01 +0000 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 In-reply-to: (message from Kaushal Modi on Fri, 26 Feb 2016 09:52:34 -0500) 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-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 (-----) > 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 unknown Fri Aug 15 22:18:19 2025 X-Loop: help-debbugs@gnu.org Subject: bug#22813: 24.5; doc string of `apropos-variable' - mention C-u Resent-From: Kaushal Modi Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 26 Feb 2016 15:50:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 22813 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Eli Zaretskii Cc: 22813@debbugs.gnu.org, Drew Adams Received: via spool by 22813-submit@debbugs.gnu.org id=B22813.145650177127311 (code B ref 22813); Fri, 26 Feb 2016 15:50:02 +0000 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: Content-Type: multipart/alternative; boundary=001a113cfa163231c2052cae3eef X-Spam-Score: -0.7 (/) 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 unknown Fri Aug 15 22:18:19 2025 MIME-Version: 1.0 X-Mailer: MIME-tools 5.505 (Entity 5.505) X-Loop: help-debbugs@gnu.org From: help-debbugs@gnu.org (GNU bug Tracking System) To: Drew Adams Subject: bug#22813: closed (Re: bug#22813: 24.5; doc string of `apropos-variable' - mention C-u) Message-ID: References: <83wpprcof3.fsf@gnu.org> X-Gnu-PR-Message: they-closed 22813 X-Gnu-PR-Package: emacs Reply-To: 22813@debbugs.gnu.org Date: Fri, 26 Feb 2016 18:34:02 +0000 Content-Type: multipart/mixed; boundary="----------=_1456511642-10060-1" This is a multi-part message in MIME format... ------------=_1456511642-10060-1 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Your bug report #22813: 24.5; doc string of `apropos-variable' - mention C-u which was filed against the emacs package, has been closed. The explanation is attached below, along with your original report. If you require more details, please reply to 22813@debbugs.gnu.org. --=20 22813: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D22813 GNU Bug Tracking System Contact help-debbugs@gnu.org with problems ------------=_1456511642-10060-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit 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. ------------=_1456511642-10060-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit 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' ------------=_1456511642-10060-1--