Re: Documentation: references to old versions - Mailing list pgsql-hackers

From Magnus Hagander
Subject Re: Documentation: references to old versions
Date
Msg-id CABUevEzqQCXo-qo0Ox=j7CuMPi4bzYGQUn1+s56b94yV+e+LiA@mail.gmail.com
Whole thread Raw
In response to Re: Documentation: references to old versions  (Dave Page <dpage@pgadmin.org>)
Responses Re: Documentation: references to old versions  (Tom Lane <tgl@sss.pgh.pa.us>)
List pgsql-hackers
On Tue, Feb 12, 2013 at 10:19 AM, Dave Page <dpage@pgadmin.org> wrote:
>
> Hi
>
> On Tue, Feb 12, 2013 at 9:14 AM, Pavan Deolasee <pavan.deolasee@gmail.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.

In theory we could remove that reference completely since any versions
where it does not apply are out of support since years ago at this
point. But I don't see a point in doing that just for the sake of
removing - but if a section is reworded in general that contains such
references, it could be dropped.

-- Magnus HaganderMe: http://www.hagander.net/Work: http://www.redpill-linpro.com/



pgsql-hackers by date:

Previous
From: Albe Laurenz
Date:
Subject: Re: Documentation: references to old versions
Next
From: Pavel Stehule
Date:
Subject: Re: another idea for changing global configuration settings from SQL