Peter Eisentraut <peter.eisentr...@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