Re: Do we need "Diagnostics" sections of SQL command reference pages? - Mailing list pgsql-docs

From Chris M
Subject Re: Do we need "Diagnostics" sections of SQL command reference pages?
Date
Msg-id bii98c$1pd2$1@news.hub.org
Whole thread Raw
In response to Re: Do we need "Diagnostics" sections of SQL command reference pages?  (Tom Lane <tgl@sss.pgh.pa.us>)
List pgsql-docs
"Tom Lane" <tgl@sss.pgh.pa.us> Write news:9357.1061905024@sss.pgh.pa.us...
> "Dan Langille" <dan@langille.org> writes:
> > On 26 Aug 2003 at 9:14, Tom Lane wrote:
> >> http://developer.postgresql.org/docs/postgres/sql-createdatabase.html
>
> > 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.
>
> Sure, but that should have been stated in the command description.
>
> > Also, the information under "ERROR: Could not initialize database
> > directory." is pretty good.
>
> I chose this example deliberately, because it's one of very few pages
> where there's actually nontrivial content in the Diagnostics section.
> "could not initialize database directory" seems to me the only one
> of these messages that requires more info (the "could not create
> database directory" message now includes the kernel error code, so
> it's sufficiently improved IMHO).  What I'm inclined to do about it
> is add a DETAIL field showing the exact "cp" command that failed, and
> perhaps a HINT suggesting that people look in the postmaster's stderr
> log to see cp's complaint.  Not sure how to translate that to Windows,

    Windows port may use "copy", "xcopy" to copy files.  In Windows, "copy"
is not so powerful as "xcopy". But I don't think using OS specific shell
commands
a good idea. If environment variable PATH is not set correctly, using these
commands
may cause a fail.

> but under Unix it should be sufficient no?
>
> regards, tom lane
>
> ---------------------------(end of broadcast)---------------------------
> TIP 9: the planner will ignore your desire to choose an index scan if your
>       joining column's datatypes do not match
>



pgsql-docs by date:

Previous
From: Tom Lane
Date:
Subject: Re: Automatic documentation spell check
Next
From: "Chris M"
Date:
Subject: Re: Changing the sequence owner