From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 13600 invoked by alias); 9 Jun 2007 08:54:41 -0000 Received: (qmail 13592 invoked by uid 22791); 9 Jun 2007 08:54:40 -0000 X-Spam-Check-By: sourceware.org Received: from mail.codesourcery.com (HELO mail.codesourcery.com) (65.74.133.4) by sourceware.org (qpsmtpd/0.31) with ESMTP; Sat, 09 Jun 2007 08:54:38 +0000 Received: (qmail 27093 invoked from network); 9 Jun 2007 08:54:35 -0000 Received: from unknown (HELO ?158.250.17.147?) (vladimir@127.0.0.2) by mail.codesourcery.com with ESMTPA; 9 Jun 2007 08:54:35 -0000 From: Vladimir Prus To: gdb-patches@sources.redhat.com Subject: Tweak frozen varobj docs Date: Sat, 09 Jun 2007 08:54:00 -0000 User-Agent: KMail/1.9.1 MIME-Version: 1.0 Content-Type: Multipart/Mixed; boundary="Boundary-00=_FrmaGw3j5S1oqG+" Message-Id: <200706091254.29684.vladimir@codesourcery.com> 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: 2007-06/txt/msg00129.txt.bz2 --Boundary-00=_FrmaGw3j5S1oqG+ Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Content-Disposition: inline Content-length: 446 Eli, as discussed in http://article.gmane.org/gmane.comp.gdb.patches/33695 you want some changes to frozen varobj docs I've previously committing. Sorry it took me so long, but the attached patch fixes all concerns you've raised. OK? Incidentally, I still find it strange that '-var-update' anchor actually points to the middle of '-var-update' documentation. Do you think this is something we should fix as a separate patch? - Volodya --Boundary-00=_FrmaGw3j5S1oqG+ Content-Type: text/x-diff; charset="us-ascii"; name="frozen_docs_tweaks.diff" Content-Transfer-Encoding: 7bit Content-Disposition: attachment; filename="frozen_docs_tweaks.diff" Content-length: 2711 Index: gdb/doc/gdb.texinfo =================================================================== RCS file: /cvs/src/src/gdb/doc/gdb.texinfo,v retrieving revision 1.408 diff -u -p -r1.408 gdb.texinfo --- gdb/doc/gdb.texinfo 6 Jun 2007 21:29:14 -0000 1.408 +++ gdb/doc/gdb.texinfo 9 Jun 2007 08:52:39 -0000 @@ -17262,7 +17262,7 @@ New fields may be added to the output of @item The range of values for fields with specified values, e.g., -@code{in_scope} (@pxref{-var-update-fields}) may be extended. +@code{in_scope} (@pxref{-var-update}) may be extended. @c The format of field's content e.g type prefix, may change so parse it @c at your own risk. Yes, in general? @@ -19516,7 +19516,6 @@ subsequent @code{-var-update} list. @subheading The @code{-var-update} Command @findex -var-update -@anchor{-var-update} @subsubheading Synopsis @@ -19530,7 +19529,8 @@ list of variable objects whose values ha be a root variable object. Here, ``changed'' means that the result of @code{-var-evaluate-expression} before and after the @code{-var-update} is different. If @samp{*} is used as the variable -object names, all existing variable objects are updated. The option +object names, all existing variable objects are updated, except +for frozen ones (@pxref{-var-set-frozen}). The option @var{print-values} determines whether both names and values, or just names are printed. The possible values of this options are the same as for @code{-var-list-children} (@pxref{-var-list-children}). It is @@ -19551,7 +19551,7 @@ type_changed="false"@}] (gdb) @end smallexample -@anchor{-var-update-fields} +@anchor{-var-update} The field in_scope may take three values: @table @code @@ -19576,18 +19576,19 @@ be prepared for this possibility. @xref @subheading The @code{-var-set-frozen} Command @findex -var-set-frozen +@anchor{-var-set-frozen} @subsubheading Synopsis @smallexample - -var-set-frozen @var{name} @samp{flag} + -var-set-frozen @var{name} @var{flag} @end smallexample -Set the frozeness flag on the variable object @var{name}. The +Set the frozenness flag on the variable object @var{name}. The @var{flag} parameter should be either @samp{1} to make the variable -frozen or @samp{0} to make it unfozen. If a variable object is +frozen or @samp{0} to make it unfrozen. If a variable object is frozen, then neither itself, nor any of its children, are -implicitly updated by @code{-var-update} (@pxref{-var-update}) of +implicitly updated by @code{-var-update} of a parent variable or by @code{-var-update *}. Only @code{-var-update} of the variable itself will update its value and values of its children. After a variable object is unfrozen, it is --Boundary-00=_FrmaGw3j5S1oqG+--