Merge pull request #12028 from jsquyres/pr/v5.0.x/docs-enable-mca-dso-improvements

v5.0.x: docs: enable --enable-mca-dso description

Author: janjust

docs/installing-open-mpi/configure-cli-options/installation.rst

@@ -193,13 +193,16 @@ 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
   * ``btl-tcp`` specifies just the TCP component in the BTL framework
   * ``mtl,btl-tcp`` specifies the entire MTL framework and the TCP
-     component in the BTL framework
+    component in the BTL framework
 
   Open MPI's ``configure`` script uses the values of these two options
   when evaluating each component to determine how it should be built
@@ -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::