Received: from localhost (maia-3.hub.org [200.46.204.184])
	by postgresql.org (Postfix) with ESMTP id BA5D79FB8A3
	for <pgsql-docs-postgresql.org@postgresql.org>;
	Mon, 14 May 2007 15:47:23 -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 52968-05 for <pgsql-docs-postgresql.org@postgresql.org>;
	Mon, 14 May 2007 15:47:11 -0300 (ADT)
X-Greylist: from auto-whitelisted by SQLgrey-1.7.4
Received: from noel.decibel.org (noel.decibel.org [67.100.216.10])
	by postgresql.org (Postfix) with ESMTP id 91CC19FB88D
	for <pgsql-docs@postgresql.org>; Mon, 14 May 2007 15:47:18 -0300 (ADT)
Received: from [192.168.42.85] (unknown [192.168.42.85])
	(using TLSv1 with cipher AES128-SHA (128/128 bits))
	(No client certificate requested)
	by noel.decibel.org (Postfix) with ESMTP id CA8DD5643D;
	Mon, 14 May 2007 13:47:16 -0500 (CDT)
In-Reply-To: <21498.1179099930@sss.pgh.pa.us>
References: <200705061644.l46Giof10226@momjian.us>
	<9D7639D9-EAE4-47A5-8FDD-76E1EC29A342@decibel.org>
	<827EEEAA-A2B0-4AE4-9D51-96524E05CFC1@decibel.org>
	<20752.1179096481@sss.pgh.pa.us>
	<5BCF4FA7-1DBA-4CE7-A07A-D923FC2BFA7A@decibel.org>
	<21498.1179099930@sss.pgh.pa.us>
Mime-Version: 1.0 (Apple Message framework v752.3)
Content-Type: multipart/mixed; boundary=Apple-Mail-2--1002224633
Message-Id: <B4117EF4-2CFE-401B-9C8E-B18A51FA556B@decibel.org>
Cc: Bruce Momjian <bruce@momjian.us>,
 pgsql-docs@postgresql.org
From: Jim Nasby <decibel@decibel.org>
Subject: Re: Documentation of pg_badkend_pid and stats functions 
Date: Mon, 14 May 2007 13:47:18 -0500
To: Tom Lane <tgl@sss.pgh.pa.us>
X-Mailer: Apple Mail (2.752.3)
X-Virus-Scanned: Maia Mailguard 1.0.1
X-Archive-Number: 200705/33
X-Sequence-Number: 4262


--Apple-Mail-2--1002224633
Content-Transfer-Encoding: 7bit
Content-Type: text/plain;
	charset=US-ASCII;
	delsp=yes;
	format=flowed

On May 13, 2007, at 6:45 PM, Tom Lane wrote:
> "Jim C. Nasby" <decibel@decibel.org> writes:
>> On Sun, May 13, 2007 at 06:48:01PM -0400, Tom Lane wrote:
>>> Surely a section should not *begin* with a cross-reference to
>>> someplace else.
>
>> My concern is that folks will see the table right below it, not find
>> what they're looking for there, and move on... what about immediately
>> after the table?
>
> Immediately after is fine with me.  For that matter, you could  
> probably
> get away with putting it between the introductory para and the table
> proper.  I'm just allergic to sections that don't begin with a topic
> sentence telling you what they are about.

See attached. I wanted to not put it between the paragraph  
referencing the table and the table itself, but couldn't think of a  
better intro paragraph for the section...
--Apple-Mail-2--1002224633
Content-Transfer-Encoding: 7bit
Content-Type: application/octet-stream; x-unix-mode=0640; name=monfunc3.patch
Content-Disposition: attachment;
	filename=monfunc3.patch

Index: doc/src/sgml/func.sgml
===================================================================
RCS file: /projects/cvsroot/pgsql/doc/src/sgml/func.sgml,v
retrieving revision 1.379
diff -c -r1.379 func.sgml
*** doc/src/sgml/func.sgml	7 May 2007 07:53:26 -0000	1.379
--- doc/src/sgml/func.sgml	14 May 2007 18:45:29 -0000
***************
*** 10200,10205 ****
--- 10200,10212 ----
     functions that extract session and system information.
    </para>
  
+   <para>
+    In addition to the functions listed in this section, there are a number of
+    functions related to the statistics system that also provide system
+    information. See <xref linkend="monitoring-stats-views"> for more
+    information.
+   </para>
+ 
     <table id="functions-info-session-table">
      <title>Session Information Functions</title>
      <tgroup cols="3">

--Apple-Mail-2--1002224633
Content-Transfer-Encoding: 7bit
Content-Type: text/plain;
	charset=US-ASCII;
	format=flowed


--
Jim Nasby                                            jim@nasby.net
EnterpriseDB      http://enterprisedb.com      512.569.9461 (cell)



--Apple-Mail-2--1002224633--