Re: [DOCS] Stats views and functions not in order? - Mailing list pgsql-hackers

From Peter Smith
Subject Re: [DOCS] Stats views and functions not in order?
Date
Msg-id CAHut+PvjbV5T4H6vk6=hPrU0iZ2KYx39cxS=xJtUL=Mu6H+t6Q@mail.gmail.com
Whole thread Raw
In response to [DOCS] Stats views and functions not in order?  (Peter Smith <smithpb2250@gmail.com>)
Responses Re: [DOCS] Stats views and functions not in order?
List pgsql-hackers
On Tue, Aug 2, 2022 at 9:40 AM Peter Smith <smithpb2250@gmail.com> wrote:
>
> Hi Hackers.
>
> I noticed that there are quite a few items in Chapter 28.2 "The
> Cumulative Statistics System" [1] which have no obvious order.
>
> e.g.
>
> - The views (28.2.3 -> 28.2.23) don't seem to be in any order that I
> could work out. Why not alphabetical?
>
> - [2] Table 2.1 "Dynamic Statistics View" views are not in alphabetical order?
>
> - [2] Table 2.2 "Collected Statistics View" views are not in alphabetical order?
>
> - [3] Table 28.34 "Additional Statistics Functions" the
> 'pg_stat_clear_snapshot' is the only one not in order?
>
> - [3] Table 28.35 "Per-Backend Statistics Functions" the
> 'pg_stat_get_backend_idset' is the only one not in order?
>
> ~~
>
> So it doesn't seem as readable as it could be. If other people think
> the same, I can write a patch for it.
>

I received no feedback when I reported this about a month ago, so I
went ahead and made patches to fix the problem anyway.

PSA. Note that no content was harmed in the making of these patches -
I only moved things around to be ordered.

IMO these docs look better now.

Thoughts?

------
Kind Regards,
Peter Smith.
Fujitsu Australia

Attachment

pgsql-hackers by date:

Previous
From: Andres Freund
Date:
Subject: Re: [PATCH] Add native windows on arm64 support
Next
From: Tomas Vondra
Date:
Subject: Re: Reducing the chunk header sizes on all memory context types