Doc: clean up verify_heapam() documentation.
authorTom Lane <tgl@sss.pgh.pa.us>
Wed, 28 Oct 2020 20:31:40 +0000 (16:31 -0400)
committerTom Lane <tgl@sss.pgh.pa.us>
Wed, 28 Oct 2020 20:31:40 +0000 (16:31 -0400)
commit4c49d8fc15eeb1dc69b0ddb2d986a1884a5d7f5f
tree30e5ac7414534dc738c6e8f0823b449f422e2107
parent66f8687a8ff867f656de81e367314604d29dbd59
Doc: clean up verify_heapam() documentation.

I started with the intention of just suppressing a PDF build warning
by removing the example output, but ended up doing more: correcting
factual errors in the function's signature, moving a bunch of
generalized handwaving into the "Using amcheck Effectively" section
which seemed a better place for it, and improving wording and markup
a little bit.

Discussion: https://postgr.es/m/732904.1603728748@sss.pgh.pa.us
doc/src/sgml/amcheck.sgml