Re: Adding xreflable - Mailing list pgsql-docs

From Peter Eisentraut
Subject Re: Adding xreflable
Date
Msg-id 1a9904ee-b5f5-768b-25f4-5be52ee6ce7e@2ndquadrant.com
Whole thread Raw
In response to Re: Adding xreflable  (Bruce Momjian <bruce@momjian.us>)
Responses Re: Adding xreflable
List pgsql-docs
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



pgsql-docs by date:

Previous
From: Peter Eisentraut
Date:
Subject: Re: Adding xreflable
Next
From: PG Doc comments form
Date:
Subject: pg_basebackup in tar format with -Xs