Re: Adding xreflable

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