Documentation: references to old versions

From: Pavan Deolasee <pavan(dot)deolasee(at)gmail(dot)com>
To: pgsql-hackers <pgsql-hackers(at)postgresql(dot)org>
Subject: Documentation: references to old versions
Date: 2013-02-12 09:14:34
Message-ID: CABOikdM7Q+WFFGoJYsUYcUCQ1+EHAXvFi47=v=+8Y+=Hh=NjZg@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

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.

Thanks,
Pavan

--
Pavan Deolasee
http://www.linkedin.com/in/pavandeolasee

Responses

Browse pgsql-hackers by date

  From Date Subject
Next Message Dave Page 2013-02-12 09:19:46 Re: Documentation: references to old versions
Previous Message Amit Kapila 2013-02-12 09:03:43 Re: Identity projection