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