From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <gdb-return-36242-listarch-gdb=sources.redhat.com@sourceware.org>
Received: (qmail 19636 invoked by alias); 9 Nov 2009 18:48:57 -0000
Received: (qmail 19624 invoked by uid 22791); 9 Nov 2009 18:48:56 -0000
X-SWARE-Spam-Status: No, hits=-2.5 required=5.0 	tests=AWL,BAYES_00,SPF_PASS
X-Spam-Check-By: sourceware.org
Received: from mail.codesourcery.com (HELO mail.codesourcery.com) (38.113.113.100)     by sourceware.org (qpsmtpd/0.43rc1) with ESMTP; Mon, 09 Nov 2009 18:48:53 +0000
Received: (qmail 23722 invoked from network); 9 Nov 2009 18:48:48 -0000
Received: from unknown (HELO orlando) (pedro@127.0.0.2)   by mail.codesourcery.com with ESMTPA; 9 Nov 2009 18:48:48 -0000
From: Pedro Alves <pedro@codesourcery.com>
To: gdb@sourceware.org
Subject: Re: Thoughts on the GDB "documentation" web page
Date: Mon, 09 Nov 2009 20:09:00 -0000
User-Agent: KMail/1.9.10
Cc: Joel Brobecker <brobecker@adacore.com>
References: <20091109174427.GR22192@adacore.com>
In-Reply-To: <20091109174427.GR22192@adacore.com>
MIME-Version: 1.0
Content-Type: text/plain;   charset="iso-8859-1"
Content-Transfer-Encoding: quoted-printable
Content-Disposition: inline
Message-Id: <200911091848.46732.pedro@codesourcery.com>
X-IsSubscribed: yes
Mailing-List: contact gdb-help@sourceware.org; run by ezmlm
Precedence: bulk
List-Id: <gdb.sourceware.org>
List-Subscribe: <mailto:gdb-subscribe@sourceware.org>
List-Archive: <http://sourceware.org/ml/gdb/>
List-Post: <mailto:gdb@sourceware.org>
List-Help: <mailto:gdb-help@sourceware.org>, <http://sourceware.org/ml/#faqs>
Sender: gdb-owner@sourceware.org
X-SW-Source: 2009-11/txt/msg00098.txt.bz2

On Monday 09 November 2009 17:44:27, Joel Brobecker wrote:
> =A0 =A0 | =A0 =A0Online GDB Documentation
> =A0 =A0 | =A0 =A0GDB provides a set of documents (including manuals) that=
 are
> =A0 =A0 | =A0 =A0available from the links below:
> =A0 =A0 | =A0 =A0 =A0* For the <URL>last release</URL>
> =A0 =A0 | =A0 =A0 =A0* For the <URL>head branch</URL>
> =A0 =A0 | =A0 =A0 =A0* For the currently active <URL>branch</URL>
> =A0 =A0 |
> =A0 =A0 | =A0 =A0Printed Manuals
> =A0 =A0 | =A0 =A0<contents unchanged>
> =A0 =A0 |
> =A0 =A0 | =A0 =A0Translated manuals
> =A0 =A0 | =A0 =A0Translations of the GDB manual are also available:
> =A0 =A0 | =A0 =A0 =A0[...]
>=20

I never quite understood the policy of having "last release" up only.
Why not have something like the gcc folks have?

 http://gcc.gnu.org/onlinedocs/

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

These are manuals for the latest releases.

    * GDB 7.0 manuals:
          o <URL>GDB User Manual</URL> (<URL>also in PDF</URL> or <URL>Post=
Script</URL> or an <URL>HTML tarball</URL>)
          o <URL>GDB Internals Manual</URL> (<URL>also in PDF</URL> or <URL=
>PostScript</URL> or an <URL>HTML tarball</URL>)
    * GDB 6.8 manuals:
          o GDB User Manual (also in PDF or PostScript or an HTML tarball)
          o GDB Internals Manual (also in PDF or PostScript or an HTML tarb=
all)
    * GDB 6.7 manuals:
          o GDB User Manual (also in PDF or PostScript or an HTML tarball)
          o GDB Internals Manual (also in PDF or PostScript or an HTML tarb=
all)
    ...

Current development

Please note that the following documentation refers to current development.=
 Some information may not be applicable to any existing release.

          o GDB User Manual (also in PDF or PostScript or an HTML tarball)
          o GDB Internals Manual (also in PDF or PostScript or an HTML tarb=
all)

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

This gives emphasis to _releases_, which, IMO is the right
thing to do.

One problem with the "last release" kind of links is
that "last release" is not stable over time.  A scheme like
the above has no such problem.  A cross-link from a random
site to to a page in our 6.8 manual should be live forever;
something that is not true currently.

--=20
Pedro Alves