From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: Debugging Emacs Date: Sat, 28 Nov 2015 09:56:43 +0200 Message-ID: <83h9k6r1z8.fsf@gnu.org> References: <87r3jbicg0.fsf@russet.org.uk> <83wpt3qq7b.fsf@gnu.org> <87lh9jp073.fsf@russet.org.uk> Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1448697432 25088 80.91.229.3 (28 Nov 2015 07:57:12 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 28 Nov 2015 07:57:12 +0000 (UTC) Cc: emacs-devel@gnu.org To: phillip.lord@russet.org.uk (Phillip Lord) Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Nov 28 08:57:01 2015 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 1a2aNQ-0002Eq-Qi for ged-emacs-devel@m.gmane.org; Sat, 28 Nov 2015 08:57:00 +0100 Original-Received: from localhost ([::1]:59887 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1a2aNT-0004pT-Lm for ged-emacs-devel@m.gmane.org; Sat, 28 Nov 2015 02:57:03 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:54026) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1a2aNQ-0004pO-OJ for emacs-devel@gnu.org; Sat, 28 Nov 2015 02:57:01 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1a2aNL-0000q1-Oz for emacs-devel@gnu.org; Sat, 28 Nov 2015 02:57:00 -0500 Original-Received: from mtaout28.012.net.il ([80.179.55.184]:45591) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1a2aNL-0000pj-HT for emacs-devel@gnu.org; Sat, 28 Nov 2015 02:56:55 -0500 Original-Received: from conversion-daemon.mtaout28.012.net.il by mtaout28.012.net.il (HyperSendmail v2007.08) id <0NYI00200LTTI100@mtaout28.012.net.il> for emacs-devel@gnu.org; Sat, 28 Nov 2015 09:55:52 +0200 (IST) Original-Received: from HOME-C4E4A596F7 ([84.94.185.246]) by mtaout28.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0NYI002YOM14AE00@mtaout28.012.net.il>; Sat, 28 Nov 2015 09:55:52 +0200 (IST) In-reply-to: <87lh9jp073.fsf@russet.org.uk> X-012-Sender: halo1@inter.net.il X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 80.179.55.184 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:195434 Archived-At: > From: phillip.lord@russet.org.uk (Phillip Lord) > Cc: > Date: Fri, 27 Nov 2015 22:05:52 +0000 > > With etc/DEBUG, I am worried not about what it does not say, but what it > does say. It's really very dense. It is written from the POV of someone who is way beyond basic debugging techniques, and needs only the Emacs-specific information. Once upon a time, only people matching that description "dared" to debug Emacs on the C level. This file was born back then. > > More specifically, how about a preamble section at the beginning of > > etc/DEBUG, named something like "If you are new to debugging Emacs", > > and describing the preliminaries you think are important? You can > > refer to later sections instead of repeating what they say. > > Yes, that was sort of the idea. Personally, I'd not be too worried about > repeating things. I realise that this adds to the maintainance burden, > but references to later sections make for harder reading. It is OK to say something simple in the preamble, and refer to later sections for more in-depth detail. But I will now stop writing comments to a text I didn't yet see, and let you work on it instead ;-) > I'll try and simplify what I wrote a bit further. Thanks.