Skip to content

gdal.h: add constants for standard metadata domain names and items names#14697

Open
rouault wants to merge 21 commits into
OSGeo:masterfrom
rouault:GDAL_MDD
Open

gdal.h: add constants for standard metadata domain names and items names#14697
rouault wants to merge 21 commits into
OSGeo:masterfrom
rouault:GDAL_MDD

Conversation

@rouault
Copy link
Copy Markdown
Member

@rouault rouault commented Jun 1, 2026

This should make them more discoverable for users, and limit the risk of typos in our code base (or users' ones)

@rouault rouault added this to the 3.14.0 milestone Jun 1, 2026
@rouault rouault added the funded through GSP Work funded through the GDAL Sponsorship Program label Jun 1, 2026
@rouault rouault force-pushed the GDAL_MDD branch 2 times, most recently from 2f6df4d to 21f142f Compare June 1, 2026 01:26
@rouault
Copy link
Copy Markdown
Member Author

rouault commented Jun 1, 2026

@dbaston Question regarding naming. Before this PR, we already had a in gdal.h GDALMD_AREA_OR_POINT, GDALMD_AOP_AREA, GDALMD_AOP_POINT for metadata item names and values. I find it a bit unfortunate there's no underscore between GDAL and MD. But I've followed that pattern for other metadata item names (GDALMD_INTERLEAVE, etc.)
For metadata domains for which we have no precedent, I've opted for GDAL_MDD_<domain_name>

Otherwise, a potential alternative would be to add new aliases GDAL_MD_ for the 3 existining GDALMD_ , deprecate those older versions, and use GDAL_MD_ for new values

Thoughts ?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

funded through GSP Work funded through the GDAL Sponsorship Program

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant