RFC: update www.gnu.org/software/gdb for 6.4 release

RFC: update www.gnu.org/software/gdb for 6.4 release

[Jim Blandy]

Here's a patch to update www.gnu.org/software/gdb in light of the 6.4
release.  This fixes www/2068.

The steps required:
- get a Savannah account
- add an SSH key
- get added to the GDB group
- check out the web pages and fix them

I'm not sure we have anyone responsible for reviewing changes there,
but certainly it makes sense to give the group a chance to look things
over.  So please give it a look.

Index: index.html
===================================================================
RCS file: /webcvs/gdb/gdb/index.html,v
retrieving revision 1.16
diff -c -p -r1.16 index.html
*** index.html	21 Jun 2005 14:51:52 -0000	1.16
--- index.html	12 Jan 2006 22:25:22 -0000
*************** executing on the same machine as GDB (na
*** 69,77 ****
  (remote).  GDB can run on most popular UNIX and Microsoft Windows
  variants.<p>

! <h3>GDB version 6.3</h3>

! Version <a href="../gdb/download/ANNOUNCEMENT">6.3</a> of GDB, the GNU
  Debugger, is now available for <a
  href="../gdb/download/">download</a>.  See the <a
  href="../gdb/download/ANNOUNCEMENT">ANNOUNCEMENT</a> for details
--- 69,77 ----
  (remote).  GDB can run on most popular UNIX and Microsoft Windows
  variants.<p>

! <h3>GDB version 6.4</h3>

! Version <a href="../gdb/download/ANNOUNCEMENT">6.4</a> of GDB, the GNU
  Debugger, is now available for <a
  href="../gdb/download/">download</a>.  See the <a
  href="../gdb/download/ANNOUNCEMENT">ANNOUNCEMENT</a> for details
*************** better.
*** 101,143 ****

  -->

! <dt>November 9, 2004: <b>GDB 6.3 Released!</b></dt>
  <dd>
! <p> The latest version of GDB, version 6.3, is available for <a
! href="../gdb/download/">download</a>.
! <p>
! Changes in this release include:
  <ul>
! <li>GDB works with GCC -feliminate-dwarf2-dups<br>
! GDB now supports a more compact representation of DWARF-2 debug
! information using DW_FORM_ref_addr references.  These are produced
! by GCC with the option -feliminate-dwarf2-dups and also by some
! proprietary compilers.  With GCC, you must use GCC 3.3.4 or later
! to use -feliminate-dwarf2-dups.
! <li>Internationalization<br>
! When supported by the host system, GDB will be built with
! internationalization (libintl).  The task of marking up the sources is
! continued, we're looking forward to our first translation.
! <li>Ada<br>
! Initial support for debugging programs compiled with the GNAT
! implementation of the Ada programming language has been integrated
! into GDB.  In this release, support is limited to expression evaluation.
  </ul>
  <p>
  </dd>

- <dt>October 19, 2004: <b>GDB 6.3 branch created</b></dt>
- <dd>
- <p> The GDB 6.3 branch (<tt>gdb_6_3-branch</tt>) has been created.
- To check out a copy of the branch use:
- <pre>
- cvs -d :pserver:anoncvs@sources.redhat.com:/cvs/src co -r gdb_6_3-branch gdb
- </pre>
- <p>
- </dd>
-
- </dl>
-
  Late breaking information, such as recently added features, can be
  found in the <a
  href="http://sources.redhat.com/cgi-bin/cvsweb.cgi/~checkout~/src/gdb/NEWS?content-type=text/x-cvsweb-markup&cvsroot=src"
--- 101,132 ----

  -->

! <dt>December 1, 2005: <b>GDB 6.4 Released!</b></dt>
  <dd>
! <p> The latest version of GDB, version 6.4, is available for <a
href="../../gdb/download/">download</a>.
!
! Since the previous release (6.3, released one year ago) we've made
! many fixes and enhancements.  Highlights:
!
  <ul>
!   <li>GDB can now debug programs natively on OpenBSD/arm and OpenBSD/mips64.
!   <li>GDB can cross-debug programs compiled for the Morpho Technologies ms1.
!   <li>GDB provides new command-line options useful for writing scripts
!       using GDB.
!   <li>GDB now has user-level threads support for FreeBSD/amd64,
!       FreeBSD/i386, and OpenBSD/i386.  (However, note that the kernel
!       threads libraries introduced in FreeBSD 5.x are not yet
!       supported.)
!   <li>GDB support for the Matsushita MN10300 has been restored.
!   <li>Enabling a new setting, <tt>set print array-indexes</tt>, tells
!       GDB to include indices when printing array values.
!   <li>GDB supports VAX floating point formats.
!   <li>User-defined commands can consult a new convenience variable,
!       <tt>$argc</tt>, to see how many arguments they were passed.
  </ul>
  <p>
  </dd>

  Late breaking information, such as recently added features, can be
  found in the <a
  href="http://sources.redhat.com/cgi-bin/cvsweb.cgi/~checkout~/src/gdb/NEWS?content-type=text/x-cvsweb-markup&cvsroot=src"
Index: download/ANNOUNCEMENT
===================================================================
RCS file: /webcvs/gdb/gdb/download/ANNOUNCEMENT,v
retrieving revision 1.12
diff -c -p -r1.12 ANNOUNCEMENT
*** download/ANNOUNCEMENT	10 Nov 2004 01:41:02 -0000	1.12
--- download/ANNOUNCEMENT	12 Jan 2006 22:25:22 -0000
***************
*** 1,94 ****
! 		    GDB 6.3 released!

! Release 6.3 of GDB, the GNU Debugger, is now available via anonymous
! FTP.  GDB is a source-level debugger for C, C++, Java and many other
  languages.  GDB can target (i.e., debug programs running on) more than
  a dozen different processor architectures, and GDB itself can run on
  most popular GNU/Linux, Unix and Microsoft Windows variants.

! Since the previous release (6.2.1, released 8 weeks ago) we've made
  many fixes and enhancements including:

! * GDB works with GCC -feliminate-dwarf2-dups

! GDB now supports a more compact representation of DWARF-2 debug
! information using DW_FORM_ref_addr references.  These are produced
! by GCC with the option -feliminate-dwarf2-dups and also by some
! proprietary compilers.  With GCC, you must use GCC 3.3.4 or later
! to use -feliminate-dwarf2-dups.

! * Internationalization

! When supported by the host system, GDB will be built with
! internationalization (libintl).  The task of marking up the sources is
! continuing, we're looking forward to our first translation.

! * Ada

! Initial support for debugging programs compiled with the GNAT
! implementation of the Ada programming language has been integrated
! into GDB.  In this release, support is limited to expression evaluation.

! * New native configurations

! GNU/Linux/m32r					m32r-*-linux-gnu

! * Remote 'p' packet

! GDB's remote protocol now includes support for the 'p' packet.  This
! packet is used to fetch individual registers from a remote inferior.

! * END-OF-LIFE registers[] compatibility module

! GDB's internal register infrastructure has been completely rewritten.
! The new infrastructure making possible the implementation of key new
! features including 32x64 (e.g., 64-bit amd64 GDB debugging a 32-bit
! i386 application).

! GDB 6.3 will be the last release to include the the registers[]
! compatibility module that allowed out-of-date configurations to
! continue to work.  This change directly impacts the following
! configurations:

! hppa-*-hpux
! ia64-*-aix
! mips-*-irix*
! *-*-lynx
! mips-*-linux-gnu
! sds protocol
! xdr protocol
! powerpc bdm protocol

! Unless there is activity to revive these configurations, they will be
! made OBSOLETE in GDB 6.4, and REMOVED from GDB 6.5.

! * OBSOLETE configurations and files

! Configurations that have been declared obsolete in this release have
! been commented out.  Unless there is activity to revive these
! configurations, the next release of GDB will have their sources
! permanently REMOVED.

! h8300-*-*
! mcore-*-*
! mn10300-*-*
! ns32k-*-*
! sh64-*-*
! v850-*-*

! You can download GDB from Project GNU's FTP server in the directory:

! 	ftp://ftp.gnu.org/gnu/gdb

! The vital stats:

! 	Size  md5sum                            Name
! 	17mb  812de9e756d53c749ea5516d9ffa5905  gdb-6.2.tar.gz
! 	13mb  05b928f41fa5b482e49ca2c24762a0ae  gdb-6.2.tar.bz2

  There is a web page for GDB at:

! 	http://www.gnu.org/software/gdb/

  That page includes information about GDB mailing lists (an
  announcement mailing list, developers discussion lists, etc.), details
--- 1,107 ----
! Date: Thu, 1 Dec 2005 23:14:28 -0800
! From: Joel Brobecker <brobecker at adacore dot com>
! To: gdb-announce at sources dot redhat dot com
! Subject: GDB 6.4 Released
! Message-ID: <20051202071428.GF1215@adacore.com>

!
!             GDB 6.4 released!
!
! Release 6.4 of GDB, the GNU Debugger, is now available via anonymous
! FTP.  GDB is a source-level debugger for C, C++, Ada, Java and many other
  languages.  GDB can target (i.e., debug programs running on) more than
  a dozen different processor architectures, and GDB itself can run on
  most popular GNU/Linux, Unix and Microsoft Windows variants.

! Since the previous release (6.3, released one year ago) we've made
  many fixes and enhancements including:

! * New native configurations

! OpenBSD/arm			arm*-*-openbsd*
! OpenBSD/mips64			mips64-*-openbsd*

! * New targets

! Morpho Technologies ms1		ms1-elf

! * New command line options

! --batch-silent			As for --batch, but totally silent.
! --return-child-result		The debugger will exist with the same value
! 				the child (debugged) program exited with.
! --eval-command COMMAND, -ex COMMAND
! 				Execute a single GDB CLI command. This may be
! 				specified multiple times and in conjunction
! 				with the --command (-x) option.

! * Deprecated commands removed
!
! The following commands, that were deprecated in 2000, have been
! removed:

!   Command				Replacement
!   set|show arm disassembly-flavor	set|show arm disassembler
!   othernames				set arm disassembler
!   set|show remotedebug			set|show debug remote
!   set|show archdebug			set|show debug arch
!   set|show eventdebug			set|show debug event
!   regs					info registers

! * New BSD user-level threads support

! It is now possible to debug programs using the user-level threads
! library on OpenBSD and FreeBSD.  Currently supported (target)
! configurations are:

! FreeBSD/amd64			x86_64-*-freebsd*
! FreeBSD/i386			i386-*-freebsd*
! OpenBSD/i386			i386-*-openbsd*

! Note that the new kernel threads libraries introduced in FreeBSD 5.x
! are not yet supported.

! * New support for Matsushita MN10300 w/sim added
! (Work in progress).  mn10300-elf.

! * REMOVED configurations and files

! VxWorks and the XDR protocol			*-*-vxworks
! Renesas H8/300S					h8300*-*-*
! Motorola MCORE                                  mcore-*-*
! Matsushita MN10300 w/simulator			mn10300-*-*
! National Semiconductor NS32000			ns32k-*-*
! NEC V850					v850-*-*

! * New "set print array-indexes" command

! After turning this setting "on", GDB prints the index of each element
! when displaying arrays.  The default is "off" to preserve the previous
! behavior.

! * VAX floating point support

! GDB now supports the not-quite-ieee VAX F and D floating point formats.

! * User-defined command support

! In addition to using $arg0..$arg9 for argument passing, it is now possible
! to use $argc to determine now many arguments have been passed.  See the
! section on user-defined commands in the user manual for more information.

! You can download GDB from the GNU FTP server in the directory:
!
!         ftp://ftp.gnu.org/gnu/gdb
!
! The vital stats:
!
!   Size  md5sum                            Name
!   14mb  f62c14ba0316bc88e1b4b32a4e901ffb  gdb-6.4.tar.bz2
!   18mb  7dc98022ee96bba5331f195dc8a5491a  gdb-6.4.tar.gz

  There is a web page for GDB at:

!         http://www.gnu.org/software/gdb/

  That page includes information about GDB mailing lists (an
  announcement mailing list, developers discussion lists, etc.), details
*************** information around the net.  We will put
*** 98,214 ****
  host-specific tips for this release on-line as any problems come up.
  All mailing lists archives are also browsable via the web.

! Finally, and most importantly, credit must go to Andreas Schwab,
! Ashley Pittman, Baurjan Ismagulov, Corinna Vinschen, Daniel
! Jacobowitz, David Anderson, David Carlton, David Lecomber, Elena
! Zannoni, Eli Zaretskii, Eric Botcazou, Jason Molenda, Jeff Johnston,
! Jerome Guitton, Jim Blandy, Joel Brobecker, Kei Sakamoto, Kevin
! Buettner, Maciej W. Rozycki, Manoj Iyer, Mark Kettenis, Martin Hunt,
! Michael Chastain, Michael Snyder, Nathan J. Williams, Nathanael
! Nerode, Nick Roberts, Orjan Friberg, Paul GIlliam, Paul Hilfinger,
! Ramana Radhakrishnan, Randolph Chung, Richard Earnshaw, Robert Millan,
! Robert Picco, Salvador E. Tropea, and Ulrich Weigand!
!
! Andrew Cagney
! Release Manager
! \f
!
! 			Known problems in GDB 6.3
!
! 		See also: http://www.gnu.org/software/gdb/bugs/
!
!
! *** Build problems
!
! build/1411: build fails on hpux 10.20 and hpux 11.00 with CMA threads
!
! GDB does not build on HP/UX 10.20 or HP/UX 11.00 if the CMA
! thread package is installed.  The compile error is:
!
!   ../../gdb/hpux-thread.c:222: variable-size type declared outside
of any function
!
! This happens only if the CMA thread package is installed.
!
! As a workaround, you can disable support for CMA threads
! by editing the file gdb/configure.  Find the line:
!
!   if test -f /usr/include/dce/cma_config.h ; then
!
! And replace it with:
!
!   if false ; then
!
! *** Misc
!
! gdb/1560: Control-C does not always interrupt GDB.
!
! When GDB is busy processing a command which takes a long time to
! complete, hitting Control-C does not have the expected effect.
! The command execution is not aborted, and the "QUIT" message confirming
! the abortion is displayed only after the command has been completed.
!
! *** C++ support
!
! gdb/931: GDB could be more generous when reading types C++ templates on input
!
! When the user types a template, GDB frequently requires the type to be
! typed in a certain way (e.g. "const char*" as opposed to "const char *"
! or "char const *" or "char const*").
!
! gdb/1512: no canonical way to output names of C++ types
!
! We currently don't have any canonical way to output names of C++ types.
! E.g. "const char *" versus "char const *"; more subtleties arise when
! dealing with templates.
!
! gdb/1516: [regression] local classes, gcc 2.95.3, dwarf-2
!
! With gcc 2.95.3 and the dwarf-2 debugging format, classes which are
! defined locally to a function include the demangled name of the function
! as part of their name.  For example, if a function "foobar" contains a
! local class definition "Local", gdb will say that the name of the class
! type is "foobar__Fi.0:Local".
!
! This applies only to classes where the class type is defined inside a
! function, not to variables defined with types that are defined somewhere
! outside any function (which most types are).
!
! gdb/1588: names of c++ nested types in casts must be enclosed in quotes
!
! You must type
!   (gdb) print ('Foo::Bar') x
! or
!   (gdb) print ('Foo::Bar' *) y
! instead of
!   (gdb) print (Foo::Bar) x
! or
!   (gdb) print (Foo::Bar *) y
! respectively.
!
! gdb/1091: Constructor breakpoints ignored
! gdb/1193: g++ 3.3 creates multiple constructors: gdb 5.3 can't set breakpoints
!
! When gcc 3.x compiles a C++ constructor or C++ destructor, it generates
! 2 or 3 different versions of the object code.  These versions have
! unique mangled names (they have to, in order for linking to work), but
! they have identical source code names, which leads to a great deal of
! confusion.  Specifically, if you set a breakpoint in a constructor or a
! destructor, gdb will put a breakpoint in one of the versions, but your
! program may execute the other version.  This makes it impossible to set
! breakpoints reliably in constructors or destructors.
!
! gcc 3.x generates these multiple object code functions in order to
! implement virtual base classes.  gcc 2.x generated just one object code
! function with a hidden parameter, but gcc 3.x conforms to a multi-vendor
! ABI for C++ which requires multiple object code functions.
!
! *** Threads
!
! threads/1650: manythreads.exp
!
! On GNU/Linux systems that use the old LinuxThreads thread library, a
! program rapidly creating and deleting threads can confuse GDB leading
! to an internal error.

! This problem does not occur on newer systems that use the NPTL
! library, and did not occur with GDB 6.1.
--- 111,131 ----
  host-specific tips for this release on-line as any problems come up.
  All mailing lists archives are also browsable via the web.

! This release is the result of a team effort of many individuals who
! have contributed to this project. This includes: Alan Modra, Andreas
! Schwab, Andrew Cagney, Andrew Stubbs, Anthony Green, Baurzhan Ismagulov,
! Ben Elliston, Bob Rossi, Chris Demetriou, Christopher Faylor, Corinna
! Vinschen, Daniel Jacobowitz, David Lecomber, David S. Miller, David Ung,
! Elena Zannoni, Eli Zaretskii, Eric Christopher, Fred Fish, Frederic
! Riss, H.J. Lu, Hans-Peter Nilsson, Ian Lance Taylor, James E Wilson, Jan
! Beulich, Jason Thorpe, Jeff Johnston, Jerome Guitton, Jim Blandy, Jim
! Wilson, Joel Brobecker, John David Anglin, Jon Beniston, Kaveh R. Ghazi,
! Kei Sakamoto, Kevin Buettner, Kris Warkentin, Manoj Iyer, Mark Kettenis,
! Mark Mitchell, Martin Hunt, Michael Snyder, Nathan Sidwell, Nick
! Roberts, Orjan Friberg, Paul Brook, Paul Gilliam, Paul N. Hilfinger,
! Ramana Radhakrishnan, Randolph Chung, Richard Earnshaw, Richard
! Henderson, Richard Sandiford, Stephane Carrez, Steve Ellcey, Thiemo
! Seufer, Ulrich Weigand, Wu Zhou, Yoshinori Sato. Thank you!

! --
! Joel
Index: download/index.html
===================================================================
RCS file: /webcvs/gdb/gdb/download/index.html,v
retrieving revision 1.15
diff -c -p -r1.15 index.html
*** download/index.html	21 Jun 2005 14:51:53 -0000	1.15
--- download/index.html	12 Jan 2006 22:25:22 -0000
*************** Fish]" /></a>
*** 46,52 ****

  <!-- body, update above using ../../gdb/index.sh -->

