Re: Documentation for jdbc escapes - Mailing list pgsql-jdbc

From Xavier Poinsard
Subject Re: Documentation for jdbc escapes
Date
Msg-id 41F61677.3050404@free.fr
Whole thread Raw
In response to Re: Documentation for jdbc escapes  (Kris Jurka <books@ejurka.com>)
Responses Re: Documentation for jdbc escapes
List pgsql-jdbc
I updated the my documentation attempt with your remarks and added
mention for escape char escape.

Kris Jurka wrote:
> If you are soliciting general comments it would help to make it available
> in a more accessible format:

http://poinsarx.free.fr/pgsql/

>
> http://www.ejurka.com/pgsql/docs/escfunc/
>
> For general feedback it seems a little too table oriented with not enough
> accompanying text.  Describing what the argument reordering and duplicate
> problem actually is would be helpful.  Also an example including Java code
> would help the understanding process of how to actually call these
> functions.  Mentioning Connection.nativeSQL() seems appropriate.

done.

>
> In terms of specific feedback:
>  - it should mention outer join escapes
done.
>  - the translation of dayname is in the wrong column (Table 1.3)
done.
>  - The comments should be full sentences, starting with a capital letter
>    ending with a period.
done.
>  - Section titles should get some captialization.
done.
>  - Provide html link to referenced JDBC Technology guide
done.
>  - A number of typos/grammatical errors:
>    - First paragraph
>      - of of
>      - had to specify way -> had to speciy a way
>    - Second section (escaped scalar functions)
>      - tables are showing -> tables show
>      - The driver support -> The driver supports
>      - specification describe the -> specification describes the
Corrected.

Attachment

pgsql-jdbc by date:

Previous
From: "Xavier Poinsard"
Date:
Subject: Patch for escaped escape char
Next
From: "Jean-Pierre Pelletier"
Date:
Subject: Re: setObject on PGInterval throws "Unknown Type null"