Re: Fwd: Re: [DOCS] [HACKERS] Broken link in PG docs - Mailing list pgsql-patches

From Bruce Momjian
Subject Re: Fwd: Re: [DOCS] [HACKERS] Broken link in PG docs
Date
Msg-id 200702080435.l184ZmR08900@momjian.us
Whole thread Raw
In response to Fwd: Re: [DOCS] [HACKERS] Broken link in PG docs  (Robert Treat <xzilla@users.sourceforge.net>)
Responses Re: Fwd: Re: [DOCS] [HACKERS] Broken link in PG docs  (Robert Treat <xzilla@users.sourceforge.net>)
List pgsql-patches
Robert Treat wrote:
> Can someone apply Jim's patch at least to HEAD and REL8_2_STABLE?  We recently
> got a report of a broken link on the website due to this; seems it is still
> broken...

OK, we were aware that the URL was bad, but were trying to avoid
pointing to the cached version.  You will see that comment in the old
SGML.

What I did was to point to the Citeseer page, but not into the cached
PDF.  I think the text saying "cached version" will make it clear people
have to click to see the paper, and we aren't deep linking into
Citeseer, which I think could be a problem, and the cached URL is one of
the longest I have ever seen.

Backpatch to 8.2.X.

---------------------------------------------------------------------------


>
> ----------  Forwarded Message  ----------
>
> Subject: Re: [DOCS] [HACKERS] Broken link in PG docs
> Date: Monday 25 September 2006 15:39
> From: "Jim C. Nasby" <jim@nasby.net>
> To: Gurjeet Singh <singh.gurjeet@gmail.com>
> Cc: pgsql-docs@postgresql.org
>
> Moving to -docs
>
> On Mon, Sep 25, 2006 at 04:44:47PM +0530, Gurjeet Singh wrote:
> > At the end of the following page:
> >
> > http://www.postgresql.org/docs/8.0/static/indexes-partial.html
> >
> > there is a link [Generalized Partial
> > Indexes<http://simon.cs.cornell.edu/home/praveen/papers/partindex.de95.ps.Z
> >>] which is pointing to a missing link.
> >
> >    Can someone update the link with a live doc? Probably
> > this one
> > <http://citeseer.ist.psu.edu/rd/0%252C67014%252C1%252C0.25%252CDownload/htt
> >p://citeseer.ist.psu.edu/cache/papers/cs/1722/http:zSzzSzsimon.cs.cornell.ed
> >uzSzhomezSzpraveenzSzpaperszSzpartindex.de95.pdf/seshadri95generalized.pdf>
>
> Hrm... is there any means to update the docs for older versions outside
> of a new release?
>
> Even if the answer is 'no', it'd still be good to make the change in
> CVS. See attached (btw, this is in the docs back to at least 7.2).
> --
> Jim Nasby                                            jim@nasby.net
> EnterpriseDB      http://enterprisedb.com      512.569.9461 (cell)
>
> -------------------------------------------------------
>
> --
> Robert Treat
> Build A Brighter LAMP :: Linux Apache {middleware} PostgreSQL

[ Attachment, skipping... ]

>
> ---------------------------(end of broadcast)---------------------------
> TIP 1: if posting/reading through Usenet, please send an appropriate
>        subscribe-nomail command to majordomo@postgresql.org so that your
>        message can get through to the mailing list cleanly

--
  Bruce Momjian  <bruce@momjian.us>          http://momjian.us
  EnterpriseDB                               http://www.enterprisedb.com

  + If your life is a hard drive, Christ can be your backup. +
Index: doc/src/sgml/biblio.sgml
===================================================================
RCS file: /cvsroot/pgsql/doc/src/sgml/biblio.sgml,v
retrieving revision 1.26
diff -c -c -r1.26 biblio.sgml
*** doc/src/sgml/biblio.sgml    2 Oct 2006 22:28:48 -0000    1.26
--- doc/src/sgml/biblio.sgml    8 Feb 2007 04:30:15 -0000
***************
*** 326,337 ****

     <biblioentry id="SESHADRI95">
     <biblioset relation="article">
!     <title><ulink url="http://simon.cs.cornell.edu/home/praveen/papers/partindex.de95.ps.Z">
  <!--
!      above URL is invalid, cached copy at
!      http://citeseer.ist.psu.edu/seshadri95generalized.html
  -->
-     Generalized Partial Indexes
      </ulink>
      </title>
      <titleabbrev>Seshardri, 1995</titleabbrev>
--- 326,336 ----

     <biblioentry id="SESHADRI95">
     <biblioset relation="article">
!     <title>Generalized Partial Indexes
!     <ulink url="http://citeseer.ist.psu.edu/seshadri95generalized.html">(cached version)
  <!--
!      Original URL:  http://citeseer.ist.psu.edu/seshadri95generalized.html
  -->
      </ulink>
      </title>
      <titleabbrev>Seshardri, 1995</titleabbrev>

pgsql-patches by date:

Previous
From: Robert Treat
Date:
Subject: Fwd: Re: [DOCS] [HACKERS] Broken link in PG docs
Next
From: Chris Marcellino
Date:
Subject: Re: Configure template change to use SysV Semaphors on darwin