Peter Eisentraut <peter.eisentraut@enterprisedb.com> writes:
> On 01.11.22 09:15, Tom Lane wrote:
>> Agreed that the libpq manual is not the place for this, but I feel
>> like it will also be clutter in "Data Types". Perhaps we should
>> invent a new appendix or the like? Somewhere near the wire protocol
>> docs seems sensible.
> Would that clutter the protocol docs? ;-)
I said "near", not "in". At the time I was thinking "new appendix",
but I now recall that the wire protocol docs are not an appendix
but a chapter in the Internals division. So that doesn't seem like
quite the right place anyway.
Perhaps a new chapter under "IV. Client Interfaces" is the right
place?
If we wanted to get aggressive, we could move most of the nitpicky details
about datatype text formatting (e.g., the array quoting rules) there too.
I'm not set on that, but it'd make datatype.sgml smaller which could
hardly be a bad thing.
> I suppose figuring out exactly where to put it and how to mark it up,
> etc., in a repeatable fashion is part of the job here.
Yup.
regards, tom lane