Skip site navigation (1) Skip section navigation (2)

Re: Documentation of pg_badkend_pid and stats functions

From: Jim Nasby <decibel(at)decibel(dot)org>
To: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
Cc: Bruce Momjian <bruce(at)momjian(dot)us>, pgsql-docs(at)postgresql(dot)org
Subject: Re: Documentation of pg_badkend_pid and stats functions
Date: 2007-05-14 18:47:18
Message-ID: B4117EF4-2CFE-401B-9C8E-B18A51FA556B@decibel.org (view raw or flat)
Thread:
Lists: pgsql-docs
On May 13, 2007, at 6:45 PM, Tom Lane wrote:
> "Jim C. Nasby" <decibel(at)decibel(dot)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...

Attachment: monfunc3.patch
Description: application/octet-stream (845 bytes)

In response to

Responses

pgsql-docs by date

Next:From: Alvaro HerreraDate: 2007-05-14 19:16:15
Subject: Re: [PATCHES] OS/X startup scripts
Previous:From: Andrew HammondDate: 2007-05-14 17:56:23
Subject: Re: On patching without write access to CVS

Privacy Policy | About PostgreSQL
Copyright © 1996-2014 The PostgreSQL Global Development Group