Improve programmer docs for simplehash and dynahash.

Thomas Munro <tmunro@postgresql.org>

Commit: 84c0e4b9bce794da914fe9c062753bf21369745f
Author: Thomas Munro <tmunro@postgresql.org>
Date: 2020-08-01T00:16:15Z
Releases: 14.0
Improve programmer docs for simplehash and dynahash.

When reading the code it's not obvious when one should prefer dynahash
over simplehash and vice-versa, so, for programmer-friendliness, add
comments to inform that decision.

Show sample simplehash method signatures.

Author: James Coleman <jtc331@gmail.com>
Discussion: https://postgr.es/m/CAAaqYe_dOF39gAJ8rL-a3YO3Qo96MHMRQ2whFjK5ZcU6YvMQSA%40mail.gmail.com

Files

PathChange+/−
src/backend/utils/hash/dynahash.c modified +11 −1
src/include/lib/simplehash.h modified +69 −4

Discussion