[COMMITTERS] pgsql: Improve multivariate statistics documentation - Mailing list pgsql-committers

From Alvaro Herrera
Subject [COMMITTERS] pgsql: Improve multivariate statistics documentation
Date
Msg-id E1d1H3o-00083E-FC@gemulon.postgresql.org
Whole thread Raw
List pgsql-committers
Improve multivariate statistics documentation

Extended statistics commit 7b504eb282c did not include appropriate
documentation next to where we document regular planner statistics (I
ripped what was submitted before commit and then forgot to put it back),
and while later commit 2686ee1b7ccf added some material, it structurally
depended on what I had ripped out, so the end result wasn't proper.

Fix those problems by shuffling what was added by 2686ee1b7ccf and
including some additional material, so that now chapter 14 "Performance
Tips" now describes the types of multivariate statistics we currently
have, and chapter 68 "How the Planner Uses Statistics" shows some
examples.  The new text should be more in line with previous material,
in (hopefully) the appropriate depth.

While at it, fix a small bug in pg_statistic_ext docs: one column was
listed in the wrong spot.

Branch
------
master

Details
-------
https://git.postgresql.org/pg/commitdiff/919f6d746e45c8fe84d02799053ef47c3bb11050

Modified Files
--------------
doc/src/sgml/catalogs.sgml  |  22 ++---
doc/src/sgml/perform.sgml   | 195 +++++++++++++++++++++++++++++++++++++
doc/src/sgml/planstats.sgml | 228 ++++++++++++++++++++------------------------
3 files changed, 311 insertions(+), 134 deletions(-)


pgsql-committers by date:

Previous
From: Tom Lane
Date:
Subject: [COMMITTERS] pgsql: Sync pg_ctl documentation and usage message with reality.
Next
From: Tom Lane
Date:
Subject: [COMMITTERS] pgsql: Add missing erand48.c to libpq/.gitignore.