From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 2887 invoked by alias); 9 Apr 2008 11:59:42 -0000 Received: (qmail 2873 invoked by uid 22791); 9 Apr 2008 11:59:41 -0000 X-Spam-Check-By: sourceware.org Received: from main.gmane.org (HELO ciao.gmane.org) (80.91.229.2) by sourceware.org (qpsmtpd/0.31) with ESMTP; Wed, 09 Apr 2008 11:59:22 +0000 Received: from list by ciao.gmane.org with local (Exim 4.43) id 1JjYxT-0003cc-EC for gdb-patches@sources.redhat.com; Wed, 09 Apr 2008 11:59:19 +0000 Received: from 78.158.192.230 ([78.158.192.230]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Wed, 09 Apr 2008 11:59:19 +0000 Received: from ghost by 78.158.192.230 with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Wed, 09 Apr 2008 11:59:19 +0000 To: gdb-patches@sources.redhat.com From: Vladimir Prus Subject: Re: [RFA] Document fixed/floating variable objects and thread-id. Date: Wed, 09 Apr 2008 13:49:00 -0000 Message-ID: References: <200804041320.00361.vladimir@codesourcery.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7Bit User-Agent: KNode/0.10.5 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: 2008-04/txt/msg00161.txt.bz2 Eli Zaretskii wrote: >> From: Vladimir Prus >> Date: Fri, 4 Apr 2008 13:20:00 +0400 >> >> >> This patch adds some more docs about variable objects. > > Thanks, adding documentation is always welcome. > >> * gdb/doc/gdb.texinfo (gdb/mi Variable object): Document >> fixed and floating variable objects, and clarify that >> a variable object can also be found to a thread. Update >> -var-create example. > > Some comments and suggestions: > >> +Variable objects can be either ``fixed'' or ``floating''. For the > > Texinfo has a special markup for introducing new terminology: @dfn. > So please use @dfn{fixed} and @dfn{floating}, as it looks better in > print. > > Also, there's only one blank after the end of the sentence here; > please use two. > >> +fixed variable object, the expression is parsed when the variable >> +object is created, including associating indentifiers to specific >> +variables. The meaning of expression never changes. A floating >> +variable object has its expression reparsed each time the variable >> +object is updated. In particular, the meaning of identifiers can >> +change every time. > > Instead of ``meaning'' here, isn't it better to say ``value''? Identifier does not have a value. Think of 'i' -- it's just a name. It is then associated to a specific variable, which variable has value. What I mean is that association between identifiers to variables can change for floating variable objects. Of course, the values can also change, but values can change even for fixed variable objects. What's the best way to express this? - Volodya