From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 25726 invoked by alias); 20 Aug 2010 09:22:17 -0000 Received: (qmail 25717 invoked by uid 22791); 20 Aug 2010 09:22:16 -0000 X-SWARE-Spam-Status: No, hits=-0.6 required=5.0 tests=AWL,BAYES_00,RCVD_IN_DNSWL_NONE,SPF_SOFTFAIL,TW_VC X-Spam-Check-By: sourceware.org Received: from mtaout22.012.net.il (HELO mtaout22.012.net.il) (80.179.55.172) by sourceware.org (qpsmtpd/0.43rc1) with ESMTP; Fri, 20 Aug 2010 09:22:09 +0000 Received: from conversion-daemon.a-mtaout22.012.net.il by a-mtaout22.012.net.il (HyperSendmail v2007.08) id <0L7G007001Z73J00@a-mtaout22.012.net.il> for gdb-patches@sourceware.org; Fri, 20 Aug 2010 12:21:59 +0300 (IDT) Received: from HOME-C4E4A596F7 ([77.127.220.100]) by a-mtaout22.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0L7G006BK20LAQB0@a-mtaout22.012.net.il>; Fri, 20 Aug 2010 12:21:59 +0300 (IDT) Date: Fri, 20 Aug 2010 09:22:00 -0000 From: Eli Zaretskii Subject: Re: [RFA/DOC] record pic In-reply-to: To: Hui Zhu Cc: gdb-patches@sourceware.org Reply-to: Eli Zaretskii Message-id: <83y6c1prnh.fsf@gnu.org> MIME-version: 1.0 Content-type: text/plain; charset=iso-8859-1 Content-transfer-encoding: 8BIT References: <83fx039kel.fsf@gnu.org> 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: 2010-08/txt/msg00366.txt.bz2 > From: Hui Zhu > Date: Fri, 2 Jul 2010 14:28:54 +0800 > Cc: gdb-patches@sourceware.org > > > What's a vcg file? > > VCG file is "Visualization of Compiler Graphs". I didn't find other > good define about it. :( > There are some introduce about it. > http://gcc.gnu.org/news/egcs-vcg.html > http://rw4.cs.uni-sb.de/~sander/html/gsvcg1.html > > To see the file. I suggest use http://code.google.com/p/vcgviewer/ This information should be added to the docs. > >> +set record pic hide-nofunction on|off > >> +  Set or show whether `record pic' hide the nodes that don't have > >                                      ^^^^ > > "hides" > > > > But what does it mean to "hide the nodes"? > > The each line or each function will be show in vcg file as a node. > Sometime, we don't want show it. So hide the nodes. There should be an explanation about this in the manual and in NEWS. > +set record pic hide-nofunction on|off > + Set or show whether `record pic' hides the nodes that don't have > + the function name. What are "the nodes without function name"? > +set record pic hide-nosource on|off > + Set or show whether `record pic' hides the nodes that don't have > + the source message. What are "nodes that don't have the source message"? And what is a "source message"? > +set record pic hide-sameaddr on|off > + Set or show whether `record pic' hides the nodes that have the > + same address node in vcg file. Do you mean here multiple nodes that have the same address? If so, what will be hidden in that case? all nodes but the first one? > +@kindex set record pic type There's no need to index each subcommand of "set record pic", especially since they all are described one after the other. It's good enough to have only one "@kindex set record pic" before the first subcommand. > +@item set record pic type @var{type} > +Set the type of the nodes that @code{record pic} saved. Do you mean "the type of nodes that @code{record pic} will save"? > +When @var{type} is set to @code{line} (the default), each node of vcg > +file that @code{record pic} saved will be a line of the inferior. > + > +When @var{type} is set to @code{function}, each node of vcg file that > +@code{record pic} saved will be a function of the inferior. Are these two the only types? If not, what are the other possible values? > +If ON (the default), @code{record pic} will hides the nodes that don't ^^^^^^^^^^ "will hide" > +If ON (the default), @code{record pic} will hides the nodes that ^^^^^^^^^^ "will hide" > +If ON (the default), @code{record pic} will hides the nodes that have Same here. > +the same address node in vcg file. And @code{record pic} will show > +the execute count number of this node in format @code{c:number} Show where? And what is "c" in @code{c:number}? > +If OFF, @code{record pic} will show the nodes that have the same > +address node in vcg file. And @code{record pic} will show the > +instruction number in format @code{i:number} that > +@value{record goto} support. Same here regarding the "i" part. Thanks.