From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: lee Newsgroups: gmane.emacs.help Subject: Re: describe-mode "some-mode": (documentation some-mode) Date: Sat, 30 Aug 2014 13:42:44 +0200 Organization: my virtual residence Message-ID: <87ha0u9paj.fsf@yun.yagibdah.de> References: <87bnrc1lkz.fsf@yun.yagibdah.de> <87tx54mjmm.fsf@debian.uxu> <87lhqflwb6.fsf_-_@debian.uxu> <878umek5fv.fsf@debian.uxu> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1409402038 32060 80.91.229.3 (30 Aug 2014 12:33:58 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 30 Aug 2014 12:33:58 +0000 (UTC) To: help-gnu-emacs@gnu.org Original-X-From: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Sat Aug 30 14:33:53 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 1XNhqp-0005P3-J3 for geh-help-gnu-emacs@m.gmane.org; Sat, 30 Aug 2014 14:33:51 +0200 Original-Received: from localhost ([::1]:46408 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XNhqp-0003R7-59 for geh-help-gnu-emacs@m.gmane.org; Sat, 30 Aug 2014 08:33:51 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:39121) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XNhqU-0003J0-9Y for help-gnu-emacs@gnu.org; Sat, 30 Aug 2014 08:33:34 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1XNhqI-0007Sw-UJ for help-gnu-emacs@gnu.org; Sat, 30 Aug 2014 08:33:25 -0400 Original-Received: from client-194-42-186-216.muenet.net ([194.42.186.216]:57547 helo=jarl.yagibdah.de) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XNhqI-0007SW-Mw for help-gnu-emacs@gnu.org; Sat, 30 Aug 2014 08:33:18 -0400 Original-Received: from yun.yagibdah.de ([192.168.3.20]) by jarl.yagibdah.de with esmtps (TLS1.2:DHE_RSA_AES_256_CBC_SHA256:256) (Exim 4.80) (envelope-from ) id 1XNhqG-0001C3-8s for help-gnu-emacs@gnu.org; Sat, 30 Aug 2014 14:33:16 +0200 Original-Received: from lee by yun.yagibdah.de with local (Exim 4.80.1) (envelope-from ) id 1XNhqG-0002AG-4a for help-gnu-emacs@gnu.org; Sat, 30 Aug 2014 14:33:16 +0200 In-Reply-To: <878umek5fv.fsf@debian.uxu> (Emanuel Berg's message of "Sun, 24 Aug 2014 04:05:40 +0200") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.4.50 (gnu/linux) Mail-Followup-To: help-gnu-emacs@gnu.org X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x X-Received-From: 194.42.186.216 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:99537 Archived-At: Emanuel Berg writes: > lee writes: > >> (defun my-describe-mode () "Display the documentation >> of MODE." (interactive) (let ((mode (list (intern >> (read-string "Mode: "))))) (unless (functionp mode) >> (with-current-buffer (switch-to-buffer-other-window >> "my-describe-mode") (insert (documentation mode)))))) >> >> This inserts "Keyboard macro." into the buffer >> (without the quotes). I'm not too sure about what I'm >> doing here ... > > What are you trying to do? I was trying to insert the documentation for a mode into a buffer. Instead of returning the docstring for the mode, (insert (documentation mode)) inserts "Keybaord macro." into the buffer with the function I defined to do this. I'm wondering why apparently (documentation mode) returns "Keyboard macro." instead of the docstring ... >> When I use (help-buffer) instead of >> "my-describe-mode" for a buffer, the (help-buffer) >> might be read-only? > > The help buffers are read-only, yes. Ah, interesting: because when I tried to insert into the help-buffer, "Keyboard macro." was inserted in the current buffer instead. That's why I changed the function to use (switch-to-buffer-other-window "my-describe-mode") instead. What's the defined or supposed behaviour of 'insert when the buffer to insert something into is read-only? -- GNU Emacs 24.4.50.2 (x86_64-unknown-linux-gnu, X toolkit, Xaw3d scroll bars) of 2014-08-17 on yun.yagibdah.de