X-Original-To: pgsql-docs-postgresql.org@localhost.postgresql.org Received: from localhost (unknown [200.46.204.144]) by svr1.postgresql.org (Postfix) with ESMTP id 29EE6538EA for ; Mon, 28 Mar 2005 02:54:23 +0100 (BST) Received: from svr1.postgresql.org ([200.46.204.71]) by localhost (av.hub.org [200.46.204.144]) (amavisd-new, port 10024) with ESMTP id 77832-04 for ; Mon, 28 Mar 2005 01:54:20 +0000 (GMT) Received: from sss.pgh.pa.us (sss.pgh.pa.us [66.207.139.130]) by svr1.postgresql.org (Postfix) with ESMTP id CEAB4535DD for ; Mon, 28 Mar 2005 02:54:19 +0100 (BST) Received: from sss2.sss.pgh.pa.us (tgl@localhost [127.0.0.1]) by sss.pgh.pa.us (8.13.1/8.13.1) with ESMTP id j2S1sMwE004302; Sun, 27 Mar 2005 20:54:22 -0500 (EST) To: "Jim C. Nasby" Cc: pgsql-docs@postgresql.org Subject: Re: Version information in docs In-reply-to: <20050327212050.GP51784@decibel.org> References: <20050327212050.GP51784@decibel.org> Comments: In-reply-to "Jim C. Nasby" message dated "Sun, 27 Mar 2005 15:20:50 -0600" Date: Sun, 27 Mar 2005 20:54:22 -0500 Message-ID: <4301.1111974862@sss.pgh.pa.us> From: Tom Lane X-Virus-Scanned: by amavisd-new at hub.org X-Spam-Status: No, hits=0.006 tagged_above=0 required=5 tests=AWL X-Spam-Level: X-Archive-Number: 200503/24 X-Sequence-Number: 2920 "Jim C. Nasby" 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