pmix-standard
pmix-standard copied to clipboard
Provisionals introduced in v4.1 and v5.0 use different formatting
Overview
Provisional items introduced in v4.1 use a different formatting from those introduced in v5.0.
Motivation
\declaremacroProvisional{PMIX_PROC_INFO_STATIC_INIT}\versionMarker{5.0} vs \declaremacro{THISTHAT}\versionMarkerProvisional{4.1}
Discussion Items
- [x] review provisional items introduced in versions prior to v4.1 to identify what is the historical precedent (https://github.com/pmix/pmix-standard/issues/519#issuecomment-2657628579)
- [ ] PR a fix that makes them all look the same
- [ ] If the fix is to make them look like v5: synchronize with #518 (as we may elevate all v4.1 provisional to stable, leaving us with only a merge conflict and no substantial change)
We have used different formatting for provisionals in v4.1, v4.2, and v5.0, so there is not really a clear historical precedent to what style we prefer.
Propose to use both declareXYZprovisional and \versionmarkerProvisional going forward as it is more clear with both.
When elevated from provisional to stable, only remove the Provisional from the macro calls, don't change version first introduced.