[DOCS] Default Values Section

2005-01-04 Thread Lourival Oliveira
I have a problem reading the "5.3 Default Values" Section of 
Postgresql8.0.0-rc1 documentation. In this section there are nothing about 
using 'now' constant. I think which there are a conflict with a note about 
'now' in section "9.9. Date/Time Functions and Operators" which show the way 
to achieve the desired behavior. See:

5.3. Default Values
...
The default value may be a scalar expression, which will be evaluated 
whenever the default value is inserted (not when the table is created).

9.9. Date/Time Functions and Operators
...
SELECT CURRENT_TIMESTAMP;
SELECT now();
SELECT TIMESTAMP 'now';
Note: You do not want to use the third form when specifying a DEFAULT clause 
while creating a table. The system will convert now to a timestamp as soon 
as the constant is parsed, so that when the default value is needed, the 
time of the table creation would be used! The first two forms will not be 
evaluated until the default value is used, because they are function calls. 
Thus they will give the desired behavior of defaulting to the time of row 
insertion.

I think which a simple reference to any unpredictable behavior must be 
placed here to avoid confusion when anybody don't reach the desired behavior 
when use default values.

What think you about my suggestion?
Wait replies, Tanks.
Lourival Oliveira da Silva
PS: Sorry by my poor English. 


---(end of broadcast)---
TIP 3: if posting/reading through Usenet, please send an appropriate
 subscribe-nomail command to [EMAIL PROTECTED] so that your
 message can get through to the mailing list cleanly


[DOCS] man pages fixed

2005-01-04 Thread Peter Eisentraut
The man page problem has been fixed.  I have uploaded a 
release-candidate man.tar.gz to 
developer.postgresql.org /var/spool/ftp/pub/dev/doc as usual.  Please 
use that for the next release tarball.  Of course, everyone is also 
invited to inspect the man pages for problems.

How to create the man pages:  I have downloaded 
http://mesh.dl.sourceforge.net/sourceforge/docbook2x/docbook2man-sgmlspl-1.0.tar.gz,
 
unpacked it, set D2MDIR = /home/peter/docbook2man-sgmlspl-1.0/perl in 
Makefile.custom, and ran make man.tar.gz in doc/src.

-- 
Peter Eisentraut
http://developer.postgresql.org/~petere/

---(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