Re: Add version macro to libpq-fe.h - Mailing list pgsql-hackers

From Tom Lane
Subject Re: Add version macro to libpq-fe.h
Date
Msg-id 1233367.1624040650@sss.pgh.pa.us
Whole thread Raw
In response to Add version macro to libpq-fe.h  (Boris Kolpackov <boris@codesynthesis.com>)
Responses Re: Add version macro to libpq-fe.h  (Tom Lane <tgl@sss.pgh.pa.us>)
List pgsql-hackers
Alvaro Herrera <alvaro.herrera@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



pgsql-hackers by date:

Previous
From: Tom Lane
Date:
Subject: Re: Add version macro to libpq-fe.h
Next
From: Fabien COELHO
Date:
Subject: Re: Version reporting in pgbench