Thread: Fwd: Re: [DOCS] [HACKERS] Broken link in PG docs

Fwd: Re: [DOCS] [HACKERS] Broken link in PG docs

From
Robert Treat
Date:
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...

----------  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

Re: Fwd: Re: [DOCS] [HACKERS] Broken link in PG docs

From
Bruce Momjian
Date:
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>

Re: Fwd: Re: [DOCS] [HACKERS] Broken link in PG docs

From
Robert Treat
Date:
On Wednesday 07 February 2007 23:35, Bruce Momjian wrote:
> 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.
>

As an alternative, if we could get a copy of the paper and permission from the
authors, we could host it on postgresql.org.

--
Robert Treat
Build A Brighter LAMP :: Linux Apache {middleware} PostgreSQL

Re: Fwd: Re: [DOCS] [HACKERS] Broken link in PG docs

From
Bruce Momjian
Date:
Robert Treat wrote:
> On Wednesday 07 February 2007 23:35, Bruce Momjian wrote:
> > 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.
> >
>
> As an alternative, if we could get a copy of the paper and permission from the
> authors, we could host it on postgresql.org.

I think someone tried that, but I am not certain.

--
  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. +