pmix-standard icon indicating copy to clipboard operation
pmix-standard copied to clipboard

Provisionals introduced in v4.1 and v5.0 use different formatting

Open abouteiller opened this issue 11 months ago • 1 comments

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}

Image

Image

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)

abouteiller avatar Feb 13 '25 18:02 abouteiller

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.

abouteiller avatar Feb 13 '25 20:02 abouteiller