pgsql: Refine the guidelines for rmgrdesc authors.

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: /messages/by-id/CAH2-WzkbYuvwYKm-Y-72QEh6SPMQcAo9uONv+mR3bMGcu9E_Cg@mail.gmail.com

Branch
------
master

Details
-------
https://git.postgresql.org/pg/commitdiff/c03c2eae0acbb82db8e626f71f367ef4b043d27d

Modified Files
--------------
src/backend/access/rmgrdesc/rmgrdesc_utils.c | 20 -------------
src/include/access/rmgrdesc_utils.h | 44 ++++++++++++++++++++++++++++
2 files changed, 44 insertions(+), 20 deletions(-)