public inbox for [email protected]  
help / color / mirror / Atom feed
From: Tom Lane <[email protected]>
To: Jim C. Nasby <[email protected]>
Cc: [email protected]
Subject: Re: Version information in docs
Date: Sun, 27 Mar 2005 20:54:22 -0500
Message-ID: <[email protected]> (raw)
In-Reply-To: <[email protected]>
References: <[email protected]>

"Jim C. Nasby" <[email protected]> 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



view thread (7+ messages)  latest in thread

reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: [email protected]
  Cc: [email protected], [email protected]
  Subject: Re: Version information in docs
  In-Reply-To: <[email protected]>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox