Re: Documentation: references to old versions

From: Dave Page <dpage(at)pgadmin(dot)org>
To: Pavan Deolasee <pavan(dot)deolasee(at)gmail(dot)com>
Cc: pgsql-hackers <pgsql-hackers(at)postgresql(dot)org>
Subject: Re: Documentation: references to old versions
Date: 2013-02-12 09:19:46
Message-ID: CA+OCxoxvOVuUKUNiL-nb67KhYs736gPcjRkKouhQqR-=a5O8HA@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

Hi

On Tue, Feb 12, 2013 at 9:14 AM, Pavan Deolasee <pavan(dot)deolasee(at)gmail(dot)com>wrote:

> While reading some documentation, I noticed that we have references to
> past releases. For example,
> http://www.postgresql.org/docs/9.2/static/xfunc-c.html mentions "A
> magic block is required as of PostgreSQL 8.2". Sure, this is true even
> as of 9.2 or even 9.3. There are a few more such references that I
> could spot with a simple grep in the doc/src/sgml directory. I wonder
> if this is worth fixing. I don't know sgml enough, but if it supports
> some sort of a meta-tag, then it might help to replace specific
> version references with something like <CURRENT_MAJOR_RELEASE> so that
> the current major version gets substituted when docs for that release
> are built.
>

The phrasing "as of 8.2" basically means "from 8.2 onwards". Changing the
version there would make the text incorrect.

--
Dave Page
Blog: http://pgsnake.blogspot.com
Twitter: @pgsnake

EnterpriseDB UK: http://www.enterprisedb.com
The Enterprise PostgreSQL Company

In response to

Responses

Browse pgsql-hackers by date

  From Date Subject
Next Message Jeevan Chalke 2013-02-12 09:20:21 Re: unlogged tables vs. GIST
Previous Message Pavan Deolasee 2013-02-12 09:14:34 Documentation: references to old versions