Re: Version information in docs - Mailing list pgsql-docs

From Tom Lane
Subject Re: Version information in docs
Date
Msg-id 4301.1111974862@sss.pgh.pa.us
Whole thread Raw
In response to Version information in docs  ("Jim C. Nasby" <decibel@decibel.org>)
Responses Re: Version information in docs  ("Jim C. Nasby" <decibel@decibel.org>)
Re: Version information in docs  (Thomas F.O'Connell <tfo@sitening.com>)
List pgsql-docs
"Jim C. Nasby" <decibel@decibel.org> writes:
> ISTM it would be very useful if the docs specified what version a
> feature that would break in older versions was implemented in. The
> example that comes to mind is argument names in CREATE FUNCTION, which
> was added in 8.0. The 8.0 docs (http://lnk.nu/postgresql.org/1y3.html)
> mention the ability to name arguments, but it doesn't mention that the
> feature was added in 8.0 and can not be used in prior versions. Anyone
> who's trying to write code that will run on multiple versions of
> PostgreSQL would want to know this.

The release notes cover that; or you can compare the docs for the oldest
and newest versions you want to work with.  I think it would be more
confusing than helpful for the reference pages to try to cover all the
changes from version to version.

            regards, tom lane

pgsql-docs by date:

Previous
From: Josh Berkus
Date:
Subject: Re: Missing doc on expression format for ALTER TABLE
Next
From: Alvaro Herrera
Date:
Subject: Re: Missing doc on expression format for ALTER TABLE