Re: Autovacuum docs

From: "Michael Paesold" <mpaesold(at)gmx(dot)at>
To: "Alvaro Herrera" <alvherre(at)alvh(dot)no-ip(dot)org>, "Tom Lane" <tgl(at)sss(dot)pgh(dot)pa(dot)us>
Cc: "Patches" <pgsql-patches(at)postgresql(dot)org>
Subject: Re: Autovacuum docs
Date: 2005-09-13 06:25:53
Message-ID: 003001c5b82b$fed8e920$0f01a8c0@zaphod
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-patches

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 on this, I propose to update it to
> use endterm wherever the surrounding text allows it.

IIRC the reasoning for not using endterm is that the docs should work well
with output formats that don't have hyperlinks, e.g. print. There it is
necessary to include the section number for easy navigation.

Best Regards,
Michael Paesold

In response to

Browse pgsql-patches by date

  From Date Subject
Next Message Peter Eisentraut 2005-09-13 07:23:20 Re: Autovacuum docs
Previous Message Matthew T. O'Connor 2005-09-13 02:23:46 Re: Autovacuum docs