From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Stefan Monnier Newsgroups: gmane.emacs.bugs Subject: bug#10823: 24.0.93; Make `C-h d' reporting more consistent and usable Date: Thu, 16 Feb 2012 08:48:26 -0500 Message-ID: References: <81booznzdd.fsf@gmail.com> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: dough.gmane.org 1329400201 23753 80.91.229.3 (16 Feb 2012 13:50:01 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Thu, 16 Feb 2012 13:50:01 +0000 (UTC) Cc: 10823@debbugs.gnu.org To: Jambunathan K Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Thu Feb 16 14:49:59 2012 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([140.186.70.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1Ry1iD-0002Iv-0Q for geb-bug-gnu-emacs@m.gmane.org; Thu, 16 Feb 2012 14:49:29 +0100 Original-Received: from localhost ([::1]:36354 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Ry1iC-0000hU-6n for geb-bug-gnu-emacs@m.gmane.org; Thu, 16 Feb 2012 08:49:28 -0500 Original-Received: from eggs.gnu.org ([140.186.70.92]:33743) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Ry1i4-0000hP-MJ for bug-gnu-emacs@gnu.org; Thu, 16 Feb 2012 08:49:26 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Ry1hy-0008Sg-Uk for bug-gnu-emacs@gnu.org; Thu, 16 Feb 2012 08:49:20 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:38746) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Ry1hy-0008Sa-Ru for bug-gnu-emacs@gnu.org; Thu, 16 Feb 2012 08:49:14 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.72) (envelope-from ) id 1Ry1ji-0000f7-3o for bug-gnu-emacs@gnu.org; Thu, 16 Feb 2012 08:51:02 -0500 X-Loop: help-debbugs@gnu.org 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: Original-Received: via spool by 10823-submit@debbugs.gnu.org id=B10823.13294002182497 (code B ref 10823); Thu, 16 Feb 2012 13:51:01 +0000 Original-Received: (at 10823) by debbugs.gnu.org; 16 Feb 2012 13:50:18 +0000 Original-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 Original-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 Original-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 Original-Received: by pastel.home (Postfix, from userid 20848) id EB1545929A; Thu, 16 Feb 2012 08:48:26 -0500 (EST) 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) 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-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2) X-Received-From: 140.186.70.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:56935 Archived-At: > ---------------- > 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