unreachable intro to gcc page linked to on readings page

unreachable intro to gcc page linked to on readings page

[Van Ly]

Hello,

On the readings page

  . https://gcc.gnu.org/readings.html

a broken link points to

  An introduction to GCC by Brian J. Gough.
  . http://www.network-theory.co.uk/gcc/intro/

which has a copy at

  . https://web.archive.org/web/20060106062936/http://www.network-theory.co.uk/gcc/intro/

-- 
vl

Re: unreachable intro to gcc page linked to on readings page

[Jonathan Wakely]

On Sun, 7 Aug 2022 at 09:33, Van Ly via Gcc <gcc@gcc.gnu.org> wrote:
>
>
> Hello,
>
> On the readings page
>
>   . https://gcc.gnu.org/readings.html
>
> a broken link points to
>
>   An introduction to GCC by Brian J. Gough.
>   . http://www.network-theory.co.uk/gcc/intro/
>
> which has a copy at
>
>   . https://web.archive.org/web/20060106062936/http://www.network-theory.co.uk/gcc/intro/

Thanks for letting us know.

There are much more recent archived copies like
https://web.archive.org/web/20181113021321/http://www.network-theory.co.uk/gcc/intro/
I'm not sure it's worth updating the link to an archived copy of that
page, because all the links for buying a PDF or printed copy are
probably dead now anyway.

We could link to https://archive.org/details/B-001-002-835 instead, or
to the archived HTML version. The newest capture of the HTML version
seems to be this, although I didn't check that all pages are archived:
https://web.archive.org/web/20181206025406/http://www.network-theory.co.uk/docs/gccintro/
My preference would be to link to that latter. Although it's quite
dated, the sections on basic compilation and compiler flags are still
relevant for beginners.

Gerald?

Re: unreachable intro to gcc page linked to on readings page

[Gerald Pfeifer]

On Wed, 24 Aug 2022, Jonathan Wakely wrote:
>> a broken link points to
>>
>>   An introduction to GCC by Brian J. Gough.
>>   . http://www.network-theory.co.uk/gcc/intro/
> There are much more recent archived copies like
> https://web.archive.org/web/20181113021321/http://www.network-theory.co.uk/gcc/intro/
> I'm not sure it's worth updating the link to an archived copy of that
> page, because all the links for buying a PDF or printed copy are
> probably dead now anyway.
> 
> We could link to https://archive.org/details/B-001-002-835 instead, or
> to the archived HTML version. The newest capture of the HTML version
> seems to be this, although I didn't check that all pages are archived:
> https://web.archive.org/web/20181206025406/http://www.network-theory.co.uk/docs/gccintro/
> My preference would be to link to that latter. Although it's quite
> dated, the sections on basic compilation and compiler flags are still
> relevant for beginners.
> 
> Gerald?

I searched around a bit myself (since indeed the original and printed 
versions seem to be gone) and landed at

   https://archive.org/details/B-001-002-835

as well. I probably would have gone for that, though the 
web.archive.org/web link you found works equally if you want to point 
there instead.

Gerald (who appears in the Acknowledgement section of that book :-)

[wwwdocs] Re: unreachable intro to gcc page linked to on readings page

[Jonathan Wakely]

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

On Mon, 29 Aug 2022 at 11:31, Gerald Pfeifer wrote:
>
> On Wed, 24 Aug 2022, Jonathan Wakely wrote:
> >> a broken link points to
> >>
> >>   An introduction to GCC by Brian J. Gough.
> >>   . http://www.network-theory.co.uk/gcc/intro/
> > There are much more recent archived copies like
> > https://web.archive.org/web/20181113021321/http://www.network-theory.co.uk/gcc/intro/
> > I'm not sure it's worth updating the link to an archived copy of that
> > page, because all the links for buying a PDF or printed copy are
> > probably dead now anyway.
> >
> > We could link to https://archive.org/details/B-001-002-835 instead, or
> > to the archived HTML version. The newest capture of the HTML version
> > seems to be this, although I didn't check that all pages are archived:
> > https://web.archive.org/web/20181206025406/http://www.network-theory.co.uk/docs/gccintro/
> > My preference would be to link to that latter. Although it's quite
> > dated, the sections on basic compilation and compiler flags are still
> > relevant for beginners.
> >
> > Gerald?
>
> I searched around a bit myself (since indeed the original and printed
> versions seem to be gone) and landed at
>
>    https://archive.org/details/B-001-002-835
>
> as well. I probably would have gone for that, though the
> web.archive.org/web link you found works equally if you want to point
> there instead.

