Re: Autovacuum docs - Mailing list pgsql-patches

From Michael Paesold
Subject Re: Autovacuum docs
Date
Msg-id 003001c5b82b$fed8e920$0f01a8c0@zaphod
Whole thread Raw
In response to Autovacuum docs  (Alvaro Herrera <alvherre@alvh.no-ip.org>)
List 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


pgsql-patches by date:

Previous
From: Alvaro Herrera
Date:
Subject: Re: Autovacuum docs
Next
From: Peter Eisentraut
Date:
Subject: Re: Autovacuum docs