From unknown Fri Aug 15 16:22:54 2025 X-Loop: help-debbugs@gnu.org Subject: bug#10823: 24.0.93; Make `C-h d' reporting more consistent and usable Resent-From: Jambunathan K Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 16 Feb 2012 05:07:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 10823 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 10823@debbugs.gnu.org X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.132936876412484 (code B ref -1); Thu, 16 Feb 2012 05:07:01 +0000 Received: (at submit) by debbugs.gnu.org; 16 Feb 2012 05:06:04 +0000 Received: from localhost ([127.0.0.1]:42022 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1RxtXb-0003Ey-U7 for submit@debbugs.gnu.org; Thu, 16 Feb 2012 00:06:02 -0500 Received: from eggs.gnu.org ([140.186.70.92]:49976) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1RxtXZ-0003Em-8s for submit@debbugs.gnu.org; Thu, 16 Feb 2012 00:05:58 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RxtVl-0007Wq-5Z for submit@debbugs.gnu.org; Thu, 16 Feb 2012 00:04:06 -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.9 required=5.0 tests=BAYES_00,FREEMAIL_FROM, RCVD_IN_DNSWL_LOW, RCVD_IN_MSPIKE_BL, T_DKIM_INVALID autolearn=no version=3.3.2 Received: from lists.gnu.org ([140.186.70.17]:54626) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RxtVl-0007Wl-48 for submit@debbugs.gnu.org; Thu, 16 Feb 2012 00:04:05 -0500 Received: from eggs.gnu.org ([140.186.70.92]:59361) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RxtVj-0004JN-JV for bug-gnu-emacs@gnu.org; Thu, 16 Feb 2012 00:04:04 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RxtVi-0007W7-2j for bug-gnu-emacs@gnu.org; Thu, 16 Feb 2012 00:04:03 -0500 Received: from mail-pz0-f41.google.com ([209.85.210.41]:49090) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RxtVh-0007Vv-Nl for bug-gnu-emacs@gnu.org; Thu, 16 Feb 2012 00:04:02 -0500 Received: by dadv6 with SMTP id v6so1735705dad.0 for ; Wed, 15 Feb 2012 21:04:00 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=from:to:subject:date:message-id:mime-version:content-type; bh=JeXBZVVR6Zz3N2H6MERkkMbZXy5jccBdNR71Am980K4=; b=DkcmWR/x8S21TG51JGtGjH9PZ9/UzFyXxv0bBhFZ8kzGETwTlY6eBqSzbf/jfassX8 9IDl83SLKJ6o0EOc5hBVUQiuBS/CmmZCowAHjpjT+YDOmlstXd4VQCECOMtI4j+4yj8r 3dc3GGxtHjd2OifgbQ8bXufJsGob96rUe21Hw= Received: by 10.68.129.105 with SMTP id nv9mr9935007pbb.30.1329368640761; Wed, 15 Feb 2012 21:04:00 -0800 (PST) Received: from JAMBU-NETBOOK ([115.241.125.149]) by mx.google.com with ESMTPS id i2sm1330638pbc.67.2012.02.15.21.03.56 (version=TLSv1/SSLv3 cipher=OTHER); Wed, 15 Feb 2012 21:03:59 -0800 (PST) From: Jambunathan K Date: Thu, 16 Feb 2012 10:33:42 +0530 Message-ID: <81booznzdd.fsf@gmail.com> MIME-Version: 1.0 Content-Type: text/plain X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-Received-From: 140.186.70.17 X-Spam-Score: -3.4 (---) 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: -3.4 (---) I find that C-h d gives me a fairly good coverage of a particular "feature" that I am trying to hunt down. Unfortunately for the amount of information that it prints, the navigation of the *Apropos* buffer is cumbersome. Let me explain with an explain. Down below is a snapshot of first few paragraphs when I do a C-h d apropos Here are a few things that I find noisome. These are documented in the text below. ---------------- apropos-read-pattern Function: Read an apropos pattern, either a word list or a regexp. <> (fn SUBJECT) ,---- ^^^^^^^^^^^^^^ | By the time I reach here, I have almost forgotten what "fn" I am looking | at. I also find this style of reporting inconsisten with C-h v and C-h f | style of reporting where the function signature is on the top. `---- ---------------- ,---- ^^^^^^^^^^^^^^ | Can these separators be converted to page breaks? So that I can move | between the different blocks using page navigation commands. Doing a | incremental re-search for -----+ is painful particularly when some of | the listed commands that have docstring which have horizontal rules in | them. `---- apropos Command: Show all meaningful Lisp symbols whose names match PATTERN. <> (fn PATTERN &optional DO-ALL) ---------------- apropos-command Command: Show commands (interactively callable functions) that match PATTERN. ,----[ C-h v internal-doc-file-name RET ] | internal-doc-file-name is a variable defined in `C source code'. | Its value is "DOC-X" | | Documentation: | Name of file containing documentation strings of built-in symbols. | | [back] `---- ,---- | Can someone clarify what the file is and what qualifies as "built-in" | symbols. Does it include the "whole" of what ships with vanilla Emacs or | just a subset of it. I tried looking around in the info manual. I found | nothing much which could give me a sense of "coverage" of the reported | list. `---- From unknown Fri Aug 15 16:22:54 2025 X-Loop: help-debbugs@gnu.org Subject: bug#10823: 24.0.93; Make `C-h d' reporting more consistent and usable Resent-From: Stefan Monnier Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 16 Feb 2012 13:51:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 10823 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Jambunathan K Cc: 10823@debbugs.gnu.org Received: via spool by 10823-submit@debbugs.gnu.org id=B10823.13294002182497 (code B ref 10823); Thu, 16 Feb 2012 13:51:01 +0000 Received: (at 10823) by debbugs.gnu.org; 16 Feb 2012 13:50:18 +0000 Received: from localhost ([127.0.0.1]:42369 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Ry1iz-0000eD-QU for submit@debbugs.gnu.org; Thu, 16 Feb 2012 08:50:18 -0500 Received: from chene.dit.umontreal.ca ([132.204.246.20]:39335) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Ry1iy-0000e6-6b for 10823@debbugs.gnu.org; Thu, 16 Feb 2012 08:50:17 -0500 Received: from pastel.home (lechon.iro.umontreal.ca [132.204.27.242]) by chene.dit.umontreal.ca (8.14.1/8.14.1) with ESMTP id q1GDmRmQ025500; Thu, 16 Feb 2012 08:48:27 -0500 Received: by pastel.home (Postfix, from userid 20848) id EB1545929A; Thu, 16 Feb 2012 08:48:26 -0500 (EST) From: Stefan Monnier Message-ID: References: <81booznzdd.fsf@gmail.com> Date: Thu, 16 Feb 2012 08:48:26 -0500 In-Reply-To: <81booznzdd.fsf@gmail.com> (Jambunathan K.'s message of "Thu, 16 Feb 2012 10:33:42 +0530") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.0.93 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-NAI-Spam-Flag: NO X-NAI-Spam-Threshold: 5 X-NAI-Spam-Score: 0 X-NAI-Spam-Rules: 1 Rules triggered RV4133=0 X-NAI-Spam-Version: 2.2.0.9309 : core <4133> : streams <729212> : uri <1066517> X-Spam-Score: -3.5 (---) 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: -3.5 (---) > ---------------- > apropos-read-pattern > Function: Read an apropos pattern, either a word list or a regexp. > <> > (fn SUBJECT) > ,---- ^^^^^^^^^^^^^^ > | By the time I reach here, I have almost forgotten what "fn" I am looking > | at. I also find this style of reporting inconsisten with C-h v and C-h f > | style of reporting where the function signature is on the top. > `---- It's a plain bug: when the "(fn FOO)" convention was added, the apropos code was not updated correspondingly. I.e. apropos needs to use help-split-fundoc. > ---------------- > ,---- ^^^^^^^^^^^^^^ > | Can these separators be converted to page breaks? So that I can move > | between the different blocks using page navigation commands. Doing a There are many ways to do that. A trivial way is to set page-delimiter in those buffers to a regexp that matches those lines. > ,----[ C-h v internal-doc-file-name RET ] > | internal-doc-file-name is a variable defined in `C source code'. > | Its value is "DOC-X" > | > | Documentation: > | Name of file containing documentation strings of built-in symbols. > | > | [back] > `---- > ,---- > | Can someone clarify what the file is and what qualifies as "built-in" > | symbols. Does it include the "whole" of what ships with vanilla Emacs or > | just a subset of it. I tried looking around in the info manual. I found > | nothing much which could give me a sense of "coverage" of the reported > | list. > `---- I don't understand the connection between this question and the previous ones. Is there any? "built-in" here really means "included in the `emacs' binary", i.e. either defined in C or preloaded. But this is an internal variable which you shouldn't need to care about. Stefan From unknown Fri Aug 15 16:22:54 2025 MIME-Version: 1.0 X-Mailer: MIME-tools 5.503 (Entity 5.503) X-Loop: help-debbugs@gnu.org From: help-debbugs@gnu.org (GNU bug Tracking System) To: Jambunathan K Subject: bug#10823: closed (Re: bug#10823: 24.0.93; Make `C-h d' reporting more consistent and usable) Message-ID: References: <87k3gaqo3k.fsf@gmail.com> <81booznzdd.fsf@gmail.com> X-Gnu-PR-Message: they-closed 10823 X-Gnu-PR-Package: emacs Reply-To: 10823@debbugs.gnu.org Date: Fri, 15 Nov 2013 04:36:02 +0000 Content-Type: multipart/mixed; boundary="----------=_1384490162-3880-1" This is a multi-part message in MIME format... ------------=_1384490162-3880-1 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Your bug report #10823: 24.0.93; Make `C-h d' reporting more consistent and usable 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 10823@debbugs.gnu.org. --=20 10823: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D10823 GNU Bug Tracking System Contact help-debbugs@gnu.org with problems ------------=_1384490162-3880-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at 10823-done) by debbugs.gnu.org; 15 Nov 2013 04:35:34 +0000 Received: from localhost ([127.0.0.1]:53248 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1VhB82-0000zs-0W for submit@debbugs.gnu.org; Thu, 14 Nov 2013 23:35:34 -0500 Received: from mail-pb0-f45.google.com ([209.85.160.45]:39588) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1VhB80-0000ze-23 for 10823-done@debbugs.gnu.org; Thu, 14 Nov 2013 23:35:32 -0500 Received: by mail-pb0-f45.google.com with SMTP id mc8so3029907pbc.4 for <10823-done@debbugs.gnu.org>; Thu, 14 Nov 2013 20:35:26 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=from:to:subject:references:date:in-reply-to:message-id:user-agent :mime-version:content-type; bh=34RliMuq46GYZpNAJ9q5wgb5qGmLaLD6QroaM995F1Y=; b=Lw5Pw2JBhVU3ZrhQqfjiU+bUSXwzAX+9/5caBt/0uwPNj9Zd+9Juucjp2RJf2uVFu/ E8NuRW5c+JLObTiXNWv5xGd0kRk7BumpJGoeUotHryyXlWcvi1eOC0uXCY60p2s9PY86 LFu28oIf09f0UF+36d89aqVaJjekUv+RdgZev417363lphhhkvknktrFoKx7Us7YnSSO +Dk3M3NyxxNwKwnbjJn44JspjwsLU2vSc9fR4zeH2XQ/QHUqLkbvvUeiD5TeBYJWVNlW PuQrR30KrwNncUrFjcrBCGbs50Hq/YS1SadNUELmoMFVbUdBQ6fvyOtEELVozpejhZOg rcHQ== X-Received: by 10.68.7.73 with SMTP id h9mr4985781pba.30.1384490126333; Thu, 14 Nov 2013 20:35:26 -0800 (PST) Received: from debian-6.05 ([115.241.27.214]) by mx.google.com with ESMTPSA id ed3sm1409617pbc.6.2013.11.14.20.35.24 for <10823-done@debbugs.gnu.org> (version=TLSv1.1 cipher=RC4-SHA bits=128/128); Thu, 14 Nov 2013 20:35:25 -0800 (PST) From: Jambunathan K To: 10823-done@debbugs.gnu.org Subject: Re: bug#10823: 24.0.93; Make `C-h d' reporting more consistent and usable References: <81booznzdd.fsf@gmail.com> Date: Fri, 15 Nov 2013 10:05:11 +0530 In-Reply-To: <81booznzdd.fsf@gmail.com> (Jambunathan K.'s message of "Thu, 16 Feb 2012 10:33:42 +0530") Message-ID: <87k3gaqo3k.fsf@gmail.com> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.3.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -0.7 (/) X-Debbugs-Envelope-To: 10823-done X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 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 (/) OP here. Closing it. ------------=_1384490162-3880-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at submit) by debbugs.gnu.org; 16 Feb 2012 05:06:04 +0000 Received: from localhost ([127.0.0.1]:42022 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1RxtXb-0003Ey-U7 for submit@debbugs.gnu.org; Thu, 16 Feb 2012 00:06:02 -0500 Received: from eggs.gnu.org ([140.186.70.92]:49976) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1RxtXZ-0003Em-8s for submit@debbugs.gnu.org; Thu, 16 Feb 2012 00:05:58 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RxtVl-0007Wq-5Z for submit@debbugs.gnu.org; Thu, 16 Feb 2012 00:04:06 -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.9 required=5.0 tests=BAYES_00,FREEMAIL_FROM, RCVD_IN_DNSWL_LOW, RCVD_IN_MSPIKE_BL, T_DKIM_INVALID autolearn=no version=3.3.2 Received: from lists.gnu.org ([140.186.70.17]:54626) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RxtVl-0007Wl-48 for submit@debbugs.gnu.org; Thu, 16 Feb 2012 00:04:05 -0500 Received: from eggs.gnu.org ([140.186.70.92]:59361) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RxtVj-0004JN-JV for bug-gnu-emacs@gnu.org; Thu, 16 Feb 2012 00:04:04 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RxtVi-0007W7-2j for bug-gnu-emacs@gnu.org; Thu, 16 Feb 2012 00:04:03 -0500 Received: from mail-pz0-f41.google.com ([209.85.210.41]:49090) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RxtVh-0007Vv-Nl for bug-gnu-emacs@gnu.org; Thu, 16 Feb 2012 00:04:02 -0500 Received: by dadv6 with SMTP id v6so1735705dad.0 for ; Wed, 15 Feb 2012 21:04:00 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=from:to:subject:date:message-id:mime-version:content-type; bh=JeXBZVVR6Zz3N2H6MERkkMbZXy5jccBdNR71Am980K4=; b=DkcmWR/x8S21TG51JGtGjH9PZ9/UzFyXxv0bBhFZ8kzGETwTlY6eBqSzbf/jfassX8 9IDl83SLKJ6o0EOc5hBVUQiuBS/CmmZCowAHjpjT+YDOmlstXd4VQCECOMtI4j+4yj8r 3dc3GGxtHjd2OifgbQ8bXufJsGob96rUe21Hw= Received: by 10.68.129.105 with SMTP id nv9mr9935007pbb.30.1329368640761; Wed, 15 Feb 2012 21:04:00 -0800 (PST) Received: from JAMBU-NETBOOK ([115.241.125.149]) by mx.google.com with ESMTPS id i2sm1330638pbc.67.2012.02.15.21.03.56 (version=TLSv1/SSLv3 cipher=OTHER); Wed, 15 Feb 2012 21:03:59 -0800 (PST) From: Jambunathan K To: bug-gnu-emacs@gnu.org Subject: 24.0.93; Make `C-h d' reporting more consistent and usable Date: Thu, 16 Feb 2012 10:33:42 +0530 Message-ID: <81booznzdd.fsf@gmail.com> MIME-Version: 1.0 Content-Type: text/plain X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-Received-From: 140.186.70.17 X-Spam-Score: -3.4 (---) X-Debbugs-Envelope-To: submit 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: -3.4 (---) I find that C-h d gives me a fairly good coverage of a particular "feature" that I am trying to hunt down. Unfortunately for the amount of information that it prints, the navigation of the *Apropos* buffer is cumbersome. Let me explain with an explain. Down below is a snapshot of first few paragraphs when I do a C-h d apropos Here are a few things that I find noisome. These are documented in the text below. ---------------- apropos-read-pattern Function: Read an apropos pattern, either a word list or a regexp. <> (fn SUBJECT) ,---- ^^^^^^^^^^^^^^ | By the time I reach here, I have almost forgotten what "fn" I am looking | at. I also find this style of reporting inconsisten with C-h v and C-h f | style of reporting where the function signature is on the top. `---- ---------------- ,---- ^^^^^^^^^^^^^^ | Can these separators be converted to page breaks? So that I can move | between the different blocks using page navigation commands. Doing a | incremental re-search for -----+ is painful particularly when some of | the listed commands that have docstring which have horizontal rules in | them. `---- apropos Command: Show all meaningful Lisp symbols whose names match PATTERN. <> (fn PATTERN &optional DO-ALL) ---------------- apropos-command Command: Show commands (interactively callable functions) that match PATTERN. ,----[ C-h v internal-doc-file-name RET ] | internal-doc-file-name is a variable defined in `C source code'. | Its value is "DOC-X" | | Documentation: | Name of file containing documentation strings of built-in symbols. | | [back] `---- ,---- | Can someone clarify what the file is and what qualifies as "built-in" | symbols. Does it include the "whole" of what ships with vanilla Emacs or | just a subset of it. I tried looking around in the info manual. I found | nothing much which could give me a sense of "coverage" of the reported | list. `---- ------------=_1384490162-3880-1--