FE/BE docs and unsigned integers

From: Jeff Davis <pgsql(at)j-davis(dot)com>
To: pgsql-docs(at)postgresql(dot)org
Subject: FE/BE docs and unsigned integers
Date: 2014-01-02 18:11:31
Message-ID: 1388686291.19125.437.camel@jdavis
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

The documentation doesn't give much of a hint that the protocol is using
unsigned integers. For instance, under ParameterDescription here:

http://www.postgresql.org/docs/9.3/static/protocol-message-formats.html

it says that the object ID is an Int32, which is described here:

http://www.postgresql.org/docs/9.3/static/protocol-message-types.html

as just a plain 32-bit integer. But the code (e.g.
getParamDescriptions()) is clearly reading it into an Oid, which is
unsigned.

Is there a reason this isn't clear? Is it meant to be ambiguous because
(as far as the protocol is concerned) it's just an opaque 32 bits?

It seems like it's worth a note somewhere at least.

Regards,
Jeff Davis

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Tom Lane 2014-01-02 18:41:11 Re: FE/BE docs and unsigned integers
Previous Message Peter Eisentraut 2014-01-01 19:46:18 Re: Include favicon in the html docs