Refactor documentation for wait events (Was: pgsql: Add wait event for fsync of WAL segments)

From: Michael Paquier <michael(at)paquier(dot)xyz>
To: Postgres hackers <pgsql-hackers(at)postgresql(dot)org>
Cc: Peter Geoghegan <pg(at)bowt(dot)ie>, Alvaro Herrera <alvherre(at)2ndquadrant(dot)com>, Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>, Julien Rouhaud <rjuju123(at)gmail(dot)com>, Robert Haas <robertmhaas(at)gmail(dot)com>
Subject: Refactor documentation for wait events (Was: pgsql: Add wait event for fsync of WAL segments)
Date: 2018-07-16 02:10:36
Message-ID: 20180716021036.GA2853@paquier.xyz
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-committers pgsql-hackers

On Fri, Jul 13, 2018 at 04:57:59PM -0500, Robert Haas wrote:
> On Mon, Jul 9, 2018 at 4:41 PM, Michael Paquier <michael(at)paquier(dot)xyz> wrote:
>> Another idea that I have here, is to rework the page for monitoring
>> stats so as we create one sub-section for each system view, and also one
>> for the table of wait events. For the wait events, we could then
>> completely remove the first category column which has morerows and
>> divide the section into on table per event category.
>
> +1 from me. I think I proposed that before.

Attached is a proof of concept of that. I have divided the "Viewing
Statistics" section into a subset for each catalog, and each wait event
type gains its sub-section as well. There is a bit more to do with the
indentation and some xreflabels, but I think that this is enough to
begin a discussion.

Thoughts?
--
Michael

Attachment Content-Type Size
wait-event-doc-refactor.patch text/x-diff 16.6 KB

In response to

Responses

Browse pgsql-committers by date

  From Date Subject
Next Message Peter Eisentraut 2018-07-16 08:50:52 pgsql: doc: Update redirecting links
Previous Message Amit Kapila 2018-07-15 11:09:50 Re: YA race condition in 001_stream_rep.pl (was Re: pgsql: Allow using the updated tuple while moving it to a different par)

Browse pgsql-hackers by date

  From Date Subject
Next Message Stephen Frost 2018-07-16 02:54:27 Re: patch to allow disable of WAL recycling
Previous Message David Fetter 2018-07-16 01:40:42 Make foo=null a warning by default.