Re: Version information in docs

From: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
To: "Jim C(dot) Nasby" <decibel(at)decibel(dot)org>
Cc: pgsql-docs(at)postgresql(dot)org
Subject: Re: Version information in docs
Date: 2005-03-28 01:54:22
Message-ID: 4301.1111974862@sss.pgh.pa.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

"Jim C. Nasby" <decibel(at)decibel(dot)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

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Alvaro Herrera 2005-03-28 02:00:50 Re: Missing doc on expression format for ALTER TABLE
Previous Message Josh Berkus 2005-03-28 01:11:43 Re: Missing doc on expression format for ALTER TABLE