From unknown Tue Sep 23 15:11:57 2025 X-Loop: help-debbugs@gnu.org Subject: bug#9156: 24.0.50; `apropos' doc in Elisp manual Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 23 Jul 2011 17:38:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 9156 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 9156@debbugs.gnu.org X-Debbugs-Original-To: Received: via spool by submit@debbugs.gnu.org id=B.13114426212996 (code B ref -1); Sat, 23 Jul 2011 17:38:01 +0000 Received: (at submit) by debbugs.gnu.org; 23 Jul 2011 17:37:01 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Qkg8L-0000mD-7Z for submit@debbugs.gnu.org; Sat, 23 Jul 2011 13:37:01 -0400 Received: from eggs.gnu.org ([140.186.70.92]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Qkg8J-0000m2-Im for submit@debbugs.gnu.org; Sat, 23 Jul 2011 13:36:59 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Qkg8D-0005uv-OM for submit@debbugs.gnu.org; Sat, 23 Jul 2011 13:36:54 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-3.1 required=5.0 tests=BAYES_00,RP_MATCHES_RCVD, UNPARSEABLE_RELAY autolearn=unavailable version=3.3.1 Received: from lists.gnu.org ([140.186.70.17]:58616) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Qkg8D-0005ur-Mw for submit@debbugs.gnu.org; Sat, 23 Jul 2011 13:36:53 -0400 Received: from eggs.gnu.org ([140.186.70.92]:37223) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Qkg8C-0005ql-UO for bug-gnu-emacs@gnu.org; Sat, 23 Jul 2011 13:36:53 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Qkg8B-0005ue-TL for bug-gnu-emacs@gnu.org; Sat, 23 Jul 2011 13:36:52 -0400 Received: from acsinet15.oracle.com ([141.146.126.227]:44698) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Qkg8B-0005ua-L9 for bug-gnu-emacs@gnu.org; Sat, 23 Jul 2011 13:36:51 -0400 Received: from rtcsinet22.oracle.com (rtcsinet22.oracle.com [66.248.204.30]) by acsinet15.oracle.com (Switch-3.4.4/Switch-3.4.4) with ESMTP id p6NHangG002836 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Sat, 23 Jul 2011 17:36:51 GMT Received: from acsmt357.oracle.com (acsmt357.oracle.com [141.146.40.157]) by rtcsinet22.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id p6NHamb1009635 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Sat, 23 Jul 2011 17:36:48 GMT Received: from abhmt115.oracle.com (abhmt115.oracle.com [141.146.116.67]) by acsmt357.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id p6NHagEs008835 for ; Sat, 23 Jul 2011 12:36:42 -0500 Received: from dradamslap1 (/10.159.46.143) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Sat, 23 Jul 2011 10:36:42 -0700 From: "Drew Adams" Date: Sat, 23 Jul 2011 10:36:37 -0700 Message-ID: <63826CEAD8D342239444E86F6B6A446B@us.oracle.com> MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Mailer: Microsoft Office Outlook 11 Thread-Index: AcxJXxLXu0bt3qOMSiOFb30b+zl4ww== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6109 X-Source-IP: rtcsinet22.oracle.com [66.248.204.30] X-CT-RefId: str=0001.0A090203.4E2B06B3.004B,ss=1,re=0.000,fgs=0 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 1) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-Received-From: 140.186.70.17 X-Spam-Score: -6.2 (------) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -6.2 (------) NOTE: Sending this from a different Emacs version, since bug reporting from emacs -Q is completely broken in this version: In GNU Emacs 24.0.50.1 (i386-mingw-nt5.1.2600) of 2011-07-18 on 3249CTO Windowing system distributor `Microsoft Corp.', version 5.1.2600 configured using `configure --with-gcc (4.5) --no-opt --cflags -Ic:/build/include' --------------- emacs -Q (elisp) Help Functions says this in its attempt to describe command `apropos': The function returns a list of elements that look like this: (SYMBOL SCORE FN-DOC VAR-DOC PLIST-DOC WIDGET-DOC FACE-DOC GROUP-DOC) None of those introduced (meta) names is defined/described, apart from SCORE. This description of the return value is meaningless and not helpful. The doc needs to describe such terms that it introduces. From debbugs-submit-bounces@debbugs.gnu.org Sat Sep 10 21:46:10 2011 Received: (at control) by debbugs.gnu.org; 11 Sep 2011 01:46:10 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1R2Z7Z-0003sC-Er for submit@debbugs.gnu.org; Sat, 10 Sep 2011 21:46:10 -0400 Received: from hermes.netfonds.no ([80.91.224.195]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1R2Z7X-0003s6-OA for control@debbugs.gnu.org; Sat, 10 Sep 2011 21:46:08 -0400 Received: from cm-84.215.51.58.getinternet.no ([84.215.51.58] helo=stories.gnus.org) by hermes.netfonds.no with esmtpsa (TLS1.0:DHE_RSA_AES_128_CBC_SHA1:16) (Exim 4.72) (envelope-from ) id 1R2Z3M-0005KD-KX for control@debbugs.gnu.org; Sun, 11 Sep 2011 03:41:48 +0200 Date: Sun, 11 Sep 2011 03:38:49 +0200 Message-Id: To: control@debbugs.gnu.org From: Lars Magne Ingebrigtsen Subject: control message for bug #9156 X-MailScanner-ID: 1R2Z3M-0005KD-KX X-Netfonds-MailScanner: Found to be clean X-Netfonds-MailScanner-From: larsi@gnus.org MailScanner-NULL-Check: 1316310109.16218@gYGVWa8ZYogdSIe8bt7GZw X-Spam-Status: No X-Spam-Score: -2.7 (--) X-Debbugs-Envelope-To: control X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -2.7 (--) tags 9156 notabug close 9156 From unknown Tue Sep 23 15:11:57 2025 X-Loop: help-debbugs@gnu.org Subject: bug#9156: 24.0.50; `apropos' doc in Elisp manual Resent-From: Lars Magne Ingebrigtsen Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 11 Sep 2011 02:03:03 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 9156 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: notabug To: "Drew Adams" Cc: 9156@debbugs.gnu.org Received: via spool by 9156-submit@debbugs.gnu.org id=B9156.131570658218993 (code B ref 9156); Sun, 11 Sep 2011 02:03:03 +0000 Received: (at 9156) by debbugs.gnu.org; 11 Sep 2011 02:03:02 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1R2ZNu-0004wH-4Q for submit@debbugs.gnu.org; Sat, 10 Sep 2011 22:03:02 -0400 Received: from hermes.netfonds.no ([80.91.224.195]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1R2ZNs-0004vy-7o for 9156@debbugs.gnu.org; Sat, 10 Sep 2011 22:03:01 -0400 Received: from cm-84.215.51.58.getinternet.no ([84.215.51.58] helo=stories.gnus.org) by hermes.netfonds.no with esmtpsa (TLS1.0:DHE_RSA_AES_128_CBC_SHA1:16) (Exim 4.72) (envelope-from ) id 1R2ZJg-0005ij-QG; Sun, 11 Sep 2011 03:58:40 +0200 From: Lars Magne Ingebrigtsen In-Reply-To: <63826CEAD8D342239444E86F6B6A446B@us.oracle.com> (Drew Adams's message of "Sat, 23 Jul 2011 10:36:37 -0700") Date: Sun, 11 Sep 2011 03:38:45 +0200 Message-ID: References: <63826CEAD8D342239444E86F6B6A446B@us.oracle.com> User-Agent: Gnus/5.110018 (No Gnus v0.18) Emacs/24.0.50 (gnu/linux) X-Now-Playing: =?UTF-8?Q?S=C3=B8lyst's_?= =?UTF-8?Q?=5FS=C3=B8lyst=5F:?= "A Swarm of Nerieds" MIME-Version: 1.0 Content-Type: text/plain X-MailScanner-ID: 1R2ZJg-0005ij-QG X-Netfonds-MailScanner: Found to be clean X-Netfonds-MailScanner-From: larsi@gnus.org MailScanner-NULL-Check: 1316311120.98942@XVmj4LOxtmwhrhqhpDk3nw X-Spam-Status: No X-Spam-Score: -2.7 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -2.7 (--) "Drew Adams" writes: > (elisp) Help Functions says this in its attempt to describe command > `apropos': > > The function returns a list of elements that look like this: > > (SYMBOL SCORE FN-DOC VAR-DOC > PLIST-DOC WIDGET-DOC FACE-DOC GROUP-DOC) > > None of those introduced (meta) names is defined/described, apart from > SCORE. This description of the return value is meaningless and not > helpful. The doc needs to describe such terms that it introduces. I know nothing about any of this, but it's obvious to me that "VAR-DOC" means "documentation of the symbol if it's a variable", and so on. The only thing that needs further documentation is SCORE, which is documented. So I don't think this is a bug. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog http://lars.ingebrigtsen.no/ From unknown Tue Sep 23 15:11:57 2025 X-Loop: help-debbugs@gnu.org Subject: bug#9156: 24.0.50; `apropos' doc in Elisp manual Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 11 Sep 2011 14:39:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 9156 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: notabug To: "'Lars Magne Ingebrigtsen'" Cc: 9156@debbugs.gnu.org Received: via spool by 9156-submit@debbugs.gnu.org id=B9156.131575192228979 (code B ref 9156); Sun, 11 Sep 2011 14:39:01 +0000 Received: (at 9156) by debbugs.gnu.org; 11 Sep 2011 14:38:42 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1R2lBC-0007XM-1n for submit@debbugs.gnu.org; Sun, 11 Sep 2011 10:38:42 -0400 Received: from acsinet15.oracle.com ([141.146.126.227]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1R2lB9-0007XC-EQ for 9156@debbugs.gnu.org; Sun, 11 Sep 2011 10:38:40 -0400 Received: from rtcsinet21.oracle.com (rtcsinet21.oracle.com [66.248.204.29]) by acsinet15.oracle.com (Switch-3.4.4/Switch-3.4.4) with ESMTP id p8BEYKxv020928 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Sun, 11 Sep 2011 14:34:22 GMT Received: from acsmt356.oracle.com (acsmt356.oracle.com [141.146.40.156]) by rtcsinet21.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id p8BEYI3S019710 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Sun, 11 Sep 2011 14:34:19 GMT Received: from abhmt103.oracle.com (abhmt103.oracle.com [141.146.116.55]) by acsmt356.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id p8BEYDXw007894; Sun, 11 Sep 2011 09:34:13 -0500 Received: from dradamslap1 (/10.159.62.110) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Sun, 11 Sep 2011 07:34:12 -0700 From: "Drew Adams" References: <63826CEAD8D342239444E86F6B6A446B@us.oracle.com> Date: Sun, 11 Sep 2011 07:34:15 -0700 Message-ID: MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Mailer: Microsoft Office Outlook 11 Thread-Index: AcxwJl0ajBhb4taxTTu8Z5iJSI61egAaVQQg X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6109 In-Reply-To: X-Source-IP: rtcsinet21.oracle.com [66.248.204.29] X-CT-RefId: str=0001.0A090207.4E6CC6EE.00D1,ss=1,re=0.000,fgs=0 X-Spam-Score: -6.2 (------) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -6.2 (------) > I know nothing about any of this, but it's obvious to me that > "VAR-DOC" means "documentation of the symbol if it's a variable", and > so on. The only thing that needs further documentation is SCORE, > which is documented. > > So I don't think this is a bug. Reopening. The bug report stands. If the missing description is obvious to you, then add it. It's about Emacs and Lisp users; it's not about you. From unknown Tue Sep 23 15:11:57 2025 X-Loop: help-debbugs@gnu.org Subject: bug#9156: 24.0.50; `apropos' doc in Elisp manual Resent-From: Chong Yidong Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 19 Feb 2012 05:58:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 9156 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: notabug To: "Drew Adams" Cc: 9156@debbugs.gnu.org Received: via spool by 9156-submit@debbugs.gnu.org id=B9156.132963104215025 (code B ref 9156); Sun, 19 Feb 2012 05:58:02 +0000 Received: (at 9156) by debbugs.gnu.org; 19 Feb 2012 05:57:22 +0000 Received: from localhost ([127.0.0.1]:45079 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Ryzlx-0003uI-Fl for submit@debbugs.gnu.org; Sun, 19 Feb 2012 00:57:22 -0500 Received: from fencepost.gnu.org ([140.186.70.10]:51621 ident=Debian-exim) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Ryzlv-0003uB-LD for 9156@debbugs.gnu.org; Sun, 19 Feb 2012 00:57:20 -0500 Received: from bb121-6-68-155.singnet.com.sg ([121.6.68.155]:36442 helo=furball) by fencepost.gnu.org with esmtpsa (TLS1.0:DHE_RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1Ryzjv-0002ut-Jq; Sun, 19 Feb 2012 00:55:16 -0500 From: Chong Yidong References: <63826CEAD8D342239444E86F6B6A446B@us.oracle.com> Date: Sun, 19 Feb 2012 13:55:07 +0800 In-Reply-To: <63826CEAD8D342239444E86F6B6A446B@us.oracle.com> (Drew Adams's message of "Sat, 23 Jul 2011 10:36:37 -0700") Message-ID: <87obsvnz9g.fsf@gnu.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.0.93 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -4.2 (----) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -4.2 (----) "Drew Adams" writes: > (elisp) Help Functions says this in its attempt to describe command > `apropos': > > The function returns a list of elements that look like this: > > (SYMBOL SCORE FN-DOC VAR-DOC > PLIST-DOC WIDGET-DOC FACE-DOC GROUP-DOC) > > None of those introduced (meta) names is defined/described, apart from > SCORE. This description of the return value is meaningless and not > helpful. The doc needs to describe such terms that it introduces. They are now described. Closing. From debbugs-submit-bounces@debbugs.gnu.org Sun Feb 19 00:57:30 2012 Received: (at control) by debbugs.gnu.org; 19 Feb 2012 05:57:30 +0000 Received: from localhost ([127.0.0.1]:45082 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Ryzm6-0003uc-4m for submit@debbugs.gnu.org; Sun, 19 Feb 2012 00:57:30 -0500 Received: from fencepost.gnu.org ([140.186.70.10]:51623 ident=Debian-exim) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Ryzm4-0003uU-MO for control@debbugs.gnu.org; Sun, 19 Feb 2012 00:57:28 -0500 Received: from bb121-6-68-155.singnet.com.sg ([121.6.68.155]:36443 helo=furball) by fencepost.gnu.org with esmtpsa (TLS1.0:DHE_RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1Ryzk4-0002v8-Vn for control@debbugs.gnu.org; Sun, 19 Feb 2012 00:55:25 -0500 From: Chong Yidong To: control@debbugs.gnu.org Subject: close 9156 Date: Sun, 19 Feb 2012 13:55:18 +0800 Message-ID: <87y5rzz7sp.fsf@gnu.org> MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -4.2 (----) X-Debbugs-Envelope-To: control X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -4.2 (----) close 9156 thanks