pg.ddx.io  pgsql-docs@postgresql.org mailing list archive  

help / color / mirror / Atom feed
From: Peter Eisentraut <peter.eisentraut@2ndquadrant.com>
To: Bruce Momjian <bruce@momjian.us>
Cc: Tom Lane <tgl@sss.pgh.pa.us>
Cc: PostgreSQL-documentation <pgsql-docs@postgresql.org>
Subject: Re: Adding xreflable
Date: Thu, 4 Jun 2020 19:14:17 +0200
Message-ID: <1a9904ee-b5f5-768b-25f4-5be52ee6ce7e@2ndquadrant.com> (raw)
In-Reply-To: <20200602160717.GA16329@momjian.us>
References: <18482.1589549850@sss.pgh.pa.us>
	<20200515134900.GD3894@momjian.us>
	<19807.1589551746@sss.pgh.pa.us>
	<20200515142204.GE3894@momjian.us>
	<22323.1589555218@sss.pgh.pa.us>
	<20200515153034.GG3894@momjian.us>
	<20200515164747.GH3894@momjian.us>
	<8315c0ca-7758-8823-fcb6-f37f9413e6b6@2ndquadrant.com>
	<20200522164518.GG30409@momjian.us>
	<28ff383a-59c1-c8a1-a4de-5f5f3e7e794d@2ndquadrant.com>
	<20200602160717.GA16329@momjian.us>

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





view thread (17+ messages)  latest in thread

Message-ID: <1a9904ee-b5f5-768b-25f4-5be52ee6ce7e@2ndquadrant.com>
Permalink:  ../1a9904ee-b5f5-768b-25f4-5be52ee6ce7e@2ndquadrant.com/
Also on:    postgresql.org/message-id/1a9904ee-b5f5-768b-25f4-5be52ee6ce7e@2ndquadrant.com

 · 

reply
Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: pgsql-docs@postgresql.org
  Cc: peter.eisentraut@2ndquadrant.com, bruce@momjian.us, tgl@sss.pgh.pa.us
  Subject: Re: Adding xreflable
  In-Reply-To: <1a9904ee-b5f5-768b-25f4-5be52ee6ce7e@2ndquadrant.com>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox