From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 18264 invoked by alias); 28 Jan 2006 13:40:31 -0000 Received: (qmail 18251 invoked by uid 22791); 28 Jan 2006 13:40: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; Sat, 28 Jan 2006 13:40:28 +0000 Received: from HOME-C4E4A596F7 (IGLD-80-230-8-12.inter.net.il [80.230.8.12]) by romy.inter.net.il (MOS 3.7.3-GA) with ESMTP id DLJ50963 (AUTH halo1); Sat, 28 Jan 2006 15:40:22 +0200 (IST) Date: Sat, 28 Jan 2006 14:48:00 -0000 Message-Id: From: Eli Zaretskii To: Vladimir Prus , gdb@sources.redhat.com In-reply-to: <20060127171717.GD30826@brasko.net> (message from Bob Rossi on Fri, 27 Jan 2006 12:17:17 -0500) Subject: Re: MI -break-info command issues Reply-to: Eli Zaretskii References: <200601271115.22939.ghost@cs.msu.su> <20060127151220.GA978@nevyn.them.org> <20060127171717.GD30826@brasko.net> X-IsSubscribed: yes Mailing-List: contact gdb-help@sourceware.org; run by ezmlm Precedence: bulk List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-owner@sourceware.org X-SW-Source: 2006-01/txt/msg00318.txt.bz2 > Date: Fri, 27 Jan 2006 12:17:17 -0500 > From: Bob Rossi > Cc: Vladimir Prus , gdb@sources.redhat.com > > > Historically, GDB/MI was added to the sources without _any_ > > documentation. I needed to lobby those who wrote the code to make > > some docs available, and finally got a kind of white paper that > > described what MI _will_ look like; it goes without saying that the > > reality was quite different. I then needed to edit that document > > heavily to make it fit into the manual (convert chapters to sections, > > sections to subsections, fix style and Texinfo usage, etc.) and that > > is what we have now, basically, except that some portions were > > improved since then, whenever commands were added/changed. > > Eli, one thought I had recently was this. I would like to automate the > examples, using the testsuite. So that if an MI output command changed, > the sample would be updated. Do you think this would be possible to do? I don't like the idea of asking people to install dejagnu+expect just to produce the docs. Perhaps we could instead come up with some way of running each of the MI commands through "gdb -i mi", and capturing the output to produce the examples for the manual. If you wish to work on this, I'd support such a change. It would involve extracting the MI commands from the manual, running GDB, capturing the output, and inserting it into the examples.