Skip site navigation (1) Skip section navigation (2)

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 (view raw or flat)
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

pgsql-docs by date

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

Privacy Policy | About PostgreSQL
Copyright © 1996-2014 The PostgreSQL Global Development Group