X-Original-To: pgsql-docs-postgresql.org@localhost.postgresql.org
Received: from localhost (unknown [200.46.204.2])
	by svr1.postgresql.org (Postfix) with ESMTP id CCB10D1D8B5
	for <pgsql-docs-postgresql.org@localhost.postgresql.org>;
	Mon,  8 Mar 2004 20:15:34 +0000 (GMT)
Received: from svr1.postgresql.org ([200.46.204.71])
	by localhost (neptune.hub.org [200.46.204.2]) (amavisd-new, port 10024)
	with ESMTP id 06047-01
	for <pgsql-docs-postgresql.org@localhost.postgresql.org>;
	Mon,  8 Mar 2004 16:15:32 -0400 (AST)
Received: from davinci.ethosmedia.com (server228.ethosmedia.com
	[209.128.84.228])
	by svr1.postgresql.org (Postfix) with ESMTP id 587C2D1BAF8
	for <pgsql-docs@postgresql.org>; Mon,  8 Mar 2004 16:15:30 -0400 (AST)
Received: from [63.195.55.98] (HELO 192.168.1.29)
	by davinci.ethosmedia.com (CommuniGate Pro SMTP 4.1.8)
	with ESMTP id 4585443; Mon, 08 Mar 2004 12:16:40 -0800
From: Josh Berkus <josh@agliodbs.com>
Reply-To: josh@agliodbs.com
Organization: Aglio Database Solutions
To: Neil Conway <neilc@samurai.com>, pgsql-docs@postgresql.org
Subject: Re: adding GUC variable xrefs
Date: Mon, 8 Mar 2004 12:14:44 -0800
User-Agent: KMail/1.5.4
References: <404A01AE.2080902@samurai.com>
In-Reply-To: <404A01AE.2080902@samurai.com>
MIME-Version: 1.0
Content-Type: text/plain;
  charset="iso-8859-1"
Content-Transfer-Encoding: 7bit
Content-Disposition: inline
Message-Id: <200403081214.44403.josh@agliodbs.com>
X-Virus-Scanned: by amavisd-new at postgresql.org
X-Archive-Number: 200403/9
X-Sequence-Number: 2299

Neil,

> I'm planning to replace most of the <varname> tags enclosing GUC 
> variables in the docs with <xref> tags that allow the user to directly 
> jump to the documentation for that particular configuration variable 
> (that also requires adding "id" and "xreflabel" attributes to the GUC 
> var documentation). The "xreflabel" of a GUC var is just it's name, so 
> the actual text that is generated should be the same (the presentation 
> will be a little different though).

Please do.  I was working on this and got hung up on the broken SGML libs on 
my laptop.   (which are still broken, ^&$^@# SuSE!).

-- 
-Josh Berkus
 Aglio Database Solutions
 San Francisco