On Fri, May 23, 2025 at 07:03:31PM +0300, Florents Tselai wrote:
> -

For the sake of the archives: this has been mentioned on Discord.

+++ b/src/include/catalog/pg_proc.dat
+# To find unused OIDs see src/include/catalog/unused_oids.
+# If multiple related OIDs are added, it is suggested they're contiguous.

This stuff is already documented in bki.sgml.  Adding an extra
location to hint about the script may be useful to have, but
pg_proc.dat is not a good choice as it is one catalog among many
others.  One idea: we could add a README or a README.oid in
src/include/catalog/ telling more about unused_oids, renumber_oids and
duplicate_oids, still it would be a duplication of what the
documentation already informs about.  Another idea could be just to 
provide a link redirecting to the "current" or "in-development" docs,
stored in a README in src/include/catalog/.

The issue seems to be the discoverability of these scripts for new
developers.  If others have ideas and/or opinions, feel free.
--
Michael

Attachment: signature.asc
Description: PGP signature

Reply via email to