From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Emanuel Berg Newsgroups: gmane.emacs.help Subject: Re: describe-mode "some-mode"? Date: Sun, 24 Aug 2014 03:56:38 +0200 Organization: Aioe.org NNTP Server Message-ID: <87fvgmk5ux.fsf@debian.uxu> References: <87bnrc1lkz.fsf@yun.yagibdah.de> <988b6e41-62ed-4d33-abf1-804ddcedef59@default> <87egw7z8ca.fsf@yun.yagibdah.de> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1408845624 10434 80.91.229.3 (24 Aug 2014 02:00:24 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 24 Aug 2014 02:00:24 +0000 (UTC) To: help-gnu-emacs@gnu.org Original-X-From: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Sun Aug 24 04:00:19 2014 Return-path: Envelope-to: geh-help-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 1XLN6Q-0001H8-FW for geh-help-gnu-emacs@m.gmane.org; Sun, 24 Aug 2014 04:00:18 +0200 Original-Received: from localhost ([::1]:42728 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XLN6Q-00031W-2N for geh-help-gnu-emacs@m.gmane.org; Sat, 23 Aug 2014 22:00:18 -0400 Original-Path: usenet.stanford.edu!news.tele.dk!news.tele.dk!small.news.tele.dk!newsfeed.xs4all.nl!newsfeed3.news.xs4all.nl!xs4all!news.stack.nl!aioe.org!.POSTED!not-for-mail Original-Newsgroups: gnu.emacs.help Original-Lines: 54 Original-NNTP-Posting-Host: P0uMB9BthHuWo8+BJXB4Mw.user.speranza.aioe.org Original-X-Complaints-To: abuse@aioe.org User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.3 (gnu/linux) X-Notice: Filtered by postfilter v. 0.8.2 Cancel-Lock: sha1:QyAwV2yfn2BFP2mB8Oq4Q0Be07M= Mail-Copies-To: never Original-Xref: usenet.stanford.edu gnu.emacs.help:207101 X-BeenThere: help-gnu-emacs@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: Users list for the GNU Emacs text editor List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Original-Sender: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.help:99378 Archived-At: Drew Adams writes: > `help-documentation' is defined in `help-fns+.el' > (http://www.emacswiki.org/emacs-en/download/help-fns%2b.el). > It is like the vanilla function `documentation', but > it uses `help-substitute-command-keys' so that keys > mentioned in the help become links to their doc. Why isn't such a helpful feature itself vanilla? > Using only vanilla functions: > > (defun my-describe-mode (mode) (interactive (list > (intern (read-string "Mode: ")))) (with-help-window > (help-buffer) (with-current-buffer (help-buffer) > (insert (substitute-command-keys (documentation > mode)))))) > > ... > > (defun my-describe-mode (mode) (interactive (list > (intern (read-string "Mode: ")))) (with-temp-buffer > (funcall mode) (describe-mode))) And make one of those vanilla as well! And then - as it seems only the lowercase m is employed by the help system, for describing the current buffer modes: (global-set-key "\C-hM" 'my-describe-mode) But, for message-mode, those don't give identical output for me with respect to the minor modes. Perhaps Gnus enables something in a hook that is not part of plain message-mode. So you should be careful separating when you want to describe a mode in general, and the mode specifically in effect for the current buffer! my-describe-mode: Enabled minor modes: Abbrev Auto-Composition Auto-Fill Global-Font-Lock Shell-Dirtrack Show-Paren Transient-Mark describe-mode: Enabled minor modes: Abbrev Auto-Composition Auto-Fill Font-Lock Global-Font-Lock Gnus-Message-Citation Shell-Dirtrack Show-Paren Transient-Mark -- underground experts united