From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Stephen J. Turnbull" Newsgroups: gmane.emacs.devel Subject: RE: C-h C-b to view "Reporting Bugs" section of the manual Date: Tue, 22 May 2012 12:23:28 +0900 Message-ID: <87bolgq4pb.fsf@uwakimon.sk.tsukuba.ac.jp> References: <41txz9pboj.fsf@fencepost.gnu.org> <3C645B82A25242F7AF3BE16B9CB9BCAA@us.oracle.com> <87hav9oyq3.fsf@uwakimon.sk.tsukuba.ac.jp> <9404D5B04C754DFAA8733E1027D8BDF5@us.oracle.com> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 X-Trace: dough.gmane.org 1337657025 7109 80.91.229.3 (22 May 2012 03:23:45 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Tue, 22 May 2012 03:23:45 +0000 (UTC) Cc: emacs-devel@gnu.org To: "Drew Adams" Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue May 22 05:23:44 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 1SWfhE-0000n6-8S for ged-emacs-devel@m.gmane.org; Tue, 22 May 2012 05:23:40 +0200 Original-Received: from localhost ([::1]:38995 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SWfhD-0000nR-Np for ged-emacs-devel@m.gmane.org; Mon, 21 May 2012 23:23:39 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:45873) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SWfhA-0000nF-1M for emacs-devel@gnu.org; Mon, 21 May 2012 23:23:37 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SWfh8-0006ti-62 for emacs-devel@gnu.org; Mon, 21 May 2012 23:23:35 -0400 Original-Received: from mgmt1.sk.tsukuba.ac.jp ([130.158.97.223]:44566) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SWfh7-0006sj-T3 for emacs-devel@gnu.org; Mon, 21 May 2012 23:23:34 -0400 Original-Received: from uwakimon.sk.tsukuba.ac.jp (uwakimon.sk.tsukuba.ac.jp [130.158.99.156]) by mgmt1.sk.tsukuba.ac.jp (Postfix) with ESMTP id 6D80C3FA0848; Tue, 22 May 2012 12:23:28 +0900 (JST) Original-Received: by uwakimon.sk.tsukuba.ac.jp (Postfix, from userid 1000) id 360321A31AE; Tue, 22 May 2012 12:23:28 +0900 (JST) In-Reply-To: <9404D5B04C754DFAA8733E1027D8BDF5@us.oracle.com> X-Mailer: VM undefined under 21.5 (beta31) "ginger" 5d3bb1100832 XEmacs Lucid (x86_64-unknown-linux) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-Received-From: 130.158.97.223 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:150591 Archived-At: Drew Adams writes: > 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. Links are more discoverable, I suppose, but they're also annoying because they're always in your face. They also require moving the mouse, 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.