From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 18998 invoked by alias); 8 Apr 2009 11:05:27 -0000 Received: (qmail 18989 invoked by uid 22791); 8 Apr 2009 11:05:26 -0000 X-SWARE-Spam-Status: No, hits=-2.6 required=5.0 tests=BAYES_00 X-Spam-Check-By: sourceware.org Received: from smtp.nokia.com (HELO mgw-mx03.nokia.com) (192.100.122.230) by sourceware.org (qpsmtpd/0.43rc1) with ESMTP; Wed, 08 Apr 2009 11:05:21 +0000 Received: from esebh105.NOE.Nokia.com (esebh105.ntc.nokia.com [172.21.138.211]) by mgw-mx03.nokia.com (Switch-3.2.6/Switch-3.2.6) with ESMTP id n38B5B0G013423 for ; Wed, 8 Apr 2009 14:05:15 +0300 Received: from esebh102.NOE.Nokia.com ([172.21.138.183]) by esebh105.NOE.Nokia.com with Microsoft SMTPSVC(6.0.3790.3959); Wed, 8 Apr 2009 14:05:01 +0300 Received: from mgw-int01.ntc.nokia.com ([172.21.143.96]) by esebh102.NOE.Nokia.com over TLS secured channel with Microsoft SMTPSVC(6.0.3790.3959); Wed, 8 Apr 2009 14:05:01 +0300 Received: from gar.localnet (bett-ws023.europe.nokia.com [172.25.167.47]) by mgw-int01.ntc.nokia.com (Switch-3.2.5/Switch-3.2.5) with ESMTP id n38B4wdR010913 for ; Wed, 8 Apr 2009 14:04:59 +0300 From: =?iso-8859-1?q?Andr=E9_P=F6nitz?= To: gdb-patches@sources.redhat.com Subject: Re: Implement -exec-jump Date: Wed, 08 Apr 2009 11:05:00 -0000 User-Agent: KMail/1.10.1 (Linux/2.6.27-9-generic; KDE/4.1.4; x86_64; ; ) References: <200904080950.16691.vladimir@codesourcery.com> <200904081116.41983.andre.poenitz@nokia.com> <833acj5wdi.fsf@gnu.org> In-Reply-To: <833acj5wdi.fsf@gnu.org> MIME-Version: 1.0 Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: 7bit Content-Disposition: inline Message-Id: <200904081305.41964.andre.poenitz@nokia.com> X-Nokia-AV: Clean Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sourceware.org X-SW-Source: 2009-04/txt/msg00146.txt.bz2 On Wednesday 08 April 2009 11:26:49 ext Eli Zaretskii wrote: > > From: =?utf-8?q?Andr=C3=A9_P=C3=B6nitz?= > > On Wednesday 08 April 2009 09:20:43 Eli Zaretskii wrote: > > > > From: Vladimir Prus > > > [...] > > > > Do you think having a window of time where *development version* > > > > has an undocumented feature that is primary targeted at *frontend developers* > > > > is worse than not having that feature at all? > > > > > > Yes, that's what I think. > > > > I disagree. > > Well, you are not responsible for the GDB documentation; I am. I am a potential user of the feature being discussed. Vladimir was making a statement on what a frontend developer is likely to prefer: A feature that is undocumented for a limited in the development tree _or_ the possibility that the feature does not get implemented at all. > If we are going to allow committing undocumented code, I would ask to > install some procedures to make sure it gets documented eventually. > For now, I don't have any practical suggestion for such procedures, > and I cannot be responsible for a job that other maintainers and > contributors are preventing me to do well. Please be fair and > understand where I'm coming from. I think I fully understand your position, and also that it is the "natural stance" for a documentation maintainer. It's just that I do not agree with it. I personally pretty much prefer progress on the MI implementation side, if that means a few days delay on the documentation, (or even a small risk of having no documentation at all(!)), so I am _personally_ fine with it. > > At worst, I have to look up the exact syntax to use in the > > sources. No big deal. > > Then why have the manual in the first place? Let them use the > sources. That's a interesting proposal. There is so much stuff, basic stuff even, undocumented, so Joe Frontend has to read the sources anyway. As an example: The quoting rules for the CLI are completely opaque, but, giving the de-facto non-existence of a binary interface to gdb, crucial for any frontend. A frontend can not just go "type a command" - "hey, gdb does not like it, so try to put in a quote or two"... Regards, Andre'