Thread: Documentation problems

  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

I think  we should put the tag:

<example id="simple-select">
     <title>A Simple Select</title>

in arch-dev.sgml around line 277 just above the <programlisting>
and move the </para> tag to under </example>.
I'v try it, and it look much better after compiled to html files.

regards

Laser

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

There are several magical people. But no uber-magician who can fix
everything at once ;)

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

I've found this one, and will fix it for the next release. Thanks.

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

I'm not certain where the ODBC FAQ is. Where are you finding it?

                     - Thomas

> I think  we should put the tag:
> <example id="simple-select">
>      <title>A Simple Select</title>
> in arch-dev.sgml around line 277 just above the <programlisting>
> and move the </para> tag to under </example>.
> I'v try it, and it look much better after compiled to html files.

Got it, and it will be fixed in the next release. Thanks.

                - Thomas

On Wed, 6 Sep 2000, Thomas Lockhart wrote:

> >   There seem to be a lot of problems with the documentation.  Should I
> > just post them here and some magical person will fix them?
>
> There are several magical people. But no uber-magician who can fix
> everything at once ;)
>
> >   For instance, the "CREATE TRIGGER" manpage contains the sentence:
> ...
>
> I've found this one, and will fix it for the next release. Thanks.
>
> >   The PostgreSQL ODBC FAQ contains several problems in the following
> > sections:
> ...
>
> I'm not certain where the ODBC FAQ is. Where are you finding it?

  ftp://ftp.postgresql.org/pub/odbc/index.html is the base of the ODBC
documentation.  ftp://ftp.postgresql.org/pub/odbc/psqlodbc_faq.html is the
actual FAQ.

>                      - Thomas

Tom

Hi,  there

    Around  line 656 of datetime.sgml, I bet there the "128 days" should
be "128 years",
    or Julian calendar would be too horrable. ;-)

regards

Laser

> Around  line 656 of datetime.sgml, I bet there the "128 days" should
> be "128 years", or Julian calendar would be too horrable. ;-)

You must be right! I've fixed it and will commit soon. Thanks.

                     - Thomas