Received: from localhost (unknown [200.46.204.184])
	by postgresql.org (Postfix) with ESMTP id 5132A9F9BA6
	for <pgsql-docs-postgresql.org@postgresql.org>;
	Sat,  6 Oct 2007 14:58:22 -0300 (ADT)
Received: from postgresql.org ([200.46.204.71])
	by localhost (mx1.hub.org [200.46.204.184]) (amavisd-maia, port 10024)
	with ESMTP id 27790-02 for <pgsql-docs-postgresql.org@postgresql.org>;
	Sat,  6 Oct 2007 14:58:15 -0300 (ADT)
X-Greylist: from auto-whitelisted by SQLgrey-1.7.5
Received: from lists.commandprompt.com (host-254.commandprompt.net
	[207.173.203.254])
	by postgresql.org (Postfix) with ESMTP id 3B2E29F9B71
	for <pgsql-docs@postgresql.org>; Sat,  6 Oct 2007 14:58:16 -0300 (ADT)
Received: from perhan.alvh.no-ip.org (201-220-98-36.bk9-dsl.surnet.cl
	[201.220.98.36]) (authenticated bits=0)
	by lists.commandprompt.com (8.13.7/8.13.6) with ESMTP id l96HwFjX011829;
	Sat, 6 Oct 2007 10:58:16 -0700
Received: by perhan.alvh.no-ip.org (Postfix, from userid 1000)
	id D6D9B47C6E; Sat,  6 Oct 2007 13:58:13 -0400 (CLT)
Date: Sat, 6 Oct 2007 13:58:13 -0400
From: Alvaro Herrera <alvherre@commandprompt.com>
To: Guillaume Lelarge <guillaume@lelarge.info>
Cc: pgsql-docs@postgresql.org
Subject: Re: Another small patch...
Message-ID: <20071006175813.GH7190@alvh.no-ip.org>
References: <4707BFBE.7060203@lelarge.info>
	<20071006174858.GG7190@alvh.no-ip.org>
MIME-Version: 1.0
Content-Type: text/plain; charset=iso-8859-1
Content-Disposition: inline
Content-Transfer-Encoding: 8bit
In-Reply-To: <20071006174858.GG7190@alvh.no-ip.org>
User-Agent: Mutt/1.5.16 (2007-06-11)
X-Virus-Scanned: ClamAV 0.91.1/4482/Fri Oct 5 15:43:49 2007 on
	projects.commandprompt.com
X-Virus-Status: Clean
X-Greylist: Sender succeded SMTP AUTH authentication, not delayed by
	milter-greylist-1.6 (lists.commandprompt.com [192.168.2.159]);
	Sat, 06 Oct 2007 10:58:17 -0700 (PDT)
X-Virus-Scanned: Maia Mailguard 1.0.1
X-Archive-Number: 200710/16
X-Sequence-Number: 4437

Alvaro Herrera wrote:
> Guillaume Lelarge wrote:
> > ... this time, for maintenance.sgml.
> 
> Applied, thanks.  I'm wondering whether this should be
> 
>     <para>
> !    <productname>PostgreSQL</productname>'s
> !    <xref linkend="sql-vacuum" endterm="sql-vacuum-title"> command has to run on
> !    a regular basis for several reasons:
> 
> instead.  I didn't try to compile it so maybe the output is not OK.

OK, I need opinions on this issue.  We currently have output that looks
like

"PostgreSQL's Vacuum (/Section 10.4.2/) command has to run ..."
(the part between // is a clickable link)

but with the patch above, it would show up as 
"PostgreSQL's /Vacuum/ command has to run ..."

Is there a preferred way to link?  I notice there is plenty of usage of
both forms.

I wonder what does printed output look like?  Does it just just lose the
reference?

-- 
Alvaro Herrera                          Developer, http://www.PostgreSQL.org/
Al principio era UNIX, y UNIX habló y dijo: "Hello world\n".
No dijo "Hello New Jersey\n", ni "Hello USA\n".