Documentation problems

From: Tom Samplonius <tom(at)sdf(dot)com>
To: pgsql-docs(at)postgresql(dot)org
Subject: Documentation problems
Date: 2000-09-05 23:54:22
Message-ID: Pine.BSF.4.05.10009051620090.21682-100000@misery.sdf.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs


There seem to be a lot of problems with the documentation. Should I
just post them here and some magical person will fix them?

For instance, the "CREATE TRIGGER" manpage contains the sentence:

The trigger will be associated with the relation
relname and will execute the specified function funcname.

however, that does not match the declared syntax. "relation relname"
should be "table <i>table</i>".

The PostgreSQL ODBC FAQ contains several problems in the following
sections:

General #3: The URL is wrong. It should be
ftp://ftp.postgresql.org/pub/odbc/index.html instead.

Advanced #1: The answer contains the sentence, "The hassle is that every
time you run the query in Access 97 it prompts you with a database
connection dialog." This is wrong. Posters to the FAQ should read the
FAQ, as "Microsoft Products #4" has an easy solution (this problem affects
all SQL-pass through queries regardles of the RDMS used).

Advanced #2: The answer is missing something. "Recoginze Unique Indexes"
must also be switched on in the Advanced Driver Options for primary keys
to be detected automatically.

Advanced #5: The answer contains the sentence, "This will probably not be
necessary in Postgres 6.4 since it will be added." Apparently it has not
been added, as I just experienced it in 7.0.2.

Tom

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message He Weiping (Laser Henry) 2000-09-06 03:31:26 some sgml tag in arch-dev.sgml
Previous Message He Weiping (Laser Henry) 2000-09-05 05:36:21 some error in jdbc.sgml