[www/RFA] Remove references to libgdb in GDB's web pages

[www/RFA] Remove references to libgdb in GDB's web pages

[Joel Brobecker]

[-- Attachment #1: Type: text/plain, Size: 806 bytes --]

Apparently, people can be mislead by these ancient papers that no longer
represent the direction that we want to take in terms of GDB development,
so Daniel suggested that we remove them.

Attached is a patch that removes the links to the papers on libgdb.
We can also delete papers/libgdb and papers/libgdb2 which are the
papers themselves.

(note that papers/index.html seems to be orphaned)

2009-03-26  Joel Brobecker  <brobecker@adacore.com>

  * documentation/index.html: Remove a reference to a libgdb paper.
  * papers/index.html: Remove references to both libgdb papers.
  * papers/libgdb: Delete this directory.
  * papers/libgdb2: Delete this directory.

Any objection?

PS: I made a change to documentation/index.html just earlier today,
    so the last-changed date does not change.

-- 
Joel

[-- Attachment #2: www-libgdb.diff --]
[-- Type: text/x-diff, Size: 1616 bytes --]

Index: documentation/index.html
===================================================================
RCS file: /cvs/gdb/htdocs/documentation/index.html,v
retrieving revision 1.45
diff -u -p -r1.45 index.html
--- documentation/index.html	26 Mar 2009 16:33:35 -0000	1.45
+++ documentation/index.html	26 Mar 2009 21:57:20 -0000
@@ -120,9 +120,6 @@ Maintainers of GNU Software</a>.</li>
 href="http://sourceware.org/gdb/current/onlinedocs/stabs_toc.html">Stabs
 debug format documentation</a></li>
 
-<li><a href="http://sourceware.org/gdb/papers/libgdb2/">The libGDB
-architecture</a>, Andrew Cagney
-
 <li><a href="http://sourceware.org/gdb/papers/multi-arch/" >Notes
 on multi-arch work</a>
 
Index: papers/index.html
===================================================================
RCS file: /cvs/gdb/htdocs/papers/index.html,v
retrieving revision 1.35
diff -u -p -r1.35 index.html
--- papers/index.html	7 Aug 2007 23:48:49 -0000	1.35
+++ papers/index.html	26 Mar 2009 21:57:20 -0000
@@ -50,8 +50,6 @@ Fish]" /></a>
 <!-- body, update above using ../../gdb/index.sh -->
 
 <ul>
-<li> <a href="libgdb">The original libgdb v0.3 paper (deprecated)</a>
-<li> <a href="libgdb2">The current libgdb project</a>
 <li> <a href="multi-arch">Documents and papers on multi-arch</a>
 <li> <a href="linux">Notes on SSE registers for LINUX</a>
 </ul>
@@ -97,7 +95,7 @@ Floor, Boston, MA 02110-1301 USA.</p>
 <p>Verbatim copying and distribution of this entire article is
 permitted in any medium, provided this notice is preserved.</p>
 
-<p>Last modified 2007-07-31.</p>
+<p>Last modified 2009-03-26.</p>
 </address>
 
 </body>

Re: [www/RFA] Remove references to libgdb in GDB's web pages

[Pedro Alves]

On Thursday 26 March 2009 22:06:44, Joel Brobecker wrote:

> 2009-03-26  Joel Brobecker  <brobecker@adacore.com>
>
>  * documentation/index.html: Remove a reference to a libgdb paper.
>  * papers/index.html: Remove references to both libgdb papers.
>  * papers/libgdb: Delete this directory.
>  * papers/libgdb2: Delete this directory.

> -<li> <a href="libgdb">The original libgdb v0.3 paper (deprecated)</a>
> -<li> <a href="libgdb2">The current libgdb project</a>

I'm a bit unconfortable in making a piece of history just disappear.

Can't we instead remove "current" from the link, and say somewhere that
this is not the path that GDB is now following?  Perhaps a short sensence
below the link?

-- 
Pedro Alves

Re: [www/RFA] Remove references to libgdb in GDB's web pages

[Joel Brobecker]

> I'm a bit unconfortable in making a piece of history just disappear.
> 
> Can't we instead remove "current" from the link, and say somewhere that
> this is not the path that GDB is now following?  Perhaps a short sensence
> below the link?

I can certainly do that. I'm not that uncomfortable because I think
it was a bad idea - bad idea for us due to the overhead of providing
a stable API, and also a bad idea (IMO) for the users, as it is much
more flexible to have the debugging module as a separate process
(if the process SEGVs, you don't die with it, of if there is a bug
in GDB you can switch to a newer version of GDB without changing
version of your tool, etc).

But perhaps you're right. I did certainly think at first that a libgdb
would be great. So it might be interesting to have a note on the website
explaining that this is no longer a current project. At least people
won't think that the idea is new and exciting.

Anway, will send a patch along what you propose ASAP. We can choose
whichever we prefer.

-- 
Joel

Re: [www/RFA] Remove references to libgdb in GDB's web pages

[Joel Brobecker]

[-- Attachment #1: Type: text/plain, Size: 631 bytes --]

> Can't we instead remove "current" from the link, and say somewhere that
> this is not the path that GDB is now following?  Perhaps a short sensence
> below the link?

Here is a new version of the patch. Does this look better?
Not being around when libgdb was being discussed, I hope that
the note that I wrote about it is accurate. Please let me know
if not.

        * documentation/index.html: Remove link to the libgdb documentation.
        * papers/index.hmtl: Show the second libgdb paper as deprecated.
        * papers/libgdb2/index.html: Add a note saying that this project
        has been abandoned.

Thanks,
-- 
Joel

[-- Attachment #2: libgdb-doc.diff --]
[-- Type: text/x-diff, Size: 2822 bytes --]

Index: documentation/index.html
===================================================================
RCS file: /cvs/gdb/htdocs/documentation/index.html,v
retrieving revision 1.45
diff -u -p -r1.45 index.html
--- documentation/index.html	26 Mar 2009 16:33:35 -0000	1.45
+++ documentation/index.html	30 Mar 2009 16:53:00 -0000
@@ -120,9 +120,6 @@ Maintainers of GNU Software</a>.</li>
 href="http://sourceware.org/gdb/current/onlinedocs/stabs_toc.html">Stabs
 debug format documentation</a></li>
 
-<li><a href="http://sourceware.org/gdb/papers/libgdb2/">The libGDB
-architecture</a>, Andrew Cagney
-
 <li><a href="http://sourceware.org/gdb/papers/multi-arch/" >Notes
 on multi-arch work</a>
 
@@ -234,7 +231,7 @@ Floor, Boston, MA 02110-1301 USA.</p>
 <p>Verbatim copying and distribution of this entire article is
 permitted in any medium, provided this notice is preserved.</p>
 
-<p>Last modified 2009-03-26.</p>
+<p>Last modified 2009-03-30.</p>
 </address>
 
 </body>
Index: papers/index.html
===================================================================
RCS file: /cvs/gdb/htdocs/papers/index.html,v
retrieving revision 1.35
diff -u -p -r1.35 index.html
--- papers/index.html	7 Aug 2007 23:48:49 -0000	1.35
+++ papers/index.html	30 Mar 2009 16:53:00 -0000
@@ -51,7 +51,7 @@ Fish]" /></a>
 
 <ul>
 <li> <a href="libgdb">The original libgdb v0.3 paper (deprecated)</a>
-<li> <a href="libgdb2">The current libgdb project</a>
+<li> <a href="libgdb2">The libgdb project (deprecated)</a>
 <li> <a href="multi-arch">Documents and papers on multi-arch</a>
 <li> <a href="linux">Notes on SSE registers for LINUX</a>
 </ul>
@@ -97,7 +97,7 @@ Floor, Boston, MA 02110-1301 USA.</p>
 <p>Verbatim copying and distribution of this entire article is
 permitted in any medium, provided this notice is preserved.</p>
 
-<p>Last modified 2007-07-31.</p>
+<p>Last modified 2009-03-30.</p>
 </address>
 
 </body>
Index: papers/libgdb2/index.html
===================================================================
RCS file: /cvs/gdb/htdocs/papers/libgdb2/index.html,v
retrieving revision 1.3
diff -u -p -r1.3 index.html
--- papers/libgdb2/index.html	19 Sep 2002 19:42:18 -0000	1.3
+++ papers/libgdb2/index.html	30 Mar 2009 16:53:00 -0000
@@ -3,7 +3,17 @@
 <title>libGDB</title>
 </head>
 <body>
+
 libGDB document
+<p>
+Note that this project has been abandoned many years ago (as of
+2009-03-30) in favor of other solutions.  For instance, interfacing
+with the debugger has been simplified through the introduction of
+GDB/MI.  More recently, Python support is being actively added to
+extend the range of features accessible through GDB (see
+<A HREF="http://sourceware.org/gdb/wiki/PythonGdb">PythonGdb</A>
+for more info).
+
 <ul>
 <li> <a href=libgdb_toc.html>Multi-page HTML</a>
 <li> <a href=libgdb.html>Single-page HTML</a>

Re: [www/RFA] Remove references to libgdb in GDB's web pages

[Pedro Alves]

On Monday 30 March 2009 17:56:29, Joel Brobecker wrote:
> > Can't we instead remove "current" from the link, and say somewhere that
> > this is not the path that GDB is now following?  Perhaps a short sensence
> > below the link?
> 
> Here is a new version of the patch. Does this look better?

Thanks Joel.  Just confirming what I said on IRC --- this is fine
with me.  Thank you!

> Not being around when libgdb was being discussed, I hope that
> the note that I wrote about it is accurate. Please let me know
> if not.
> 
>         * documentation/index.html: Remove link to the libgdb documentation.
>         * papers/index.hmtl: Show the second libgdb paper as deprecated.
>         * papers/libgdb2/index.html: Add a note saying that this project
>         has been abandoned.
> 

-- 
Pedro Alves