public inbox for [email protected]  

help / color / mirror / Atom feed

From: Peter Eisentraut <[email protected]>
To: Tom Lane <[email protected]>
Cc: [email protected]
Subject: Re: [COMMITTERS] pgsql: Remove unnecessary xref endterm attributes and title ids The
Date: Sun, 04 Apr 2010 23:26:14 +0300
Message-ID: <[email protected]> (raw)
In-Reply-To: <[email protected]>
References: <[email protected]>
	<[email protected]>

On lör, 2010-04-03 at 11:15 -0400, Tom Lane wrote:
> > Remove unnecessary xref endterm attributes and title ids
> 
> > The endterm attribute is mainly useful when the toolchain does not support
> > automatic link target text generation for a particular situation.  In  the
> > past, this was required by the man page tools for all reference page links,
> > but that is no longer the case, and it now actually gets in the way of
> > proper automatic link text generation.  The only remaining use cases are
> > currently xrefs to refsects.
> 
> I won't miss the need to write endterm, but what's the "remaining use
> cases" exactly?  You need to explain to other people what's the new
> dispensation, if you don't want it to get messed up again.

Right, the upshot is that if the toolchain complains like this

openjade:indices.sgml:101:28:E: [xref to REFSECT2 unsupported]

then it means it cannot create a linkend text automatically and you need
to supply the endterm attribute to tell it what text to use.  If it
doesn't complain, endterm should probably not be used.

view thread (3+ messages)

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: [email protected]
  Cc: [email protected], [email protected]
  Subject: Re: [COMMITTERS] pgsql: Remove unnecessary xref endterm attributes and title ids The
  In-Reply-To: <[email protected]>

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

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