doc: Simplify description of functions for pg_walinspect

Michael Paquier <michael@paquier.xyz>

Commit: 58597edea102258b21d5f4b4f0d7796c0ebf100a
Author: Michael Paquier <michael@paquier.xyz>
Date: 2023-01-13T00:29:44Z
Releases: 16.0
doc: Simplify description of functions for pg_walinspect

As introduced in 2258e76, the docs were hard to parse:
- The examples used listed a lot of long records, bloating the output.
These are switched to show less records with the expanded format,
similarly to pageinspect.
- The function descriptions listed all the OUT parameters, producing
long lines.  This is updated so as only the input parameters are
documented, clarifying the whole.
- Remove one example on pg_get_wal_stats() when per_record is set to
true, which is not really necessary once we know the output produced,
and the behavior of the parameter is documented.

While on it, fix a few grammar mistakes and simplify a couple of
sentences.

Author: Bharath Rupireddy
Discussion: https://postgr.es/m/CALj2ACVGcUpziGgQrcT-1G3dHWQQfWjYBu1YQ2ypv9y86dgogg@mail.gmail.com
Backpatch-through: 15

Files

PathChange+/−
doc/src/sgml/pgwalinspect.sgml modified +54 −127

Documentation touched

Discussion