Hi Kyotaro, Thanks a lot for your careful review and clear explanation of the community convention.
>Some enum-valued options accept boolean-style representations that are
>not mentioned in the documentation. In some cases this is simply an
>implementation detail, while in others it is provided as a convenience
>or for consistency with existing conventions.
Following your lead, I checked guc_tables.c and its corresponding official
documentation for GUC parameters, and noticed that OFF is commonly
documented as a valid enum/configuration option in many existing entries.
>Even so, if we do decide to mention it, the proposed wording feels a
>bit heavy to me. Something like "SERIALIZE NONE (or OFF)" would
>probably be sufficient.
So I fully agree with your suggestion to use minimal wording rather than
a separate explanatory paragraph. I will revise the docs to simply write
NONE (or OFF) as you proposed.
The patch has been recompiled, and the updated HTML documentation
and man 7 manual pages have been regenerated and verified.
regards,
--
ZizhuanLiu (X-MAN)
[email protected]
v2-0001-DOCS-Mention-OFF-as-an-alias-for-EXPLAIN-SERIALIZ.patch
Description: Binary data
sql-explain.html
Description: Binary data
EXPLAIN.7
Description: Binary data