Why not both?  I've pushed the attached patch to [wwwdocs].

[-- Attachment #2: patch.txt --]
[-- Type: text/plain, Size: 849 bytes --]

commit 0e4c9a39789b6dbcd44b2e0d4a42b5885d3bddb2
Author: Jonathan Wakely <jwakely@redhat.com>
Date:   Thu Sep 1 10:57:46 2022 +0100

    Replace stale link to the "An Introduction to GCC" book

diff --git a/htdocs/readings.html b/htdocs/readings.html
index 4269e9f0..5d1b78e8 100644
--- a/htdocs/readings.html
+++ b/htdocs/readings.html
@@ -22,8 +22,9 @@
 
 <ul>
 
-  <li><a href="http://www.network-theory.co.uk/gcc/intro/">An Introduction
-  to GCC</a> by Brian J. Gough.</li>
+  <li><a href="https://web.archive.org/web/20060106062936/http://www.network-theory.co.uk/gcc/intro/">An Introduction
+  to GCC</a> by Brian J. Gough
+  (<a href="https://archive.org/details/B-001-002-835/">e-book</a>).</li>
 
   <li><a href="https://en.wikibooks.org/wiki/GNU_C_Compiler_Internals">GNU C Compiler Internals (Wikibook)</a>, numerous contributors.</li>
 

Re: [wwwdocs] Re: unreachable intro to gcc page linked to on readings page

[Jonathan Wakely]

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

On Thu, 1 Sept 2022 at 12:01, Jonathan Wakely <jwakely.gcc@gmail.com> wrote:
>
> On Mon, 29 Aug 2022 at 11:31, Gerald Pfeifer wrote:
> >
> > On Wed, 24 Aug 2022, Jonathan Wakely wrote:
> > >> a broken link points to
> > >>
> > >>   An introduction to GCC by Brian J. Gough.
> > >>   . http://www.network-theory.co.uk/gcc/intro/
> > > There are much more recent archived copies like
> > > https://web.archive.org/web/20181113021321/http://www.network-theory.co.uk/gcc/intro/
> > > I'm not sure it's worth updating the link to an archived copy of that
> > > page, because all the links for buying a PDF or printed copy are
> > > probably dead now anyway.
> > >
> > > We could link to https://archive.org/details/B-001-002-835 instead, or
> > > to the archived HTML version. The newest capture of the HTML version
> > > seems to be this, although I didn't check that all pages are archived:
> > > https://web.archive.org/web/20181206025406/http://www.network-theory.co.uk/docs/gccintro/
> > > My preference would be to link to that latter. Although it's quite
> > > dated, the sections on basic compilation and compiler flags are still
> > > relevant for beginners.
> > >
> > > Gerald?
> >
> > I searched around a bit myself (since indeed the original and printed
> > versions seem to be gone) and landed at
> >
> >    https://archive.org/details/B-001-002-835
> >
> > as well. I probably would have gone for that, though the
> > web.archive.org/web link you found works equally if you want to point
> > there instead.
>
> Why not both?  I've pushed the attached patch to [wwwdocs].

Oops, I meant to link to the HTML pages, not the promotional page for
the printed version and PDF.

Fixed with the attached tweak, pushed to wwwdocs.

[-- Attachment #2: patch.txt --]
[-- Type: text/plain, Size: 822 bytes --]

commit a962fbb84d1a05af682f35f5b6dad7e3371db308
Author: Jonathan Wakely <jwakely@redhat.com>
Date:   Wed Sep 21 09:34:57 2022 +0100

    Adjust "An Introduction to GCC" link to the actual book
    
    I meant to link to the HTML pages, not the promotional page for the
    printed version and PDF.

diff --git a/htdocs/readings.html b/htdocs/readings.html
index 5d1b78e8..3abdd2c4 100644
--- a/htdocs/readings.html
+++ b/htdocs/readings.html
@@ -22,7 +22,7 @@
 
 <ul>
 
-  <li><a href="https://web.archive.org/web/20060106062936/http://www.network-theory.co.uk/gcc/intro/">An Introduction
+  <li><a href="https://web.archive.org/web/20060106062936/http://www.network-theory.co.uk/docs/gccintro/">An Introduction
   to GCC</a> by Brian J. Gough
   (<a href="https://archive.org/details/B-001-002-835/">e-book</a>).</li>