squashme suggestions for MPI_T_events man pages

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

Author: jsquyres

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

@@ -6,7 +6,7 @@ MPI_T_source_get_num
 
 .. include_body
 
-:ref:`MPI_T_source_get_num` |mdash| Query the number of sources
+:ref:`MPI_T_source_get_num` |mdash| Query the number of MPI_T event sources
 
 
 SYNTAX
@@ -25,18 +25,33 @@ C Syntax
 
 OUTPUT PARAMETERS
 -----------------
+
 * ``num_sources``: Current number of sources
 
+
 DESCRIPTION
 -----------
 
 :ref:`MPI_T_source_get_num` can be used to query the current number of
-sources.
+MPI_T event sources.
+
+The number of available event sources can be queried with a call to
+:ref:`MPI_T_Source_get_num`. An MPI implementation is allowed to
+increase the number of sources during the execution of an MPI
+process. However, MPI implementations are not allowed to change the
+index of an event source or to delete an event source once it has been
+made visible to the user (e.g., if new event sources become available
+via dynamic loading of additional components in the MPI
+implementation).
+
+.. note:: Open MPI will currently return that there are 0 sources of
+          MPI_T events.
 
 
 ERRORS
 ------
 
 :ref:`MPI_T_source_get_num` will fail if:
 
-* ``MPI_T_ERR_NOT_INITIALIZED``: The MPI Tools interface not initialized
+* ``MPI_T_ERR_NOT_INITIALIZED``: The MPI Tools interface is not
+  initialized