From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: user3341592 Newsgroups: gmane.emacs.bugs Subject: bug#18346: Missing feature; smart contextual documentation (help buffers) Date: Thu, 28 Aug 2014 19:50:18 +0200 Organization: user3341592 Message-ID: <86lhq8h5b9.fsf@somewhere.org> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1409250930 17097 80.91.229.3 (28 Aug 2014 18:35:30 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Thu, 28 Aug 2014 18:35:30 +0000 (UTC) To: 18346-ubl+/3LiMTaZdePnXv/OxA@public.gmane.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org-mXXj517/zsQ@public.gmane.org Thu Aug 28 20:35:23 2014 Return-path: Envelope-to: geb-bug-gnu-emacs@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 1XN4Xa-0000LO-Io for geb-bug-gnu-emacs@m.gmane.org; Thu, 28 Aug 2014 20:35:22 +0200 Original-Received: from localhost ([::1]:38523 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XN4Xa-0003yh-7J for geb-bug-gnu-emacs@m.gmane.org; Thu, 28 Aug 2014 14:35:22 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:56661) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XN4XQ-0003vI-1n for bug-gnu-emacs-mXXj517/zsQ@public.gmane.org; Thu, 28 Aug 2014 14:35:19 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1XN4XG-00006t-UX for bug-gnu-emacs-mXXj517/zsQ@public.gmane.org; Thu, 28 Aug 2014 14:35:11 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:47677) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XN4XG-00006R-SG for bug-gnu-emacs-mXXj517/zsQ@public.gmane.org; Thu, 28 Aug 2014 14:35:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1XN4XG-0005TP-CU for bug-gnu-emacs-mXXj517/zsQ@public.gmane.org; Thu, 28 Aug 2014 14:35:02 -0400 X-Loop: help-debbugs-mXXj517/zsQ@public.gmane.org Resent-From: user3341592 Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs-mXXj517/zsQ@public.gmane.org Resent-Date: Thu, 28 Aug 2014 18:35:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs-mXXj517/zsQ@public.gmane.org X-GNU-PR-Message: report 18346 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: bug-gnu-emacs-mXXj517/zsQ@public.gmane.org Original-Received: via spool by submit-ubl+/3LiMTaZdePnXv/OxA@public.gmane.org id=B.140925089221016 (code B ref -1); Thu, 28 Aug 2014 18:35:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 28 Aug 2014 18:34:52 +0000 Original-Received: from localhost ([127.0.0.1]:54620 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1XN4X5-0005Sr-Em for submit-ubl+/3LiMTaZdePnXv/OxA@public.gmane.org; Thu, 28 Aug 2014 14:34:52 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:53215) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1XN4QC-0005H4-5a for submit-ubl+/3LiMTaZdePnXv/OxA@public.gmane.org; Thu, 28 Aug 2014 14:27:45 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1XN4Pz-0006IO-G8 for submit-ubl+/3LiMTaZdePnXv/OxA@public.gmane.org; Thu, 28 Aug 2014 14:27:38 -0400 Original-Received: from lists.gnu.org ([2001:4830:134:3::11]:52502) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XN4Pz-0006Hz-6y for submit-ubl+/3LiMTaZdePnXv/OxA@public.gmane.org; Thu, 28 Aug 2014 14:27:31 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:54837) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XN4Ps-0002YT-Ut for bug-gnu-emacs-mXXj517/zsQ@public.gmane.org; Thu, 28 Aug 2014 14:27:31 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1XN4Pm-0006Er-Mo for bug-gnu-emacs-mXXj517/zsQ@public.gmane.org; Thu, 28 Aug 2014 14:27:24 -0400 Original-Received: from dd5e0353a.access.telenet.be ([213.224.53.58]:54848 helo=mail.missioncriticalit.com) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XN4Pm-0006ER-Gs for bug-gnu-emacs-mXXj517/zsQ@public.gmane.org; Thu, 28 Aug 2014 14:27:18 -0400 Original-Received: from MUNDANEUM.i-did-not-set--mail-host-address--so-tickle-me (ip-83-101-44-240.customer.schedom-europe.net [83.101.44.240]) by mail.missioncriticalit.com (Postfix) with ESMTPSA id 84BEC5002C9 for ; Thu, 28 Aug 2014 19:51:09 +0200 (CEST) X-Url: Under construction... X-Archive: encrypt User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.3.93 (windows-nt) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-Mailman-Approved-At: Thu, 28 Aug 2014 14:34:49 -0400 X-BeenThere: debbugs-submit-ubl+/3LiMTaZdePnXv/OxA@public.gmane.org X-Mailman-Version: 2.1.15 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x X-Received-From: 140.186.70.43 X-BeenThere: bug-gnu-emacs-mXXj517/zsQ@public.gmane.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-mXXj517/zsQ@public.gmane.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org-mXXj517/zsQ@public.gmane.org Xref: news.gmane.org gmane.emacs.bugs:92778 Archived-At: Here is a missing feature which Stefan asked to report. See http://stackoverflow.com/questions/25551120/bind-f1-to-smart-contextual-documentation-help-buffers. --8<---------------cut here---------------start------------->8--- Is there a function which I could bind on F1 in Emacs, which would give me (in a temporary or persistent buffer) contextual documentation on the "symbol" under point? IIUC, that'd give the same results as: - C-c C-v RET in ESS buffers (= ess-display-help-on-object) - C-h f/v RET in Emacs Lisp buffers (= describe-function/variable) - C-h S in Shell buffers (= info-lookup-symbol) + M-x man-follow? - ??? in AWK, C, Java - ??? in AUCTeX buffers (well, that may be a big dream ;-)) - ... Somehow, Auto-Complete does that job (at least in ESS and Emacs Lisp buffers), as it displays the right help (on functions, on variables, etc.) in its "quick help" tooltip. Though, it's only displayed in the completion process, not after. I first thought that info-lookup-symbol would be (part of) the solution, but it already does NOT work in ESS, so it's pretty very limited... What should I bind onto F1, then? --8<---------------cut here---------------end--------------->8---