bool type could be better documented - Mailing list pgsql-bugs

From pgsql-bugs@postgresql.org
Subject bool type could be better documented
Date
Msg-id 200102132120.f1DLKRi06365@hub.org
Whole thread Raw
Responses Re: bool type could be better documented  (Peter Eisentraut <peter_e@gmx.net>)
List pgsql-bugs
Dave E Martin (xxiii@cyberdude.com) reports a bug with a severity of 4
The lower the number the more severe it is.

Short Description
bool type could be better documented

Long Description
The documentation in both 7.1 and 7.0.3 talks about the bool type but both fail to actually mention the name(s) of the
typein the section on booleans. 

presumably its called 'boolean' based on the description, but it could be clearer. one has to refer to table 3-1 to
makesure. (for instance, the description of 'money' makes it clear via the table, that the type is called 'money').
perhapsif the first sentence were changed from 
"Postgres supports the SQL99 boolean type" to "Postgres supports the SQL99 <BOLD>boolean</BOLD> type" (or quotes or
something;whenever its being used as a name, and not to represent "concept of true/false state"). Its a bit like
talkingabout a car which is named car... its obvious to the writer, but to the reader they just assume "concept of
automobile"whenever they hear car, and never realize that its actually named "car". 


Sample Code
http://www.postgresql.org/devel-corner/docs/user/datatype-boolean.htm

No file was uploaded with this report

pgsql-bugs by date:

Previous
From: pgsql-bugs@postgresql.org
Date:
Subject: PgSQL 7.1 beta 3 breaks ODBC
Next
From: pgsql-bugs@postgresql.org
Date:
Subject: alter table rename and ruminations on referential integrity