Refine the guidelines for rmgrdesc authors.
commitc03c2eae0acbb82db8e626f71f367ef4b043d27d
authorPeter Geoghegan <pg@bowt.ie>
Tue, 11 Apr 2023 22:26:24 +0000 (11 15:26 -0700)
committerPeter Geoghegan <pg@bowt.ie>
Tue, 11 Apr 2023 22:26:24 +0000 (11 15:26 -0700)
tree131824756caa318ea8ed3b261678633638bea5d8
parent96149a180d56162b0288e8c8ec5ee2c1f076e88b
Refine the guidelines for rmgrdesc authors.

Clarify the goals of the recently added guidelines for rmgrdesc authors:
to avoid gratuitous inconsistencies across resource managers, and to
make it reasonably easy to write a reusable custom parser.

Beyond that, the guidelines leave rmgrdesc authors with a significant
amount of leeway.  This even includes the leeway to invent custom
conventions (in cases where it's warranted).

Follow-up to commit 7d8219a4.

Author: Peter Geoghegan <pg@bowt.ie>
Reviewed-By: Melanie Plageman <melanieplageman@gmail.com>
Discussion: https://postgr.es/m/CAH2-WzkbYuvwYKm-Y-72QEh6SPMQcAo9uONv+mR3bMGcu9E_Cg@mail.gmail.com
src/backend/access/rmgrdesc/rmgrdesc_utils.c
src/include/access/rmgrdesc_utils.h