docs: clarify --enable-mca-dso

Add explicit text statting that --enable-mca-dso (with no LIST/argument value) will build *all* components as DSO. Signed-off-by: Jeff Squyres <[email protected]>
open-mpi · Oct 27, 2023 · cd4f1b9 · cd4f1b9
1 parent f659906
commit cd4f1b9
Showing 1 changed file with 9 additions and 2 deletions.
diff --git a/docs/installing-open-mpi/configure-cli-options/installation.rst b/docs/installing-open-mpi/configure-cli-options/installation.rst
@@ -193,7 +193,10 @@ be used with ``configure``:
   options, but have no impact on the selection logic described below.
   Only affirmative options change the selection process.
 
-  ``LIST`` is a comma-delimited list of Open MPI frameworks and/or
+  If ``LIST`` is not specified (e.g., ``--enable-mca-dso`` with no
+  ``LIST``), or if ``LIST`` is the special value ``yes``, then *all*
+  components will be selected.  If ``LIST`` is specified, it is a
+  comma-delimited list of Open MPI frameworks and/or
   framework+component tuples.  Examples:
 
   * ``btl`` specifies the entire BTL framework
@@ -213,7 +216,7 @@ be used with ``configure``:
   #. Otherwise, ``configure`` uses the global default build behavior.
 
   At each level of the selection process, if the component is
-  specified to be built as both a static and dso component, the static
+  specified to be built as both a static and DSO component, the static
   option will win.
 
   .. note:: As of Open MPI |ompi_ver|, ``configure``'s global default
@@ -234,6 +237,10 @@ be used with ``configure``:
 
         shell$ ./configure
 
+  #. Build all components as DSOs::
+
+        shell$ ./configure --enable-mca-dso
+
   #. Build all components as static, except the TCP BTL, which will be
      built as a DSO::