docs: fix rendering of MPI standards versions

RST apparently does not render |foo|.|bar| properly.  Specifically:
the "foo" macro will render properly, but the "bar" macro will not.

As such, split the MPI standard version into three macros so that we
don't have to render MPI's major and minor versions in the pattern
that RST will not render correctly.

Also add a cross reference from MPI_Get_version.3 to the release notes
where we talk about Open MPI's MPI conformance.

Signed-off-by: Jeff Squyres <[email protected]>

Author: jsquyres

docs/conf.py

@@ -52,8 +52,8 @@
 autoconf_min_version = f"{ompi_data['autoconf_min_version']}"
 libtool_min_version = f"{ompi_data['libtool_min_version']}"
 flex_min_version = f"{ompi_data['flex_min_version']}"
-mpi_standard_version = f"{ompi_data['mpi_standard_version']}"
-mpi_standard_subversion = f"{ompi_data['mpi_standard_subversion']}"
+mpi_standard_major_version = f"{ompi_data['mpi_standard_version']}"
+mpi_standard_minor_version = f"{ompi_data['mpi_standard_subversion']}"
 
 # "release" is a sphinx config variable: assign it to the computed
 # Open MPI version number.  The ompi_ver string begins with a "v"; the
@@ -219,8 +219,9 @@ def _doit(topdir):
 .. |autoconf_min_version| replace:: {autoconf_min_version}
 .. |libtool_min_version| replace:: {libtool_min_version}
 .. |flex_min_version| replace:: {flex_min_version}
-.. |mpi_standard_version| replace:: {mpi_standard_version}
-.. |mpi_standard_subversion| replace:: {mpi_standard_subversion}
+.. |mpi_standard_version| replace:: {mpi_standard_major_version}.{mpi_standard_minor_version}
+.. |mpi_standard_major_version| replace:: {mpi_standard_major_version}
+.. |mpi_standard_minor_version| replace:: {mpi_standard_minor_version}
 .. |deprecated_favor| replace:: this routine is deprecated in favor of
 
 """

docs/man-openmpi/man3/MPI_Get_version.3.rst

@@ -54,8 +54,11 @@ OUTPUT PARAMETERS
 DESCRIPTION
 -----------
 
-Since Open MPI is MPI-|mpi_standard_version|.|mpi_standard_subversion| compliant, this function will return a
-``version`` value of |mpi_standard_version| and a subversion value of |mpi_standard_subversion| for this release.
+Since Open MPI |ompi_ver| is MPI-|mpi_standard_version| compliant (see
+:ref:`this page for more details about Open MPI standards conformance
+<mpi-standard-conformance-label>`) this function will return a
+``version`` value of |mpi_standard_major_version| and a ``subversion``
+value of |mpi_standard_minor_version| for this release.
 
 NOTE
 ----

docs/man-openmpi/man7/Open-MPI.7.rst

@@ -24,7 +24,7 @@ portable.
 
 The outcome, known as the MPI Standard, was first published in 1993; its
 most recent version (MPI-4.0) was published in June 2021. Open MPI
-includes all MPI |mpi_standard_version|.|mpi_standard_subversion|-compliant routines.
+includes all MPI |mpi_standard_version|-compliant routines.
 
 For more information about Open MPI, see https://www.open-mpi.org.
 

docs/release-notes/mpi.rst

@@ -1,6 +1,8 @@
 MPI Functionality and Features
 ==============================
 
+.. _mpi-standard-conformance-label:
+
 MPI Standard conformance
 ------------------------