doc: improved ERRORS.rst

Listified the elements and ensured links were
properly set.

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

Author: zerothi

docs/man-openmpi/man3/ERRORS.rst

@@ -6,42 +6,47 @@ with the communication object (e.g., communicator, window, file) is called.
 If no communication object is associated with the MPI call, then the call is
 considered attached to MPI_COMM_SELF and will call the associated MPI error
 handler. When MPI_COMM_SELF is not initialized (i.e., before
-MPI_INIT / MPI_INIT_THREAD, after MPI_FINALIZE, or when using the Sessions
+:ref:`MPI_Init`/:ref:`MPI_Init_thread`, after :ref:`MPI_Finalize`, or when using the Sessions
 Model exclusively) the error raises the initial error handler. The initial
-error handler can be changed by calling MPI_COMM_SET_ERRHANDLER on
+error handler can be changed by calling :ref:`MPI_Comm_set_errhandler` on
 MPI_COMM_SELF when using the World model, or the mpi_initial_errhandler CLI
-argument to mpiexec or info key to MPI_COMM_SPAWN[_MULTIPLE].
+argument to mpiexec or info key to :ref:`MPI_Comm_spawn`/:ref:`MPI_Comm_spawn_multiple`.
 If no other appropriate error handler has been set, then the MPI_ERRORS_RETURN
 error handler is called for MPI I/O functions and the MPI_ERRORS_ABORT error
 handler is called for all other MPI functions.
 
-In the sessions model, the error handler can be set during MPI_Session_init.
+In the sessions model, the error handler can be set during :ref:`MPI_Session_init`.
 
-Open MPI includes three predefined error handlers that can be used::
+Open MPI includes three predefined error handlers that can be used:
 
- MPI_ERRORS_ARE_FATAL: Causes the program to abort all connected MPI processes.
- MPI_ERRORS_ABORT:     An error handler that can be invoked on a communicator,
-                       window, file, or session. When called on a communicator, it
-                       acts as if MPI_ABORT was called on that communicator. If
-                       called on a window or file, acts as if MPI_ABORT was called
-                       on a communicator containing the group of processes in the
-                       corresponding window or file. If called on a session,
-                       aborts only the local process.
- MPI_ERRORS_RETURN:    Returns an error code to the application.
+* ``MPI_ERRORS_ARE_FATAL``
+  Causes the program to abort all connected MPI processes.
+* ``MPI_ERRORS_ABORT``
+  An error handler that can be invoked on a communicator,
+  window, file, or session. When called on a communicator, it
+  acts as if :ref:`MPI_Abort` was called on that communicator. If
+  called on a window or file, acts as if :ref:`MPI_Abort` was called
+  on a communicator containing the group of processes in the
+  corresponding window or file. If called on a session,
+  aborts only the local process.
+* ``MPI_ERRORS_RETURN``
+  Returns an error code to the application.
 
 MPI applications can also implement their own error handlers.
 
 Custom MPI error handlers can be created by calling:
-:ref:`MPI_Comm_create_errhandler(3) <MPI_Comm_create_errhandler>`
-:ref:`MPI_File_create_errhandler(3) <MPI_File_create_errhandler>`
-:ref:`MPI_Session_create_errhandler(3) <MPI_Session_create_errhandler>`
-:ref:`MPI_Win_create_errhandler(3) <MPI_Win_create_errhandler>`
+
+* :ref:`MPI_Comm_create_errhandler`
+* :ref:`MPI_File_create_errhandler`
+* :ref:`MPI_Session_create_errhandler`
+* :ref:`MPI_Win_create_errhandler`
 
 Predefined and custom error handlers can be set by calling:
-:ref:`MPI_Comm_set_errhandler(3) <MPI_Comm_set_errhandler>`
-:ref:`MPI_File_set_errhandler(3) <MPI_File_set_errhandler>`
-:ref:`MPI_Session_set_errhandler(3) <MPI_Session_set_errhandler>`
-:ref:`MPI_Win_set_errhandler(3) <MPI_Win_set_errhandler>`
+
+* :ref:`MPI_Comm_set_errhandler`
+* :ref:`MPI_File_set_errhandler`
+* :ref:`MPI_Session_set_errhandler`
+* :ref:`MPI_Win_set_errhandler`
 
 Note that MPI does not guarantee that an MPI program can continue past
 an error.