Minor FAQ correction suggestions

On Sunday 13 October 2002 05:44, Ian Barwick wrote:

Patch with suggested corrections attached

This time as context diff...

Regards

Ian Barwick
barwick@gmx.net

Very nice. I applied the entire patch; it was all good. I made a few
updates after applying your patch; patch attached.

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

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

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

On Monday 14 October 2002 05:15, Bruce Momjian wrote:

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

It's been saying "The current PostgreSQL version is 6.5" for over three
years...

I have completed a first draft, which was effectively a retranslation
of the current FAQ rather than an update of the translation. I still
have some tidying up to do, so I'll be submitting the patch nearer
the weekend.

A question: I presume the text-only version is generated from
the HTML original (I've taken care that the tags can be
stripped without damaging the format) - what tool do you use
to do this?

Regards

Ian Barwick
barwick@gmx.net

Ian Barwick wrote:

On Monday 14 October 2002 05:15, Bruce Momjian wrote:

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

It's been saying "The current PostgreSQL version is 6.5" for over three
years...

I have completed a first draft, which was effectively a retranslation
of the current FAQ rather than an update of the translation. I still
have some tidying up to do, so I'll be submitting the patch nearer
the weekend.

A question: I presume the text-only version is generated from
the HTML original (I've taken care that the tags can be
stripped without damaging the format) - what tool do you use
to do this?

Good question. I use lynx:

lynx -force_html -dump -hiddenlinks=ignore -nolist "$@"

Seems to work the best.

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