Bug #13198 for Postgres-Handler: clearer docs: compare with DBD::Pg

Fri Jun 10 17:58:54 2005 Guest - Ticket created

Subject:

clearer docs: compare with DBD::Pg

The module description says: "Accessors for PostgreSQL data. Simplifies data access through a series of standard class methods." That could just as well describe DBD::Pg. Describing how your module is different, perhaps in a SEE ALSO section, would be useful. Also, the word "standard" here seems out of place, Since several of your methods have fairly unique seeming names, like "PrepLEX". Also, much of the documentation is rendered as pre-formatted text blocks because it is intended. Having text paragraphs flush left would standarize that. It does look like this does something a bit different than DBD::Pg and am interested to read more about what those differences are.

Fri Jun 10 17:59:29 2005 Guest - Correspondence added

From:

mark [...] summersault.com

I meant to file this as a "wishlist" item.

Fri Jun 10 19:38:41 2005 info [...] cybersprocket.com - Taken

Fri Jun 10 19:45:46 2005 info [...] cybersprocket.com - Correspondence added

Thanks for the feedback. We'll do some doc updates before the next release. SW Geek != Doc Guru For the record, Postgres::Handler is a superset of DBD::Pg as it is built using the core functions available in DBD::Pg. Postgres::Handler supplies functions that combine frequent DBD::Pg steps into a single method call. The module also creates the framework necessary to manage multiple connections to multiple databases via a more user friendly syntax. More examples in the next release may be warranted to show the flexibility and power of Postgres::Handler. [guest - Fri Jun 10 17:58:54 2005]: Show quoted text

> The module description says: > > "Accessors for PostgreSQL data. Simplifies data access through a > series of standard class methods." >

Fri Jun 10 19:49:34 2005 info [...] cybersprocket.com - Status changed from 'new' to 'open'

Fri Jun 10 19:51:12 2005 info [...] cybersprocket.com - Severity Wishlist added