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

help / color / mirror / Atom feed
From: Bruce Momjian <bruce@momjian.us>
To: Peter Eisentraut <peter.eisentraut@2ndquadrant.com>
Cc: Tom Lane <tgl@sss.pgh.pa.us>
Cc: PostgreSQL-documentation <pgsql-docs@postgresql.org>
Subject: Re: Adding xreflable
Date: Thu, 11 Jun 2020 18:38:45 -0400
Message-ID: <20200611223845.GB2507@momjian.us> (raw)
In-Reply-To: <1a9904ee-b5f5-768b-25f4-5be52ee6ce7e@2ndquadrant.com>
References: <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>
	<1a9904ee-b5f5-768b-25f4-5be52ee6ce7e@2ndquadrant.com>

On Thu, Jun  4, 2020 at 07:14:17PM +0200, Peter Eisentraut wrote:
> 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.

Yes, that makes sense, thanks.

-- 
  Bruce Momjian  <bruce@momjian.us>        https://momjian.us
  EnterpriseDB                             https://enterprisedb.com

  The usefulness of a cup is in its emptiness, Bruce Lee






view thread (17+ messages)

Message-ID: <20200611223845.GB2507@momjian.us>
Permalink:  ../20200611223845.GB2507@momjian.us/
Also on:    postgresql.org/message-id/20200611223845.GB2507@momjian.us

 · 

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: bruce@momjian.us, peter.eisentraut@2ndquadrant.com, tgl@sss.pgh.pa.us
  Subject: Re: Adding xreflable
  In-Reply-To: <20200611223845.GB2507@momjian.us>

* 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