From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 27735 invoked by alias); 19 Dec 2006 22:29:45 -0000 Received: (qmail 27714 invoked by uid 22791); 19 Dec 2006 22:29:44 -0000 X-Spam-Check-By: sourceware.org Received: from viper.snap.net.nz (HELO viper.snap.net.nz) (202.37.101.8) by sourceware.org (qpsmtpd/0.31) with ESMTP; Tue, 19 Dec 2006 22:29:36 +0000 Received: from kahikatea.snap.net.nz (p202-124-125-55.snap.net.nz [202.124.125.55]) by viper.snap.net.nz (Postfix) with ESMTP id 3BFE93D9930; Wed, 20 Dec 2006 11:31:01 +1300 (NZDT) Received: by kahikatea.snap.net.nz (Postfix, from userid 500) id 035F7BE456; Wed, 20 Dec 2006 11:24:57 +1300 (NZDT) From: Nick Roberts MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Message-ID: <17800.26295.304176.572103@kahikatea.snap.net.nz> Date: Tue, 19 Dec 2006 22:29:00 -0000 To: Vladimir Prus Cc: gdb-patches@sources.redhat.com Subject: Re: [doc] improve MI varobj introduction In-Reply-To: <200612191103.55137.vladimir@codesourcery.com> References: <200612191103.55137.vladimir@codesourcery.com> X-Mailer: VM 7.19 under Emacs 22.0.91.19 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: 2006-12/txt/msg00257.txt.bz2 I think it's a good idea to add this. > +For a leaf variable object it is possible to obtain its value as a > +string, or set the value from a string. String value can be also ^^^^^^ -var-assign var1 8 <- not a string ^done,value="8" > +obtained for a non-leaf variable object, but its generally a string > +that only indicates the type of the object, and does not list its > +content. Assignment to a non-leaf variable object is not allowed. > > +A frontend need not read the values of all variable objects each time > +the program stops. Instead, MI provides update command that lists all > +variable objects which values has changed since the last update > +operation. This considerably reduces the amount of data that must > +be transferred to the frontend. and this: > + and return the > +list of variable object which values has changed as the result. and return the list of variable object whose values have changed. However, I'm not sure that the replaced parts of the introduction are an improvement, or that elaborating on the PRINT-VALUES option is a good idea. Also expanding the introduction allows the removal of the summary of commands which just duplicates what comes after. -- Nick http://www.inet.net.nz/~nickrob