pgsql: Fix documentation for libpq's PQfn().

Lists: pgsql-committers
From: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
To: pgsql-committers(at)postgresql(dot)org
Subject: pgsql: Fix documentation for libpq's PQfn().
Date: 2015-03-08 17:36:10
Message-ID: E1YUf7a-0007cf-9F@gemulon.postgresql.org
Views: Raw Message | Whole Thread | Download mbox | Resend email
Lists: pgsql-committers

Fix documentation for libpq's PQfn().

The SGML docs claimed that 1-byte integers could be sent or received with
the "isint" options, but no such behavior has ever been implemented in
pqGetInt() or pqPutInt(). The in-code documentation header for PQfn() was
even less in tune with reality, and the code itself used parameter names
matching neither the SGML docs nor its libpq-fe.h declaration. Do a bit
of additional wordsmithing on the SGML docs while at it.

Since the business about 1-byte integers is a clear documentation bug,
back-patch to all supported branches.

Branch
------
REL9_3_STABLE

Details
-------
http://git.postgresql.org/pg/commitdiff/9937f6e4c8ceba37ef840d550bc202c402d48113

Modified Files
--------------
doc/src/sgml/libpq.sgml | 23 +++++++++++++++--------
src/interfaces/libpq/fe-exec.c | 22 ++++++++++------------
2 files changed, 25 insertions(+), 20 deletions(-)