Received: from maia.hub.org (maia-2.hub.org [200.46.204.251])
	by mail.postgresql.org (Postfix) with ESMTP id D549A1337B67
	for <pgsql-docs-postgresql.org@mail.postgresql.org>;
	Wed,  2 Feb 2011 19:17:36 -0400 (AST)
Received: from mail.postgresql.org ([200.46.204.86])
	by maia.hub.org (mx1.hub.org [200.46.204.251]) (amavisd-maia,
	port 10024) with ESMTP id 89246-01 for
	<pgsql-docs-postgresql.org@mail.postgresql.org>;
	Wed,  2 Feb 2011 23:17:29 +0000 (UTC)
X-Greylist: from auto-whitelisted by SQLgrey-1.7.6
Received: from momjian.us (momjian.us [70.90.9.53])
	by mail.postgresql.org (Postfix) with ESMTP id 58B7B1337999
	for <pgsql-docs@postgresql.org>; Wed,  2 Feb 2011 19:17:29 -0400 (AST)
Received: (from bruce@localhost) by momjian.us (8.11.6/8.11.6) id
 p12NHU202016;
	Wed, 2 Feb 2011 18:17:30 -0500 (EST)
From: Bruce Momjian <bruce@momjian.us>
Message-Id: <201102022317.p12NHU202016@momjian.us>
Subject: Re: varname for GUC variables
In-Reply-To: <4655.1296688499@sss.pgh.pa.us>
To: Tom Lane <tgl@sss.pgh.pa.us>
Date: Wed, 2 Feb 2011 18:17:30 -0500 (EST)
CC: PostgreSQL-documentation <pgsql-docs@postgresql.org>
X-Mailer: ELM [version 2.4ME+ PL124 (25)]
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-Type: text/plain; charset="US-ASCII"
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/9
X-Sequence-Number: 6357

Tom Lane wrote:
> 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.

True on the multiple instances in a paragraph.  I will drop it unless
someone feels we need more.  Thanks.

-- 
  Bruce Momjian  <bruce@momjian.us>        http://momjian.us
  EnterpriseDB                             http://enterprisedb.com

  + It's impossible for everything to be true. +