Package: cl-pg
Version: 20050717-1
These two functions have identical documentation. If they implement
identical functionality, then one should be deleted; if they implement
different functionality, the documentation should explain the difference:
(defgeneric pg-close-statement (connection statement-name)
(:documentation
"Closes a prepared statement"))
(defgeneric pg-close-portal (connection portal)
(:documentation
"Closes a prepared statement"))
So yes, I know that one closes a statement, while the other closes a
portal. But I don't know what a portal is, I don't know what "close"
means ("delete"? "forget about"? "prevent updates of"? "wrap inside a
closure"?) and pg-close-statement isn't doing what I expect it to do (I
get errors saying that the statement already exists when I try to
re-create it afterwards). I don't have enough information to verify
that the functions are doing what they're supposed to do. They should
certainly include references to whichever function "opens" the things
that they are closing.
Also, the start of the file recommends seeing the README:
;; See the README for API documentation.
...but no README is included. I've chased up the README from CVS, and
in fact it provides no help here. But it should probably be included
anyway, with a disclaimer saying that it's out of date.
Even better, it would be nice if there was some actual real
documentation provided, including examples of how each of the functions
is supposed to be used. Right now, I'm just having to guess how to use
prepared statements, and after a couple of days of bashing my head
against the problem I still can't get it to work.
--
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]
