more pr feedback

Signed-off-by: Howard Pritchard <howardp@lanl.gov>

Author: hppritcha

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

@@ -40,12 +40,12 @@ OUTPUT PARAMETERS
 -----------------
 * ``name``: Buffer to return the string containing the name of the event type.
 * ``verbosity``: Verbosity level of this event type
-* ``array_of_datatypes``:  Array of mpi basic datatypes used to encode the event data
+* ``array_of_datatypes``:  Array of MPI basic datatypes used to encode the event data
 * ``array_of_displacements``:  Array of byte displacements of the elements in the event buffer
 * ``enumtype``:  Optional descriptor for enumeration information
 * ``info``: Optional info argument.
 * ``desc``: Buffer to return the string containing the description of the event type.
-* ``bind``:  Type of mpi object to which an event of this type must be bound
+* ``bind``:  Type of MPI object to which an event of this type must be bound
 
 DESCRIPTION
 -----------

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

@@ -6,8 +6,7 @@ MPI_T_event_handle_alloc
 
 .. include_body
 
-:ref:`MPI_T_event_handle_alloc`, :ref:`MPI_T_event_handle_free` - Allocate/free
-event handles
+:ref:`MPI_T_event_handle_alloc` - Allocate event handles
 
 
 SYNTAX
@@ -21,11 +20,19 @@ C Syntax
 
    #include <mpi.h>
 
-   int MPI_T_event_handle_alloc(int event_index, void *obj_handle,
+   int MPI_T_event_handle_alloc(int event_index, void *obj_handle, MPI info,
                                 MPI_T_event_registration *event_registration)
 
-   int MPI_T_event_handle_free(MPI_T_event_registration event_registration,
-                               void *user_data, MPI_T_event_free_cb_function free_cb_function)
+INPUT PARAMETERS
+----------------
+* ``event_index``: Index of event type for which the registration handle is to be allocated.
+* ``obj_handle``: reference to a handle of the MPI object to which this event is supposed to be bound.
+* ``info``: Info object.
+
+OUTPUT PARAMETERS
+-----------------
+* ``event_registration``: Event registration.
+
 
 DESCRIPTION
 -----------
@@ -35,9 +42,6 @@ DESCRIPTION
 :ref:`MPI_T_event_get_info` returns MPI_T_BIND_NO_OBJECT as the binding of the
 variable the *obj_handle* argument is ignored.
 
-:ref:`MPI_T_event_handle_free` frees a handle allocated by
-:ref:`MPI_T_event_handle_alloc`.
-
 ERRORS
 ------
 

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

@@ -1,9 +1,50 @@
 .. _mpi_t_event_handle_free:
 
+
 MPI_T_event_handle_free
 =======================
-    .. include_body
 
-.. include:: ../man3/MPI_T_event_handle_alloc.3.rst
-    :start-after: .. include_body
+.. include_body
+
+:ref:`MPI_T_event_handle_free` - Free event handles
+
+
+SYNTAX
+------
+
+
+C Syntax
+^^^^^^^^
+
+.. code-block:: c
+
+   #include <mpi.h>
+
+   int MPI_T_event_handle_free(MPI_T_event_registration event_registration,
+                               void *user_data, MPI_T_event_free_cb_function free_cb_function)
+
+INPUT PARAMETERS
+----------------
+* ``user_data``: Pointer to a user-controlled buffer.
+* ``free_cb_function``: Pointer to user-defined callback function.
+
+INPUT/OUTPUT PARAMETERS
+-----------------------
+* ``event_registration``: Event registration.
+
+
+DESCRIPTION
+-----------
+
+:ref:`MPI_T_event_handle_free` frees a handle allocated by
+:ref:`MPI_T_event_handle_alloc`.
+
+ERRORS
+------
+
+:ref:`MPI_T_event_handle_free` will fail if:
+
+.. include:: ./MPI_T_ERRORS.rst
 
+.. seealso::
+   * :ref:`MPI_T_event_get_info`

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

@@ -27,7 +27,7 @@ INPUT PARAMETERS
 ----------------
 * ``event_instance``: event-instance handle provided to the callback function.
 * ``elem_index``: index into the array of datatypes of the item to be queried.
-* ``buf``: pointer to a memory location to store the item data
+* ``buffer``: pointer to a memory location to store the item data
 
 DESCRIPTION
 -----------

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

@@ -21,8 +21,8 @@ C Syntax
    #include <mpi.h>
 
    int MPI_T_source_get_info(int source_index, char *name, int *name_len,
-   char *desc, int *desc_len, MPI_T_source_order *ordering,
-   MPI_Count *ticks_per_second, MPI_Count *max_ticks, MPI_Info *info)
+                             char *desc, int *desc_len, MPI_T_source_order *ordering,
+                             MPI_Count *ticks_per_second, MPI_Count *max_ticks, MPI_Info *info)
 
 
 INPUT PARAMETERS