From: Bruce Momjian <pgman@candle.pha.pa.us>
Message-Id: <200210140315.g9E3FWV26157@candle.pha.pa.us>
Subject: Re: Minor FAQ correction suggestions
In-Reply-To: <200210130544.34553.barwick@gmx.net>
To: Ian Barwick <barwick@gmx.net>
Date: Sun, 13 Oct 2002 23:15:32 -0400 (EDT)
Cc: pgsql-docs@postgresql.org
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-Type: text/plain; charset=US-ASCII


Thanks for working on this.  It really needed that freshening up.

---------------------------------------------------------------------------

Ian Barwick wrote:
> 
> I'm reworking the German version of the FAQ (which is
> hopelessly outdated), in the course of which I've come across
> a few errors in the original (English) version,
> mainly minor things like spelling mistakes and broken links.
> Patch with suggested corrections attached (German version will 
> follow ASAP).
> 
> General alterations:
> 
> Some links corrected; links to the domain "postgresql.org" now uniformly 
> written as "PostgreSQL.org". Minor tidying up of formatting.
> 
> Some specific notes / questions on the following sections:
> 
> 1.4) What non-Unix ports are available?
> 
> -> win31.mak should be win32.mak
> 
> Added:
>   "A native port to some Microsoft platforms is currently being worked
>    upon."
> -> IIRC this is the case. Please correct if not.
> 
> 1.8) What documentation is available?
> The link http://www.PostgreSQL.org/books/ is broken,
> http://www.ca.PostgreSQL.org/books/ works. (It would be more
> logical to fix the link rather than the FAQ I think, though).
> 
> 3.9) What are the pg_sorttempNNN.NN files in my database directory?
> 
> -> presume this should read "What are the pg_tempNNN.NN files..." ??
> 
>  4.4) How do you remove a column from a table?
> -> ALTER TABLE DROP COLUMN supported as of 7.3 :-) 
> 
> 4.15.2) How do I get the value of a SERIAL insert?
> 
> -> Perl is a very versatile language, but this:
> 
>     new_id = output of "SELECT nextval('person_id_seq')"
>     INSERT INTO person (id, name) VALUES (new_id, 'Blaise Pascal');
> 
> is most definitely not Perl ;-). I have made up a pseudo-language for the
> example.
> 
> 4.16) What is an OID? What is a TID?
> ->  backend/access/transam.h should be include/access/transam.h 
> 
> 4.17) What is the meaning of some of the terms used in PostgreSQL?
> 
> -> The link http://www.comptechnews.com/~reaster/dbdesign.html is broken
> (the domain doesn't seem to exist). Suggest:
> http://hea-www.harvard.edu/MST/simul/software/docs/pkgs/pgsql/glossary/glossary.html
> as replacement.
> 
> 4.25) How do I return multiple rows or columns from a function?
> 
> -> Linked to current rather than developer documentation
> 
> 
> Regards
> 
> Ian Barwick
> barwick@gmx.net

[ Attachment, skipping... ]

> 
> ---------------------------(end of broadcast)---------------------------
> TIP 5: Have you checked our extensive FAQ?
> 
> http://www.postgresql.org/users-lounge/docs/faq.html

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