pg.ddx.io  pgsql-docs@postgresql.org mailing list archive  

help / color / mirror / Atom feed

From: Álvaro Herrera <alvherre@kurilemu.de>
To: jlmuir@imca-cat.org
To: pgsql-docs@lists.postgresql.org
Subject: Re: Broken NewbieDoc Docbook Guide link
Date: Thu, 14 Aug 2025 14:24:45 +0200
Message-ID: <202508141224.gg6xzxdxqos4@alvherre.pgsql> (raw)
In-Reply-To: <175512227190.479713.6949100721328997095@wrigleys.postgresql.org>

On 2025-Aug-13, PG Doc comments form wrote:

> At
> 
>   https://www.postgresql.org/docs/17/docguide-docbook.html
> 
> the NewbieDoc Docbook Guide link is to
> 
>   http://newbiedoc.sourceforge.net/metadoc/docbook-guide.html
> 
> which results in an HTTP 404.
> 
> I guess the project page is
> 
>   https://sourceforge.net/projects/newbiedoc/
> 
> but it doesn't actually display the guide, so I guess one would have to
> download and build it in order to read it?  Also, the project was last
> updated over ten years ago (2013-04-15).  Maybe the reference to this guide
> should just be removed?

Yeah, it was removed some time ago actually, per this discussion:
https://www.postgresql.org/message-id/flat/aFpXSCPpQkoFk_mb%40paquier.xyz
The updated docs coincidentally become visible later today, with the
release of 17.6 and friends.  It's already visible in the development
docs for pg19: https://www.postgresql.org/docs/devel/docguide-docbook.html

-- 
Álvaro Herrera        Breisgau, Deutschland  —  https://www.EnterpriseDB.com/
"Doing what he did amounts to sticking his fingers under the hood of the
implementation; if he gets his fingers burnt, it's his problem."  (Tom Lane)

view thread (2+ messages)

Message-ID: <202508141224.gg6xzxdxqos4@alvherre.pgsql>
Permalink:  ../202508141224.gg6xzxdxqos4@alvherre.pgsql/
Also on:    postgresql.org/message-id/202508141224.gg6xzxdxqos4@alvherre.pgsql

copy link · copy postgr.es

reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: pgsql-docs@postgresql.org
  Cc: alvherre@kurilemu.de, jlmuir@imca-cat.org, pgsql-docs@lists.postgresql.org
  Subject: Re: Broken NewbieDoc Docbook Guide link
  In-Reply-To: <202508141224.gg6xzxdxqos4@alvherre.pgsql>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox