From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 22876 invoked by alias); 28 Mar 2006 18:44:31 -0000 Received: (qmail 22868 invoked by uid 22791); 28 Mar 2006 18:44:30 -0000 X-Spam-Check-By: sourceware.org Received: from romy.inter.net.il (HELO romy.inter.net.il) (192.114.186.66) by sourceware.org (qpsmtpd/0.31) with ESMTP; Tue, 28 Mar 2006 18:44:30 +0000 Received: from HOME-C4E4A596F7 (IGLD-84-228-161-43.inter.net.il [84.228.161.43]) by romy.inter.net.il (MOS 3.7.3-GA) with ESMTP id DVT47781 (AUTH halo1); Tue, 28 Mar 2006 20:44:24 +0200 (IST) Date: Tue, 28 Mar 2006 21:17:00 -0000 Message-Id: From: Eli Zaretskii To: "Jim Blandy" CC: jimb@codesourcery.com, gdb-patches@sources.redhat.com In-reply-to: <8f2776cb0603281029y35c11fb9v2ad31f4a0445d6b3@mail.gmail.com> (jimb@red-bean.com) Subject: Re: RFA: prologue value modules Reply-to: Eli Zaretskii References: <8f2776cb0603281029y35c11fb9v2ad31f4a0445d6b3@mail.gmail.com> X-IsSubscribed: yes Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm Precedence: bulk List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sourceware.org X-SW-Source: 2006-03/txt/msg00320.txt.bz2 > Date: Tue, 28 Mar 2006 10:29:37 -0800 > From: "Jim Blandy" > Cc: "Jim Blandy" , gdb-patches@sources.redhat.com > > > Would it be a good idea to have the listing of the API in the manual, > > with short explanations? I'm not saying it is necessarily required, > > but please give it a thought. > > I'd rather have the API described in the header file. I don't think > we, as a project, can afford to maintain two copies of that sort of > documentation, and I think the header files are best place for > detailed, function-by-function information. But that's contrary to the rest of gdbint.texinfo, which does document the more important parts of the respective APIs. > How does this look? Looks good, thanks.