Update high level vacuumlazy.c comments.
authorPeter Geoghegan <pg@bowt.ie>
Sat, 27 Nov 2021 22:29:43 +0000 (14:29 -0800)
committerPeter Geoghegan <pg@bowt.ie>
Sat, 27 Nov 2021 22:29:43 +0000 (14:29 -0800)
commit12b5ade9023f3ecaddcbc423a22dc284c91c79f6
treedd31ccfc889328a122fc1c53703994c5dd72a65c
parentf744519326e1ce4774d0966f7848601a8327eeaa
Update high level vacuumlazy.c comments.

Update vacuumlazy.c file header comments (as well as comments above the
lazy_scan_heap function) that were largely written before the
introduction of the HOT optimization, when lazy_scan_heap did far less,
and didn't actually prune during its initial heap pass.

Since lazy_scan_heap now outsources far more work to lower level
functions, it makes sense to introduce the function by talking about the
high level invariant that dictates the order in which each phase takes
place.  Also deemphasize the case where we run out of memory for TIDs,
since delaying that discussion makes it easier to talk about issues of
central importance.

Finally, remove discussion of parallel VACUUM from header comments.
These don't add much, and are in the wrong place.
src/backend/access/heap/vacuumlazy.c