doc: more cleaning of references

Also removed mentioning of some C++ bindings. It seemed
weird to only have them in the *create_errhandler documents,
hence removed.

Signed-off-by: Nick Papior <nickpapior@gmail.com>

Author: zerothi

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

@@ -48,11 +48,10 @@ Fortran 2008 Syntax
 Deprecated Type Name Note
 -------------------------
 
-MPI-2.2 deprecated the MPI_Comm_errhandler_fn and
-``MPI::Comm::Errhandler_fn`` types in favor of
-MPI_Comm_errhandler_function and ``MPI::Comm::Errhandler_function``,
-respectively. Open MPI supports both names (indeed, the \_fn names are
-typedefs to the \_function names).
+MPI-2.2 deprecated the ``MPI_Comm_errhandler_fn`` type in favor of
+``MPI_Comm_errhandler_function``.
+Open MPI supports both names (indeed, the ``_fn`` names are
+typedefs to the ``_function`` names).
 
 INPUT PARAMETER
 ---------------
@@ -72,7 +71,7 @@ DESCRIPTION
 attached to communicators. This ``function`` is identical to
 :ref:`MPI_Errhandler_create`, the use of which is deprecated. In C, the
 user routine should be a ``function`` of type
-MPI_Comm_errhandler_function, which is defined as
+``MPI_Comm_errhandler_function``, which is defined as
 
 .. code-block:: c
 

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

@@ -38,10 +38,12 @@ Fortran Syntax
 
 INPUT PARAMETER
 ---------------
+
 * ``function``: User-defined error handling procedure.
 
 OUTPUT PARAMETERS
 -----------------
+
 * ``errhandler``: MPI error handler (handle).
 * ``ierror``: Fortran only: Error status (integer).
 
@@ -76,7 +78,7 @@ NOTE
 
 The MPI-1 Standard states that an implementation may make the output
 value (errhandler) simply the address of the function. However, the
-action of MPI_Errhandler\_ free makes this impossible, since it is
+action of :ref:`MPI_Errhandler_free` makes this impossible, since it is
 required to set the value of the argument to MPI_ERRHANDLER_NULL. In
 addition, the actual error handler must remain until all communicators
 that use it are freed.

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

@@ -52,36 +52,35 @@ Fortran 2008 Syntax
 DEPRECATED TYPE NAME NOTE
 -------------------------
 
-MPI-2.2 deprecated the MPI_File_errhandler_fn and
-MPI::file::Errhandler_fn types in favor of MPI_File_errhandler_function
-and MPI::File::Errhandler_function, respectively. Open MPI supports both
-names (indeed, the \_fn names are typedefs to the \_function names).
+MPI-2.2 deprecated the ``MPI_File_errhandler_fn`` type in favor of
+``MPI_File_errhandler_function``. Open MPI supports both
+names (indeed, the ``_fn`` names are typedefs to the ``_function`` names).
 
 
 INPUT PARAMETER
 ---------------
+
 * ``function``: User-defined error handling procedure (function).
 
 OUTPUT PARAMETERS
 -----------------
+
 * ``errhandler``: MPI error handler (handle).
 * ``ierror``: Fortran only: Error status (integer).
 
 DESCRIPTION
 -----------
 
-Registers the user routine *function* for use as an MPI error handler.
-Returns in errhandler a handle to the registered error handler.
+:ref:`MPI_Comm_create_errhandler` creates an error handler that can be
+attached to file operations. In C, the
+user routine should be a ``function`` of type
+``MPI_File_errhandler_function``, which is defined as
 
-In the C language, the user routine *function* should be a C function of
-type MPI_File_errhandler_function, which is defined as
-
-::
+.. code-block:: c
 
-       typedef void (MPI_File_errhandler_function)(MPI_File *, int *,
-       ...);
+       typedef void (MPI_File_errhandler_function)(MPI_File *, int *, ...);
 
-The first argument to *function* is the file in use. The second is the
+The first argument is the file in use. The second is the
 error code to be returned by the MPI routine that raised the error.
 
 In the Fortran language, the user routine should be of the form:

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

@@ -63,7 +63,7 @@ DESCRIPTION
 attached to sessions. This ``function`` is identical to
 :ref:`MPI_Errhandler_create`, the use of which is deprecated. In C, the
 user routine should be a ``function`` of type
-MPI_Session_errhandler_function, which is defined as
+``MPI_Session_errhandler_function``, which is defined as
 
 .. code-block:: c
 

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

@@ -51,28 +51,29 @@ Fortran 2008 Syntax
 DEPRECATED TYPE NAME NOTE
 -------------------------
 
-MPI-2.2 deprecated the MPI_Win_errhandler_fn and MPI::Win::Errhandler_fn
-types in favor of MPI_Win_errhandler_function and
-MPI::Win::Errhandler_function, respectively. Open MPI supports both
-names (indeed, the \_fn names are typedefs to the \_function names).
+MPI-2.2 deprecated the ``MPI_Win_errhandler_fn`` type in favor of
+``MPI_Win_errhandler_function``. Open MPI supports both
+names (indeed, the ``_fn`` names are typedefs to the ``_function`` names).
 
 
 INPUT PARAMETER
 ---------------
+
 * ``function``: User-defined error-handling procedure (function).
 
 OUTPUT PARAMETERS
 -----------------
+
 * ``errhandler``: MPI error handler (handle).
 * ``ierror``: Fortran only: Error status (integer).
 
 DESCRIPTION
 -----------
 
 :ref:`MPI_Win_create_errhandler` should be, in C, a function of type
-MPI_Win_errhandler_function, which is defined as
+``MPI_Win_errhandler_function``, which is defined as
 
-::
+.. code-block:: c
 
    typedef void MPI_Win_errhandler_function(MPI Win *, int *, ...);