From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Jari Aalto Newsgroups: gmane.emacs.bugs Subject: bug#7667: Emacs info: function toggle-debug-on-quit is not documented Date: Tue, 21 Dec 2010 11:10:22 +0200 Organization: Private Message-ID: <87y67jwkxt.fsf@picasso.cante.net> References: <87y67o1drr.fsf@picasso.cante.net> <87tyi7txny.fsf@stupidchicken.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: dough.gmane.org 1292923391 15178 80.91.229.12 (21 Dec 2010 09:23:11 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Tue, 21 Dec 2010 09:23:11 +0000 (UTC) Cc: 7667@debbugs.gnu.org, Jari Aalto To: Chong Yidong Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Tue Dec 21 10:23:07 2010 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1PUyQz-0003OW-TL for geb-bug-gnu-emacs@m.gmane.org; Tue, 21 Dec 2010 10:23:06 +0100 Original-Received: from localhost ([127.0.0.1]:51930 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PUyQz-0001FS-3q for geb-bug-gnu-emacs@m.gmane.org; Tue, 21 Dec 2010 04:23:05 -0500 Original-Received: from [140.186.70.92] (port=57598 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PUyQq-0001Eo-LV for bug-gnu-emacs@gnu.org; Tue, 21 Dec 2010 04:22:58 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1PUyQp-0001us-Ea for bug-gnu-emacs@gnu.org; Tue, 21 Dec 2010 04:22:56 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:58358) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1PUyQp-0001uo-D0 for bug-gnu-emacs@gnu.org; Tue, 21 Dec 2010 04:22:55 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1PUy8Y-00020b-JW; Tue, 21 Dec 2010 04:04:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Jari Aalto Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 21 Dec 2010 09:04:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 7667 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 7667-submit@debbugs.gnu.org id=B7667.12929222417714 (code B ref 7667); Tue, 21 Dec 2010 09:04:02 +0000 Original-Received: (at 7667) by debbugs.gnu.org; 21 Dec 2010 09:04:01 +0000 Original-Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1PUy8V-00020N-Qe for submit@debbugs.gnu.org; Tue, 21 Dec 2010 04:04:00 -0500 Original-Received: from emh02.mail.saunalahti.fi ([62.142.5.108]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1PUy8S-000203-UU for 7667@debbugs.gnu.org; Tue, 21 Dec 2010 04:03:58 -0500 Original-Received: from saunalahti-vams (vs3-12.mail.saunalahti.fi [62.142.5.96]) by emh02-2.mail.saunalahti.fi (Postfix) with SMTP id A446CEF57A; Tue, 21 Dec 2010 11:10:27 +0200 (EET) Original-Received: from emh07.mail.saunalahti.fi ([62.142.5.117]) by vs3-12.mail.saunalahti.fi ([62.142.5.96]) with SMTP (gateway) id A026717D8AB; Tue, 21 Dec 2010 11:10:27 +0200 Original-Received: from picasso.cante.net (a91-155-187-216.elisa-laajakaista.fi [91.155.187.216]) by emh07.mail.saunalahti.fi (Postfix) with ESMTP id 05F561C638E; Tue, 21 Dec 2010 11:10:23 +0200 (EET) Mail-Copies-To: poster In-Reply-To: <87tyi7txny.fsf@stupidchicken.com> (Chong Yidong's message of "Tue, 21 Dec 2010 15:03:45 +0800") User-Agent: Gnus/5.110011 (No Gnus v0.11) Emacs/23.2 (gnu/linux) X-Antivirus: VAMS X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Tue, 21 Dec 2010 04:04:02 -0500 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-BeenThere: bug-gnu-emacs@gnu.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: , Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:42705 Archived-At: 2010-12-21 09:03 Chong Yidong : | Jari Aalto writes: | | > Function toggle-debug-on-quit is not documented in Emacs info | > page. Please add it to file: | > | > doc/emacs/trouble.texi | | It's documented in the Lisp manual, and mentioned in the Emacs manual in | the node "Bugs" > "Checklist". Since this command is mostly useful for | Lisp debugging and programming, the documentation belongs in the Lisp | manual. The doc/emacs/trouble.texi documents: @chapter Dealing with Common Problems @findex toggle-debug-on-error @pindex Edebug To make a backtrace for the error, use @kbd{M-x toggle-debug-on-error} before the error happens (that is to say, you must give that command and then make the bug happen). This causes the error to start the Lisp debugger, which shows you a backtrace. Copy the text of the debugger's backtrace into the bug report. @xref{Debugger,, The Lisp Debugger, elisp, the Emacs Lisp Reference Manual}, for information on debugging Emacs Lisp programs with the Edebug package. This use of the debugger is possible only if you know how to make the bug happen again. If you can't make it happen again, at least copy the whole error message. The toggle-debug-on-quit is comparable. It would be awkward not to be able to find it with "s" search command; that you would need to switch to entirely another info manual to see the function. Jari