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
Views: Raw Message | Whole Thread | Download mbox | Resend email
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 Content-Type Size
monfunc3.patch application/octet-stream 845 bytes

In response to

Responses

Browse pgsql-docs by date

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