! <h3>The most recent release (<a href="ANNOUNCEMENT">GDB 6.3</a>):</h3>

  You can download the most recent official release of GDB from either
  Project GNU's FTP server, or Red Hat's sources site:
--- 46,52 ----

  <!-- body, update above using ../../gdb/index.sh -->

! <h3>The most recent release (<a href="ANNOUNCEMENT">GDB 6.4</a>):</h3>

  You can download the most recent official release of GDB from either
  Project GNU's FTP server, or Red Hat's sources site:
Index: news/index.html
===================================================================
RCS file: /webcvs/gdb/gdb/news/index.html,v
retrieving revision 1.16
diff -c -p -r1.16 index.html
*** news/index.html	21 Jun 2005 14:51:54 -0000	1.16
--- news/index.html	12 Jan 2006 22:25:22 -0000
*************** better.
*** 60,65 ****
--- 60,91 ----

  -->

+ <dt>December 1, 2005: <b>GDB 6.4 Released!</b></dt>
+ <dd>
+ <p> The latest version of GDB, version 6.4, is available for <a
href="../../gdb/download/">download</a>.
+
+ Since the previous release (6.3, released one year ago) we've made
+ many fixes and enhancements.  Highlights:
+
+ <ul>
+   <li>GDB can now debug programs natively on OpenBSD/arm and OpenBSD/mips64.
+   <li>GDB can cross-debug programs compiled for the Morpho Technologies ms1.
+   <li>GDB provides new command-line options useful for writing scripts
+       using GDB.
+   <li>GDB now has user-level threads support for FreeBSD/amd64,
+       FreeBSD/i386, and OpenBSD/i386.  (However, note that the kernel
+       threads libraries introduced in FreeBSD 5.x are not yet
+       supported.)
+   <li>GDB support for the Matsushita MN10300 has been restored.
+   <li>Enabling a new setting, <tt>set print array-indexes</tt>, tells
+       GDB to include indices when printing array values.
+   <li>GDB supports VAX floating point formats.
+   <li>User-defined commands can consult a new convenience variable,
+       <tt>$argc</tt>, to see how many arguments they were passed.
+ </ul>
+ <p>
+ </dd>
+
  <dt>November 9, 2004: <b>GDB 6.3 Released!</b></dt>
  <dd>
  <p> The latest version of GDB, version 6.3, is available for <a

Re: RFC: update www.gnu.org/software/gdb for 6.4 release

[Joel Brobecker]

> I'm not sure we have anyone responsible for reviewing changes there,
> but certainly it makes sense to give the group a chance to look things
> over.  So please give it a look.

When we discussed this, I think the consensus was that htdocs changes
were the responsibility of the GMs. All changes to htdocs, at least
by me, have been posted here.

The gnu.org pages are supposed to be the same as the sourceware one,
right? If yes, then the changes below should just be a diff between
the current image at gnu.org and the one at sourceware.org. It's
difficult to tell, it almost looks like you only extracted the
6.4 announcement.

-- 
Joel

Re: RFC: update www.gnu.org/software/gdb for 6.4 release

[Jim Blandy]

On 1/12/06, Joel Brobecker <brobecker@adacore.com> wrote:
> The gnu.org pages are supposed to be the same as the sourceware one,
> right? If yes, then the changes below should just be a diff between
> the current image at gnu.org and the one at sourceware.org. It's
> difficult to tell, it almost looks like you only extracted the
> 6.4 announcement.

You know, I didn't even notice that.  Of course they're supposed to be
the same.  Let me try again.