Re: [wwwdocs] Mention variable tracking & location lists

[Josef Zlomek <zlomj9am at artax dot karlin dot mff dot cuni dot cz>]

> Hello,
> 
> this patch mentions location lists on the front page
> and adds info about caveats to gcc-3.5/changes.html
> 
> Index: htdocs/index.html
> ===================================================================
> RCS file: /cvs/gcc/wwwdocs/htdocs/index.html,v
> retrieving revision 1.416
> diff -c -p -c -3 -p -r1.416 index.html
> *** htdocs/index.html	6 Feb 2004 06:05:08 -0000	1.416
> --- htdocs/index.html	9 Feb 2004 16:41:38 -0000
> *************** to maintain and improve quality.</p>
> *** 87,92 ****
> --- 87,102 ----
>   
>   <dl>
>   
> + <dt><b>February 6, 2004</b></dt>
> + <dd>
> + Josef Zlomek of SUSE Labs and Daniel Berlin have contributed
> + Variable Tracking and location list generator.  It generates more accurate
> + debug info about variables' locations and enables us to debug code compiled
> + with <code>-fomit-frame-pointer</code>.
> + CVS GDB (which will become GDB 6.1) needs to be used for debugging with
> + location lists.
> + </dd>
> + 
>   <dt><b>October 18, 2003</b></dt>
>   <dd>
>   Bernardo Innocenti of Develer S.r.l. has contributed the
> Index: htdocs/gcc-3.5/changes.html
> ===================================================================
> RCS file: /cvs/gcc/wwwdocs/htdocs/gcc-3.5/changes.html,v
> retrieving revision 1.2
> diff -c -p -c -3 -p -r1.2 changes.html
> *** htdocs/gcc-3.5/changes.html	28 Jan 2004 23:02:12 -0000	1.2
> --- htdocs/gcc-3.5/changes.html	9 Feb 2004 16:41:38 -0000
> ***************
> *** 13,18 ****
> --- 13,32 ----
>   
>   <h2>Caveats</h2>
>   
> +   <ul>
> +     <li>GCC now generates location lists by default when compiling with debug
> + 	info and optimization.

I forgot <ul> here

> + 	<li>GDB 6.0 and older crashes when it sees location lists.
> + 	    CVS GDB (which will become GDB 6.1) is needed to debug binaries
> + 	    containing location lists.
> + 	<li>When you are trying to view a value of a variable in part of
> + 	    function where it has no location (for example when the variable
> + 	    is no longer used and thus its location was used for something else)
> + 	    GDB will say that it is not available.</li>

and </ul> here.

> + 	You can disable generating location lists by
> + 	<code>-fno-var-tracking</code>.</li>
> +   </ul>
> + 
>   <h2>General Optimizer Improvements</h2>
>   
>   <h2>New Languages and Language specific improvements</h2>
> ***************
> *** 29,34 ****
> --- 43,55 ----
>   <h2>Documentation improvements</h2>
>   
>   <h2>Other significant improvements</h2>
> + 
> +   <ul>
> +     <li>Location lists are now generated by default when compiling with debug
> + 	info and optimization.  It generates more accurate debug info about
> + 	variable's locations and enables us to debug code compiled with
> + 	<code>-fomit-frame-pointer</code>.</li>
> +   </ul>
>   
>   </body>
>   </html>

-- 
      Josef Zlomek
      zlomek@users.sf.net
      josef.zlomek@email.cz
      zlomj9am@artax.karlin.mff.cuni.cz
      http://zlomek.matfyz.cz/
      http://artax.karlin.mff.cuni.cz/~zlomj9am/
      ICQ: 152422432
      GPG fingerprint: 74E6 31D3 56D7 91FD 5A06  6BD5 96FF 99C4 25C0 EC0B