Re: [DOCS] Mention PL/Python newline handling?

2005-03-31 Thread Bruce Momjian 
Michael Fuhr wrote:
> Should the PL/Python documentation mention the way PL/Python handles
> newlines as a result of the following change?  Or will a comment
> in the Release Notes suffice?  (I'm assuming whoever's doing the
> 8.0.2 Release Notes will mention it).
> 
> http://archives.postgresql.org/pgsql-committers/2005-03/msg00342.php
> 
> I can submit a documentation patch before 8.0.2 wraps if necessary.
> Any preferences on where a change should go?  Maybe at the end of
> "38.1. PL/Python Functions"?
> 
> http://www.postgresql.org/docs/8.0/static/plpython.html

I will add it to the release notes.  I don't see this a something that
would affect developers.

-- 
  Bruce Momjian|  http://candle.pha.pa.us
  [email protected]   |  (610) 359-1001
  +  If your life is a hard drive, |  13 Roberts Road
  +  Christ can be your backup.|  Newtown Square, Pennsylvania 19073

---(end of broadcast)---
TIP 7: don't forget to increase your free space map settings

[DOCS] Two points about docs

2005-03-31 Thread Vladimir Chukharev 
Hi,
I think that docs can be improved a bit in two places.
1. Description of SELECT ( 
http://www.postgresql.org/docs/8.0/static/sql-select.html )
says 'SELECT retrieves rows from one or more tables.' This is not perfectly
correct, because 0 tables can be used like in 'SELECT 1;'. When I tried to find
how I can check the meaning of some simple function, at first attempt I really
thought that SELECT cannot be used without tables.
Chapter 7.1 also says that the simpleast query is 'SELECT * FROM table1;',
but at least the example 'SELECT 3 * 4;' is close enough to catch an eye.
2. 'Chapter 9. Functions and Operators' has no reference to server side
functions for large object manipulation (lo_creat et al.) Yesterday wanted
to check the names of those functions (I remembered there are some in psql).
So, first I found that blob is a keyword, but is not implemented. Then I tried
to find them in Chapter 9. I just couldn't beleave it's not there. Then I tried
to find a list of all functions, similar to list of all keywords. And only
after all that I found the location of the lo_* functions.
Well, may it is just me, of course. I don't know...
--
V.Chukharev
---(end of broadcast)---
TIP 8: explain analyze is your friend