Received: from maia.hub.org (maia-5.hub.org [200.46.204.29])
	by mail.postgresql.org (Postfix) with ESMTP id E30E963424D;
	Fri, 27 Aug 2010 14:25:57 -0300 (ADT)
Received: from mail.postgresql.org ([200.46.204.86])
	by maia.hub.org (mx1.hub.org [200.46.204.29]) (amavisd-maia, port 10024)
	with ESMTP id 29016-01; Fri, 27 Aug 2010 17:25:50 +0000 (UTC)
X-Greylist: from auto-whitelisted by SQLgrey-1.7.6
X-Greylist: from auto-whitelisted by SQLgrey-1.7.6
Received: from spinlock.commandprompt.com (host-215.commandprompt.net
	[207.173.203.215])
	by mail.postgresql.org (Postfix) with ESMTP id 89C4F634244;
	Fri, 27 Aug 2010 14:25:50 -0300 (ADT)
Received: from localhost (localhost [127.0.0.1])
	by spinlock.commandprompt.com (Postfix) with ESMTP id EB9C3348012;
	Fri, 27 Aug 2010 10:25:48 -0700 (PDT)
X-Virus-Scanned: Debian amavisd-new at commandprompt.com
Received: from spinlock.commandprompt.com ([127.0.0.1])
	by localhost (spinlock.commandprompt.com.commandprompt.com [127.0.0.1])
	(amavisd-new, port 10024)
	with ESMTP id 9Syn2PhqFCQI; Fri, 27 Aug 2010 10:25:46 -0700 (PDT)
Received: from [192.168.1.132] (unknown [75.142.155.118])
	by spinlock.commandprompt.com (Postfix) with ESMTPSA id B2D1F348011;
	Fri, 27 Aug 2010 10:25:45 -0700 (PDT)
Subject: Re: [DOCS] Example indenting
From: "Joshua D. Drake" <jd@commandprompt.com>
Reply-To: jd@commandprompt.com
To: Thom Brown <thom@linux.com>
Cc: Kevin Grittner <Kevin.Grittner@wicourts.gov>,
	Magnus Hagander <magnus@hagander.net>,
	Guillaume Lelarge <guillaume@lelarge.info>,
	pgsql-docs <pgsql-docs@postgresql.org>,
	pgsql-www <pgsql-www@postgresql.org>, Tom Lane <tgl@sss.pgh.pa.us>
In-Reply-To: <AANLkTim5VmoACq1zLuL3Fx-xoPwinshg2XFLjHZJcGMO@mail.gmail.com>
References: <AANLkTinz1WZ28k_+7pinbVAs1N4UfLYrJ_Wj=f5k=rjH@mail.gmail.com>
	<19595.1282570992@sss.pgh.pa.us>
	<AANLkTin27ZKYu2tdqn5RZvTaCtuX11=sd_pj7tzoTJiY@mail.gmail.com>
	<20502.1282573993@sss.pgh.pa.us>
	<AANLkTikh9j0jKSpbVnqxxys4TMn4mJGLsryVYZ3XUUti@mail.gmail.com>
	<AANLkTinsyiWpQ3b47ZYmvnLbNteEnxskpwLd9YHCR7FN@mail.gmail.com>
	<AANLkTinxWe1JPZXixtQ9pwsdW4JuBjpbRJp3OnVbUBjb@mail.gmail.com>
	<AANLkTi=O_JCQitEiv294QJZHPV58L7H57uKZTP5FF2RL@mail.gmail.com>
	<AANLkTi=Xc8v+b00BcUSk_-bnQt8nULYz0Jjcg6TwO-Ct@mail.gmail.com>
	<4C7558140200002500034BE5@gw.wicourts.gov>
	<1282778956.11634.585.camel@jd-desktop.unknown.charter.com>
	<4C760112.807@lelarge.info>
	<AANLkTikBFJr_CMpro0tJTZ4qHfbOAHQWtVczgXHR-RDw@mail.gmail.com>
	<1282842211.17406.6.camel@jd-desktop.unknown.charter.com>
	<AANLkTi=-Y6Luz6fXKd+z8xdnVxZVzKDTAMdr75xs3TS6@mail.gmail.com>
	<4C765CB60200002500034C39@gw.wicourts.gov>
	<AANLkTimnoKE8DMEZ=xyYCua5dXN9--zLVxMPzwkMszRp@mail.gmail.com>
	<1282844645.17406.10.camel@jd-desktop.unknown.charter.com>
	<AANLkTine=sv8FrXNUp3=Zrr5yrhzxg_NPbL2_vxZEPWC@mail.gmail.com>
	<4C7797830200002500034D17@gw.wicourts.gov>
	<AANLkTikHyK1uyYm4qjz4QySyGiwy++QihmgXEwyLwS9r@mail.gmail.com>
	<4C779D190200002500034D25@gw.wicourts.gov>
	<AANLkTim5VmoACq1zLuL3Fx-xoPwinshg2XFLjHZJcGMO@mail.gmail.com>
Content-Type: text/plain; charset="UTF-8"
Organization: Command Prompt, Inc.
Date: Fri, 27 Aug 2010 10:25:41 -0700
Message-ID: <1282929941.31376.3.camel@jd-desktop.unknown.charter.com>
Mime-Version: 1.0
X-Mailer: Evolution 2.28.3 
Content-Transfer-Encoding: 7bit
X-Virus-Scanned: Maia Mailguard 1.0.1
X-Spam-Status: No, hits=-1.9 tagged_above=-5 required=5 tests=BAYES_00=-1.9
X-Spam-Level: 
X-Archive-Number: 201008/170
X-Sequence-Number: 19086

On Fri, 2010-08-27 at 18:04 +0100, Thom Brown wrote:

> Something I've noticed is an inconsistency in the SGML markup around
> functions listed in tables.  Sometimes the entire function signature
> is considered to be the function, and other times it's just the
> function name, with its parameters outside of the <function> tags.
> 
> E.g.:
> 
> <function>variance</function>(<replaceable
> class="parameter">expression</replaceable>)
> 
> vs
> 
> <function>stddev_samp(<replaceable
> class="parameter">expression</replaceable>)</function>
> 
> Which way is correct?  It will make a big difference visually with
> these changes.

That is actually a question for pgsql-docs.

Joshua D. Drake


> 

-- 
PostgreSQL.org Major Contributor
Command Prompt, Inc: http://www.commandprompt.com/ - 509.416.6579
Consulting, Training, Support, Custom Development, Engineering
http://twitter.com/cmdpromptinc | http://identi.ca/commandprompt