From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.devel Subject: RE: C-h C-b to view "Reporting Bugs" section of the manual Date: Mon, 21 May 2012 22:27:50 -0700 Message-ID: References: <41txz9pboj.fsf@fencepost.gnu.org><3C645B82A25242F7AF3BE16B9CB9BCAA@us.oracle.com><87hav9oyq3.fsf@uwakimon.sk.tsukuba.ac.jp><9404D5B04C754DFAA8733E1027D8BDF5@us.oracle.com> <87bolgq4pb.fsf@uwakimon.sk.tsukuba.ac.jp> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: dough.gmane.org 1337664489 18916 80.91.229.3 (22 May 2012 05:28:09 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Tue, 22 May 2012 05:28:09 +0000 (UTC) Cc: emacs-devel@gnu.org To: "'Stephen J. Turnbull'" Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue May 22 07:28:07 2012 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1SWhde-0006G8-MV for ged-emacs-devel@m.gmane.org; Tue, 22 May 2012 07:28:06 +0200 Original-Received: from localhost ([::1]:58709 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SWhdd-00024v-UD for ged-emacs-devel@m.gmane.org; Tue, 22 May 2012 01:28:05 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:33262) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SWhda-00024o-Q5 for emacs-devel@gnu.org; Tue, 22 May 2012 01:28:04 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SWhdY-0003ZZ-SY for emacs-devel@gnu.org; Tue, 22 May 2012 01:28:02 -0400 Original-Received: from acsinet15.oracle.com ([141.146.126.227]:28868) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SWhdY-0003ZV-Mh for emacs-devel@gnu.org; Tue, 22 May 2012 01:28:00 -0400 Original-Received: from ucsinet22.oracle.com (ucsinet22.oracle.com [156.151.31.94]) by acsinet15.oracle.com (Sentrion-MTA-4.2.2/Sentrion-MTA-4.2.2) with ESMTP id q4M5Rtpo000327 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Tue, 22 May 2012 05:27:56 GMT Original-Received: from acsmt358.oracle.com (acsmt358.oracle.com [141.146.40.158]) by ucsinet22.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id q4M5RrjT001530 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Tue, 22 May 2012 05:27:55 GMT Original-Received: from abhmt103.oracle.com (abhmt103.oracle.com [141.146.116.55]) by acsmt358.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id q4M5RrKA021052; Tue, 22 May 2012 00:27:53 -0500 Original-Received: from dradamslap1 (/10.159.160.54) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Mon, 21 May 2012 22:27:53 -0700 X-Mailer: Microsoft Office Outlook 11 In-Reply-To: <87bolgq4pb.fsf@uwakimon.sk.tsukuba.ac.jp> Thread-Index: Ac03ykOPavRBdl0URMOp7VaPOcTpRAABVRdg X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6157 X-Source-IP: ucsinet22.oracle.com [156.151.31.94] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 1) X-Received-From: 141.146.126.227 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:150596 Archived-At: > > When you look for the doc about a command (including > > `r-e-b'), why not have immediately a set of links to its > > doc in the manuals (with the manual names and nodes in the links). > > Well, isn't that basic functionality already available as > `Info-elisp-ref' (aka C-h C-f in my emacs)? Again (in my emacs) when > I use C-h f to get the docstring (which defaults to using the symbol > at point already), point ends up on the name of the function in the > help buffer, so C-h C-f RET takes me to the manual. In GNU Emacs -Q, `C-h C-f' is `view-emacs-FAQ'. Gnu Emacs has no command `Info-elisp-ref'. That's XEmacs, and it apparently looks only in the Elisp manual. GNU Emacs has `Info-goto-emacs-command-node', which is bound to `C-h F'. But it looks only in the Emacs manual, and it looks only for commands. (There is also `Info-goto-emacs-key-command-node' (`C-h K'), which looks up a key in the Emacs manual.) What I'm talking about can cover anything you want - by default: functions, variables, keymaps, modes, faces, and packages. Anyway, as you say: > Links are more discoverable Discoverable? Well, that's one way of putting it! If you're _looking_ at a link there's not a whole lot of "discovery" needed. (And if you're not looking at it then good luck discovering it!) But whatever. > I suppose, but they're also annoying because they're > always in your face. Why don't you look at the thread I cited, or even at the patches? There is only one link (or none, if the user so chooses) - hardly in-your-face. Clicking it takes you to a virtual Info index of links to the relevant manual nodes. And not just one manual, but a user-configurable list of manuals (by default: Emacs and Elisp). It works for the Org Mode manual and the Gnus manual and the Semantic manual and the Widget manual and ... whatever manuals you want. It is likewise a user choice whether to check the manuals ahead of time (so not show any link if there is no manual coverage) or to check them only if you click the link (costs nothing until you click). > They also require moving the mouse, No. TAB RET works just as well for following links. Links are not just for mice. (Nothing new.) > which direct invocation of Info-elisp-ref won't (because if you invoked > `describe-function' via the mouse, the pointer is most likely on the > function in the source buffer). > > It's not clear to me that adding links to the original function's > documentation (as opposed to links to docs for other symbols that are > referenced in the help buffer) is doing anybody any favors. I suggest you read the thread. Only one link is added: For more information check the _manuals_. where _manuals_ is a link to an Info index for the sought thingie. That index lists manuals and nodes, with links.