Received: from maia.hub.org (maia-3.hub.org [200.46.204.243])
	by mail.postgresql.org (Postfix) with ESMTP id E3D001337999
	for <pgsql-docs-postgresql.org@mail.postgresql.org>;
	Wed,  2 Feb 2011 19:15:09 -0400 (AST)
Received: from mail.postgresql.org ([200.46.204.86])
	by maia.hub.org (mx1.hub.org [200.46.204.243]) (amavisd-maia,
	port 10024) with ESMTP id 46300-01 for
	<pgsql-docs-postgresql.org@mail.postgresql.org>;
	Wed,  2 Feb 2011 23:15:02 +0000 (UTC)
X-Greylist: from auto-whitelisted by SQLgrey-1.7.6
Received: from sss.pgh.pa.us (sss.pgh.pa.us [66.207.139.130])
	by mail.postgresql.org (Postfix) with ESMTP id 369791336FA7
	for <pgsql-docs@postgresql.org>; Wed,  2 Feb 2011 19:15:01 -0400 (AST)
Received: from sss2.sss.pgh.pa.us (tgl@localhost [127.0.0.1])
	by sss.pgh.pa.us (8.14.2/8.14.2) with ESMTP id p12NExEL004656;
	Wed, 2 Feb 2011 18:14:59 -0500 (EST)
To: Bruce Momjian <bruce@momjian.us>
cc: PostgreSQL-documentation <pgsql-docs@postgresql.org>
Subject: Re: varname for GUC variables 
In-reply-to: <201102022310.p12NA1p01026@momjian.us> 
References: <201102022310.p12NA1p01026@momjian.us>
Comments: In-reply-to Bruce Momjian <bruce@momjian.us>
	message dated "Wed, 02 Feb 2011 18:10:00 -0500"
Date: Wed, 02 Feb 2011 18:14:59 -0500
Message-ID: <4655.1296688499@sss.pgh.pa.us>
From: Tom Lane <tgl@sss.pgh.pa.us>
X-Virus-Scanned: Maia Mailguard 1.0.1
X-Spam-Status: No, hits=-1.91 tagged_above=-5 required=5 tests=BAYES_00=-1.9,
	T_RP_MATCHES_RCVD=-0.01
X-Spam-Level: 
X-Archive-Number: 201102/8
X-Sequence-Number: 6356

Bruce Momjian <bruce@momjian.us> writes:
> I have applied the attached patch to use <varname> SGML markup
> consistently for GUC variables.  Should we be using <xref> to link to
> more GUC details in the docs?

For the most part I think we do have enough links.  In particular I do
*not* want to see multiple references to the same variable in the same
paragraph all turned into links; that's just distracting.

			regards, tom lane