On 2020-06-02 18:07, Bruce Momjian wrote:
> I can adjust things, but what logic are we following? Before my patch,
> sepgsql had an xreflabel, and vacuumlo did not. I would like to have a
> documented policy of where we should have xreflabels, and where not, and
> I can then adjust things to match. I don't mind using <link> but it is
> confusing to be able to reference xreflabels in some places and be
> required to use link in others.
One reason for that difference specifically is that vacuumlo is refentry
which can generate its own link text like "vacuumlo(1)", and sepgsql is
a sect1, which by default creates text like "Section 23.2", which
perhaps someone wanted to override.
--
Peter Eisentraut http://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services