Alvaro Herrera <alvaro.herr...@2ndquadrant.com> writes: > On 2021-Jun-18, Tom Lane wrote: >> I guess one unresolved question is whether we want to mention these in >> the SGML docs. I vote "no", because it'll raise the maintenance cost >> noticeably. But I can see an argument on the other side.
> Well, if we do want docs for these macros, then IMO it'd be okay to have > them in libpq-fe.h itself rather than SGML. A one-line comment for each > would suffice: WFM. I'd sort of supposed that the symbol names were self-documenting, but you're right that a line or so of annotation improves things. regards, tom lane