X-Original-To: pgsql-docs-postgresql.org@localhost.postgresql.org Received: from localhost (unknown [64.117.224.130]) by svr1.postgresql.org (Postfix) with ESMTP id E4EDCD1B8B1 for ; Tue, 26 Aug 2003 10:19:27 -0300 (ADT) Received: from svr1.postgresql.org ([64.117.224.193]) by localhost (neptune.hub.org [64.117.224.130]) (amavisd-new, port 10024) with ESMTP id 06630-07 for ; Tue, 26 Aug 2003 10:18:50 -0300 (ADT) Received: from bast.unixathome.org (bast.unixathome.org [66.11.174.150]) by svr1.postgresql.org (Postfix) with ESMTP id 0357DD1B897 for ; Tue, 26 Aug 2003 10:18:46 -0300 (ADT) Received: from wocker (wocker.unixathome.org [192.168.0.99]) by bast.unixathome.org (Postfix) with ESMTP id D6B113D29; Tue, 26 Aug 2003 09:18:48 -0400 (EDT) From: "Dan Langille" To: Tom Lane Date: Tue, 26 Aug 2003 09:19:36 -0400 MIME-Version: 1.0 Subject: Re: Do we need "Diagnostics" sections of SQL command reference pages? Cc: pgsql-docs@postgresql.org Message-ID: <3F4B2628.2121.19C09262@localhost> References: <3F4B19B2.28737.198FE5CF@localhost> In-reply-to: <8038.1061903681@sss.pgh.pa.us> X-mailer: Pegasus Mail for Windows (v4.02a) Content-type: text/plain; charset=US-ASCII Content-transfer-encoding: 7BIT Content-description: Mail message body X-Virus-Scanned: by amavisd-new at postgresql.org X-Archive-Number: 200308/74 X-Sequence-Number: 1934 On 26 Aug 2003 at 9:14, Tom Lane wrote: > "Dan Langille" writes: > > On 25 Aug 2003 at 17:37, Tom Lane wrote: > >> I'm starting to look at updating the docs to match 7.4 error message > >> spellings. I find that a large part of the work I'll have to do is in > >> updating the "Diagnostics" (formerly "Outputs") section of the command > >> reference pages. > > > Do you have a URL for that. > > Any of the SQL command reference pages, eg > http://developer.postgresql.org/docs/postgres/sql-createdatabase.html Thanks. I was looking for a single section. The value I see in those message is it gives the reader more information about what can go wrong. The above example shows that you cannot use "create database" within a transaction. Also, the information under "ERROR: Could not initialize database directory." is pretty good. -- Dan Langille : http://www.langille.org/