Re: [PATCHES] Autovacuum docs

2005-09-13 Thread Peter Eisentraut
Tom Lane wrote: > I think we mostly don't use endterm on cross-references to sections. > Not sure if that's a project standard, or just laziness, though. Yes, please don't use those. > The other sect2 titles in this chapter capitalize only the first > word. Again, I'm not sure how fully that conv

Re: [PATCHES] Autovacuum docs

2005-09-12 Thread Michael Paesold
Alvaro Herrera wrote: "These settings control the default behavior for the autovacuum daemon. Please refer to _Section 22.1.4_ for more information." I don't see how to cleanly fit "The auto-vacuum daemon" in that sentence in a way that looks like a reference. So, in short, if there is a policy

Re: [PATCHES] Autovacuum docs

2005-09-12 Thread Alvaro Herrera
On Mon, Sep 12, 2005 at 04:17:29PM -0400, Tom Lane wrote: > Alvaro Herrera <[EMAIL PROTECTED]> writes: > > I have prepared some docs for autovacuum. I attach the patch. Comments > > on grammar, style etc. are welcome. Applied, updated per your comments. > > +See . > > I think we mostly don

Re: [PATCHES] Autovacuum docs

2005-09-12 Thread Matthew T. O'Connor
Tom Lane wrote: + Additionally to the base threshold values and scale factors, there are + two parameters that can be set for each table in pg_autovacuum: "Additionally to" is not good style ... maybe "Besides"? I think "In addition to" was what Alvaro meant, which works.

Re: [PATCHES] Autovacuum docs

2005-09-12 Thread Tom Lane
Alvaro Herrera <[EMAIL PROTECTED]> writes: > I have prepared some docs for autovacuum. I attach the patch. Comments > on grammar, style etc. are welcome. A few piddling suggestions: > +See . I think we mostly don't use endterm on cross-references to sections. Not sure if that's a project s

Re: [PATCHES] Autovacuum docs

2005-09-12 Thread Peter Eisentraut
Alvaro Herrera wrote: > I have prepared some docs for autovacuum. I attach the patch. > Comments on grammar, style etc. are welcome. Looks very good to me. -- Peter Eisentraut http://developer.postgresql.org/~petere/ ---(end of broadcast)--- TIP

[PATCHES] Autovacuum docs

2005-09-12 Thread Alvaro Herrera
Hackers, I have prepared some docs for autovacuum. I attach the patch. Comments on grammar, style etc. are welcome. I will not apply it yet because it conflicts with Neil's runtime-config restructuring, so I'll wait until he applies his patch. -- Alvaro Herrera -- Valdivia, Chile Arch