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

Re: Documentation of pg_badkend_pid and stats functions

From: Bruce Momjian <bruce(at)momjian(dot)us>
To: Jim Nasby <decibel(at)decibel(dot)org>
Cc: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>, pgsql-docs(at)postgresql(dot)org
Subject: Re: Documentation of pg_badkend_pid and stats functions
Date: 2007-05-30 18:13:31
Message-ID: 200705301813.l4UIDVx17395@momjian.us (view raw or flat)
Thread:
Lists: pgsql-docs
Patch applied.  Thanks.

---------------------------------------------------------------------------


Jim Nasby wrote:
> 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, skipping... ]

> 
> --
> Jim Nasby                                            jim(at)nasby(dot)net
> EnterpriseDB      http://enterprisedb.com      512.569.9461 (cell)
> 
> 
> 
> ---------------------------(end of broadcast)---------------------------
> TIP 9: In versions below 8.0, the planner will ignore your desire to
>        choose an index scan if your joining column's datatypes do not
>        match

-- 
  Bruce Momjian  <bruce(at)momjian(dot)us>          http://momjian.us
  EnterpriseDB                               http://www.enterprisedb.com

  + If your life is a hard drive, Christ can be your backup. +

In response to

pgsql-docs by date

Next:From: Bruce MomjianDate: 2007-05-30 19:45:37
Subject: Re: [PERFORM] [doc patch] a slight VACUUM / VACUUM FULL doc improvement proposal
Previous:From: Bruce MomjianDate: 2007-05-30 18:10:54
Subject: Re: OS/X startup scripts

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