Documentation problems - Mailing list pgsql-docs

From Tom Samplonius
Subject Documentation problems
Date
Msg-id Pine.BSF.4.05.10009051620090.21682-100000@misery.sdf.com
Whole thread Raw
List 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


pgsql-docs by date:

Previous
From: Bruce Momjian
Date:
Subject: Nice elephant gif
Next
From: "He Weiping (Laser Henry)"
Date:
Subject: some sgml tag in arch-dev.sgml