public inbox for [email protected]  
help / color / mirror / Atom feed
From: Jim C. Nasby <[email protected]>
To: Tom Lane <[email protected]>
Cc: Bruce Momjian <[email protected]>
Cc: [email protected]
Subject: Re: Documentation of pg_badkend_pid and stats functions
Date: Sun, 13 May 2007 17:59:59 -0500
Message-ID: <[email protected]> (raw)
In-Reply-To: <[email protected]>
References: <[email protected]>
	<[email protected]>
	<[email protected]>
	<[email protected]>

On Sun, May 13, 2007 at 06:48:01PM -0400, Tom Lane wrote:
> Jim Nasby <[email protected]> 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                                      [email protected]
EnterpriseDB      http://enterprisedb.com      512.569.9461 (cell)


Attachments:

  [application/octet-stream] monfunc2.patch (787B, 1-monfunc2.patch)
  download | inline diff:
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>


view thread (10+ messages)  latest in thread

reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: [email protected]
  Cc: [email protected], [email protected], [email protected]
  Subject: Re: Documentation of pg_badkend_pid and stats functions
  In-Reply-To: <[email protected]>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox