To: Peter Eisentraut <peter_e@gmx.net>
cc: pgsql-docs@postgreSQL.org
Subject: Re: [COMMITTERS] pgsql: Remove unnecessary xref endterm attributes
	and title ids The
In-reply-to: <20100403072302.CBE9E7541D0@cvs.postgresql.org> 
References: <20100403072302.CBE9E7541D0@cvs.postgresql.org>
Comments: In-reply-to petere@postgresql.org (Peter Eisentraut)
	message dated "Sat, 03 Apr 2010 07:23:02 -0000"
Date: Sat, 03 Apr 2010 11:15:48 -0400
Message-ID: <19737.1270307748@sss.pgh.pa.us>
From: Tom Lane <tgl@sss.pgh.pa.us>

petere@postgresql.org (Peter Eisentraut) writes:
> Log Message:
> -----------
> 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.

			regards, tom lane