Re: Lack of docs for libpq C Library - Mailing list pgsql-docs

From Tom Lane
Subject Re: Lack of docs for libpq C Library
Date
Msg-id 8892.1201796537@sss.pgh.pa.us
Whole thread Raw
In response to Re: Lack of docs for libpq C Library  (Alvaro Herrera <alvherre@commandprompt.com>)
Responses Re: Lack of docs for libpq C Library
Re: Lack of docs for libpq C Library
List pgsql-docs
Alvaro Herrera <alvherre@commandprompt.com> writes:
> I disagree.  I think PQinitSSL is meant to be called from the
> application, for example.  Same with PQsetClientEncoding.  And the
> PQExpBuffer stuff is all very useful, and years ago when I wrote an app
> to use it it annoyed me that there were no docs on it.  (Back then, I
> didn't realize I could have complained about it or written the docs
> myself).

PQinitSSL *is* documented, though looking at the para immediately raises
the question what the heck we are doing pointing to a random hp.com page
for SSL documentation.

PQsetClientEncoding seems to be documented in the wrong place.

As for the expbuffer stuff, that is intentionally not considered part of
libpq's exported API.  If someone uses it, they get to keep both parts
when it breaks.

            regards, tom lane

pgsql-docs by date:

Previous
From: Bruce Momjian
Date:
Subject: Re: Lack of docs for libpq C Library
Next
From: Bruce Momjian
Date:
Subject: Re: Lack of docs for libpq C Library