Doc: indexUnchanged is strictly a hint.
authorPeter Geoghegan <pg@bowt.ie>
Tue, 24 Oct 2023 16:27:21 +0000 (09:27 -0700)
committerPeter Geoghegan <pg@bowt.ie>
Tue, 24 Oct 2023 16:27:21 +0000 (09:27 -0700)
commitdf73ca35144a8711e42b82cd147ee34407553b3c
treebc7ec473acf8c76e479b3fca31fbd4b6611d6f5f
parent03e749c2b89e880e0a226458e9446fca4440696f
Doc: indexUnchanged is strictly a hint.

Clearly spell out the limitations of aminsert()'s indexUnchanged hinting
mechanism in the index AM documentation.

Oversight in commit 9dc718bd, which added the "logically unchanged
index" hint (which is used to trigger bottom-up index deletion).

Author: Peter Geoghegan <pg@bowt.ie>
Reported-By: Tom Lane <tgl@sss.pgh.pa.us>
Reviewed-By: Tom Lane <tgl@sss.pgh.pa.us>
Discussion: https://postgr.es/m/CAH2-WzmU_BQ=-H9L+bxTSMQBqHMjp1DSwGypvL0gKs+dTOfkKg@mail.gmail.com
Backpatch: 14-, where indexUnchanged hinting was introduced.
doc/src/sgml/indexam.sgml