From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 26237 invoked by alias); 14 Jan 2012 08:25:46 -0000 Received: (qmail 26207 invoked by uid 22791); 14 Jan 2012 08:25:39 -0000 X-SWARE-Spam-Status: No, hits=-1.2 required=5.0 tests=AWL,BAYES_00,RCVD_IN_DNSWL_NONE,SPF_SOFTFAIL,TW_BG X-Spam-Check-By: sourceware.org Received: from mtaout22.012.net.il (HELO mtaout22.012.net.il) (80.179.55.172) by sourceware.org (qpsmtpd/0.43rc1) with ESMTP; Sat, 14 Jan 2012 08:25:24 +0000 Received: from conversion-daemon.a-mtaout22.012.net.il by a-mtaout22.012.net.il (HyperSendmail v2007.08) id <0LXS000004OG5Y00@a-mtaout22.012.net.il> for gdb-patches@sourceware.org; Sat, 14 Jan 2012 10:25:17 +0200 (IST) Received: from HOME-C4E4A596F7 ([77.124.136.230]) by a-mtaout22.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0LXS000OF4Q32A40@a-mtaout22.012.net.il>; Sat, 14 Jan 2012 10:25:16 +0200 (IST) Date: Sat, 14 Jan 2012 10:47:00 -0000 From: Eli Zaretskii Subject: Re: [RFA] [4/4] Remove libgdb API (gdb.h & doc) In-reply-to: <4F108D23.5050803@redhat.com> To: Keith Seitz Cc: gdb-patches@sourceware.org Reply-to: Eli Zaretskii Message-id: <83d3amk7ws.fsf@gnu.org> References: <4F108D23.5050803@redhat.com> X-IsSubscribed: yes 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: 2012-01/txt/msg00511.txt.bz2 > Date: Fri, 13 Jan 2012 11:59:31 -0800 > From: Keith Seitz > > This final patch simply removes the gdb.h and removes mention of it from > the makefile and gdbint.texinfo. > [...] > -@subheading Library - @file{gdb.h} > -@file{libgdb} is the most obvious component of this system. It provides > -the query interface. Each function is parameterized by a @code{ui-out} > -builder. The result of the query is constructed using that builder > -before the query function returns. I admit I don't really understand where all this is going. We are not removing libgdb itself, are we? If we are, there are many more references to libgdb in the manual that need to be removed or rewritten. If we are not removing libgdb, but only gdb.h, then I have 2 questions: . Why does it make sense to remove gdb.h, if the library is going to stay? . The text you remove above speaks about libgdb; gdb.h is just mentioned as the related header. Even if gdb.h is going to be removed, it doesn't make sense IMO to remove the description of libgdb itself, because otherwise the rest of this section will make no sense at all. The section's name, let me remind you, is "libgdb components", so how omitting libgdb itself from the discussion could possibly be TRT? E.g., all those references to "queries" will have no real meaning. What am I missing?