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 70745533F0 for ; Sun, 27 Mar 2005 22:21:01 +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 16134-07 for ; Sun, 27 Mar 2005 21:20:50 +0000 (GMT) Received: from flake.decibel.org (natpool.bovine.net [67.100.216.14]) by svr1.postgresql.org (Postfix) with ESMTP id 050F5533F8 for ; Sun, 27 Mar 2005 22:20:49 +0100 (BST) Received: by flake.decibel.org (Postfix, from userid 1001) id 9B36F153AE; Sun, 27 Mar 2005 15:20:50 -0600 (CST) Date: Sun, 27 Mar 2005 15:20:50 -0600 From: "Jim C. Nasby" To: pgsql-docs@postgresql.org Subject: Version information in docs Message-ID: <20050327212050.GP51784@decibel.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline X-Operating-System: FreeBSD 4.11-RELEASE i386 X-Distributed: Join the Effort! http://www.distributed.net User-Agent: Mutt/1.5.6i X-Virus-Scanned: by amavisd-new at hub.org X-Spam-Status: No, hits=0.047 tagged_above=0 required=5 tests=AWL, FORGED_RCVD_HELO X-Spam-Level: X-Archive-Number: 200503/21 X-Sequence-Number: 2917 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. -- Jim C. Nasby, Database Consultant decibel@decibel.org Give your computer some brain candy! www.distributed.net Team #1828 Windows: "Where do you want to go today?" Linux: "Where do you want to go tomorrow?" FreeBSD: "Are you guys coming, or what?"