Received: from localhost (maia-5.hub.org [200.46.204.182])
	by postgresql.org (Postfix) with ESMTP id 13BF69FB897
	for <pgsql-docs-postgresql.org@postgresql.org>;
	Sun, 13 May 2007 20:00:11 -0300 (ADT)
Received: from postgresql.org ([200.46.204.71])
	by localhost (mx1.hub.org [200.46.204.182]) (amavisd-maia, port 10024)
	with ESMTP id 55735-05 for <pgsql-docs-postgresql.org@postgresql.org>;
	Sun, 13 May 2007 20:00:02 -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 E73F09FB2C4
	for <pgsql-docs@postgresql.org>; Sun, 13 May 2007 20:00:05 -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 527BF564C3;
	Sun, 13 May 2007 18:00:04 -0500 (CDT)
In-Reply-To: <20752.1179096481@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>
Mime-Version: 1.0 (Apple Message framework v752.3)
Content-Type: multipart/mixed; boundary=Apple-Mail-1--1073463612
Message-Id: <5BCF4FA7-1DBA-4CE7-A07A-D923FC2BFA7A@decibel.org>
Cc: Bruce Momjian <bruce@momjian.us>,
 pgsql-docs@postgresql.org
From: "Jim C. Nasby" <decibel@decibel.org>
Subject: Re: Documentation of pg_badkend_pid and stats functions
Date: Sun, 13 May 2007 17:59:59 -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/14
X-Sequence-Number: 4243


--Apple-Mail-1--1073463612
Content-Transfer-Encoding: 7bit
Content-Type: application/octet-stream; x-unix-mode=0640; name=monfunc2.patch
Content-Disposition: attachment;
	filename=monfunc2.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	13 May 2007 22:59:02 -0000
***************
*** 10295,10300 ****
--- 10295,10307 ----
      </tgroup>
     </table>
  
+   <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>
+ 
     <indexterm zone="functions-info">
      <primary>user</primary>
      <secondary>current</secondary>

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

On Sun, May 13, 2007 at 06:48:01PM -0400, Tom Lane wrote:
> Jim Nasby <decibel@decibel.org> writes:
>>     <title>System Information Functions</title>
>
>>     <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>
>
> 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?
-- 
Jim Nasby                                      decibel@decibel.org
EnterpriseDB      http://enterprisedb.com      512.569.9461 (cell)

--Apple-Mail-1--1073463612--