Received: from localhost (maia-2.hub.org [200.46.204.187]) by postgresql.org (Postfix) with ESMTP id D8F839FB5E6 for ; Sun, 13 May 2007 20:45:42 -0300 (ADT) Received: from postgresql.org ([200.46.204.71]) by localhost (mx1.hub.org [200.46.204.187]) (amavisd-maia, port 10024) with ESMTP id 46325-02 for ; Sun, 13 May 2007 20:45:33 -0300 (ADT) X-Greylist: from auto-whitelisted by SQLgrey-1.7.4 Received: from sss.pgh.pa.us (sss.pgh.pa.us [66.207.139.130]) by postgresql.org (Postfix) with ESMTP id 490BC9FB5F4 for ; Sun, 13 May 2007 20:45:38 -0300 (ADT) Received: from sss2.sss.pgh.pa.us (tgl@localhost [127.0.0.1]) by sss.pgh.pa.us (8.14.1/8.14.1) with ESMTP id l4DNjUYK021499; Sun, 13 May 2007 19:45:30 -0400 (EDT) To: "Jim C. Nasby" cc: Bruce Momjian , pgsql-docs@postgresql.org Subject: Re: Documentation of pg_badkend_pid and stats functions In-reply-to: <5BCF4FA7-1DBA-4CE7-A07A-D923FC2BFA7A@decibel.org> 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> Comments: In-reply-to "Jim C. Nasby" message dated "Sun, 13 May 2007 17:59:59 -0500" Date: Sun, 13 May 2007 19:45:30 -0400 Message-ID: <21498.1179099930@sss.pgh.pa.us> From: Tom Lane X-Virus-Scanned: Maia Mailguard 1.0.1 X-Archive-Number: 200705/16 X-Sequence-Number: 4245 "Jim C. Nasby" 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. regards, tom lane