I wrote:
> It looks like we changed the code to match what Oracle does on
> 7/27/2003, but forgot to fix the documentation. Will fix, thanks
> for the report.
Actually, someone already fixed the documentation in CVS tip: see
http://developer.postgresql.org/docs/postgres/functions-string.html
regards, tom lane