]> granicus.if.org Git - postgresql/commit
Doc: rework introductory documentation about covering indexes.
authorTom Lane <tgl@sss.pgh.pa.us>
Thu, 22 Nov 2018 18:24:57 +0000 (13:24 -0500)
committerTom Lane <tgl@sss.pgh.pa.us>
Thu, 22 Nov 2018 18:25:11 +0000 (13:25 -0500)
commit2c0791376aeda0868a646d35d95f2be42ec97170
treefc58844be68f64d1b8a880c5f8b4a5ebc9d2a9f3
parentdbd9bfd7183349e227d5ed7ade18083c44050fc1
Doc: rework introductory documentation about covering indexes.

Documenting INCLUDE in the section about unique indexes is confusing,
as complained of by Emilio Platzer.  Furthermore, it entirely failed
to explain why you might want to use the feature.  The section about
index-only scans is really the right place; it already talked about
making such things the hard way.  Rewrite that text to describe INCLUDE
as the normal way to make a covering index.

Also, move that section up a couple of places, as it now seems more
important than some of the stuff we had before it.  It still has to
be after expression and partial indexes, since otherwise some of it
would involve forward references.

Discussion: https://postgr.es/m/154031939560.30897.14677735588262722042@wrigleys.postgresql.org
doc/src/sgml/indices.sgml