Cleanup language about MPI exceptions --> errors

MPI-4 is finally cleaning up its language: an MPI "exception" does not
actually exist.  The only thing that exists is an MPI "error" (and
associated handlers).  This commit replaces all relevant uses of the
word "exception" with "error".  Note that this is still applicable in
versions of the MPI standard less than MPI-4.0 (indeed, nearly all the
cases fixed in this commit are just changes to comments, anyway).

One exception to this is the Java bindings, where there's an
MPIException class.  In hindsight, it probably should have been named
MPIError, but changing it now would break anyone who is using the Java
bindings.

Signed-off-by: Jeff Squyres <jsquyres@cisco.com>

Author: jsquyres

ompi/communicator/comm_init.c

@@ -419,7 +419,7 @@ static void ompi_comm_destruct(ompi_communicator_t* comm)
        from one communicator to another and we end up destroying the
        new communication while propagating the error up the stack.  We
        want to make it all the way up the stack to invoke the MPI
-       exception, not cause a seg fault in pml_del_comm because it was
+       error, not cause a seg fault in pml_del_comm because it was
        never pml_add_com'ed. */
 
     if ( MPI_COMM_NULL != comm && OMPI_COMM_IS_PML_ADDED(comm) ) {

ompi/errhandler/errhandler.h

@@ -381,7 +381,7 @@ struct ompi_request_t;
    *
    * @returns err_code The same value as the parameter
    *
-   * This function invokes the MPI exception function on the error
+   * This function invokes the MPI error function on the error
    * handler.  If the errhandler was created from fortran, the error
    * handler will be invoked with fortran linkage.  Otherwise, it is
    * invoked with C linkage.
@@ -394,7 +394,7 @@ struct ompi_request_t;
 
 
   /**
-   * Invoke an MPI exception on the first request found in the array
+   * Invoke an MPI error on the first request found in the array
    * that has a non-MPI_SUCCESS value for MPI_ERROR in its status.  It
    * is safe to invoke this function if none of the requests have an
    * outstanding error; MPI_SUCCESS will be returned.

ompi/errhandler/errhandler_invoke.c

@@ -141,7 +141,7 @@ int ompi_errhandler_request_invoke(int count,
     ompi_mpi_object_t mpi_object;
 
     /* Find the *first* request that has an error -- that's the one
-       that we'll invoke the exception on.  In an error condition, the
+       that we'll invoke the error on.  In an error condition, the
        request will not have been reset back to MPI_REQUEST_NULL, so
        there's no need to cache values from before we call
        ompi_request_test(). */
@@ -162,18 +162,18 @@ int ompi_errhandler_request_invoke(int count,
 
     /* Since errors on requests cause them to not be freed (until we
        can examine them here), go through and free all requests with
-       errors.  We only invoke the exception on the *first* request
+       errors.  We only invoke the error on the *first* request
        that had an error. */
     for (; i < count; ++i) {
         if (MPI_REQUEST_NULL != requests[i] &&
             MPI_SUCCESS != requests[i]->req_status.MPI_ERROR) {
             /* Ignore the error -- what are we going to do?  We're
-               already going to invoke an exception */
+               already going to invoke an error */
             ompi_request_free(&(requests[i]));
         }
     }
 
-    /* Invoke the exception */
+    /* Invoke the error */
     switch (type) {
     case OMPI_REQUEST_PML:
     case OMPI_REQUEST_COLL:

ompi/mca/io/base/io_base_find_available.c

@@ -53,7 +53,7 @@ static int init_query_2_0_0(const mca_base_component_t *ls,
  * and destroy the opened list.
  *
  * It is *not* an error if there are no io components available.
- * Appropriate run-time MPI exceptions will be invoked during
+ * Appropriate run-time MPI errors will be invoked during
  * MPI_FILE_OPEN and MPI_FILE_DELETE.
  */
 int mca_io_base_find_available(bool enable_progress_threads,

ompi/mpi/c/errhandler_free.c

@@ -44,7 +44,7 @@ int MPI_Errhandler_free(MPI_Errhandler *errhandler)
 
   if (MPI_PARAM_CHECK) {
     OMPI_ERR_INIT_FINALIZE(FUNC_NAME);
-    /* Raise an MPI exception if we got NULL or if we got an intrinsic
+    /* Raise an MPI error if we got NULL or if we got an intrinsic
        *and* the reference count is 1 (meaning that this FREE would
        actually free the underlying intrinsic object).  This is ugly
        but necessary -- see below. */

ompi/mpi/java/java/CartComm.java

@@ -92,7 +92,7 @@ protected CartComm(long[] commRequest)
 	 * Duplicates this communicator.
 	 * <p>Java binding of {@code MPI_COMM_DUP}.
 	 * @return copy of this communicator
-	 * @throws MPIException Signals that an MPI exception of some sort has occurred.
+	 * @throws MPIException Signals that an MPI error of some sort has occurred.
 	 */
 	@Override public CartComm dup() throws MPIException
 	{
@@ -106,7 +106,7 @@ protected CartComm(long[] commRequest)
 	 * <p>The new communicator can't be used before the operation completes.
 	 * The request object must be obtained calling {@link #getRequest}.
 	 * @return copy of this communicator
-	 * @throws MPIException Signals that an MPI exception of some sort has occurred. Signals that an MPI exception of some sort has occurred.
+	 * @throws MPIException Signals that an MPI error of some sort has occurred. Signals that an MPI exception of some sort has occurred.
 	 */
 	@Override public CartComm iDup() throws MPIException
 	{
@@ -119,7 +119,7 @@ protected CartComm(long[] commRequest)
 	* <p>Java binding of {@code MPI_COMM_DUP_WITH_INFO}.
 	* @param info	info object to associate with the new communicator
 	* @return copy of this communicator
-	* @throws MPIException Signals that an MPI exception of some sort has occurred.
+	* @throws MPIException Signals that an MPI error of some sort has occurred.
 	*/
 	@Override public CartComm dupWithInfo(Info info) throws MPIException
 	{
@@ -134,7 +134,7 @@ protected CartComm(long[] commRequest)
 	 * <p>The number of dimensions can be obtained from the size of (eg)
 	 * {@code dims} field of the returned object.
 	 * @return object containing dimensions, periods and local coordinates
-	 * @throws MPIException Signals that an MPI exception of some sort has occurred.
+	 * @throws MPIException Signals that an MPI error of some sort has occurred.
 	 */
 	public CartParms getTopo() throws MPIException
 	{
@@ -149,7 +149,7 @@ public CartParms getTopo() throws MPIException
 	 * <p>Java binding of the MPI operation {@code MPI_CART_RANK}.
 	 * @param coords Cartesian coordinates of a process
 	 * @return rank of the specified process
-	 * @throws MPIException Signals that an MPI exception of some sort has occurred.
+	 * @throws MPIException Signals that an MPI error of some sort has occurred.
 	 */
 	public int getRank(int[] coords) throws MPIException
 	{
@@ -164,7 +164,7 @@ public int getRank(int[] coords) throws MPIException
 	 * <p>Java binding of the MPI operation {@code MPI_CART_COORDS}.
 	 * @param rank rank of a process
 	 * @return Cartesian coordinates of the specified process
-	 * @throws MPIException Signals that an MPI exception of some sort has occurred.
+	 * @throws MPIException Signals that an MPI error of some sort has occurred.
 	 */
 	public int[] getCoords(int rank) throws MPIException
 	{
@@ -180,7 +180,7 @@ public int[] getCoords(int rank) throws MPIException
 	 * @param direction coordinate dimension of shift
 	 * @param disp      displacement
 	 * @return object containing ranks of source and destination processes
-	 * @throws MPIException Signals that an MPI exception of some sort has occurred.
+	 * @throws MPIException Signals that an MPI error of some sort has occurred.
 	 */
 	public ShiftParms shift(int direction, int disp) throws MPIException
 	{
@@ -197,7 +197,7 @@ private native ShiftParms shift(long comm, int direction, int disp)
 	 * @param remainDims by dimension, {@code true} if dimension is to be kept,
 	 *                   {@code false} otherwise
 	 * @return communicator containing subgrid including this process
-	 * @throws MPIException Signals that an MPI exception of some sort has occurred.
+	 * @throws MPIException Signals that an MPI error of some sort has occurred.
 	 */
 	public CartComm sub(boolean[] remainDims) throws MPIException
 	{
@@ -215,7 +215,7 @@ public CartComm sub(boolean[] remainDims) throws MPIException
 	 * @param periods {@code true} if grid is periodic,
 	 *                {@code false} if not, in each dimension
 	 * @return reordered rank of calling process
-	 * @throws MPIException Signals that an MPI exception of some sort has occurred.
+	 * @throws MPIException Signals that an MPI error of some sort has occurred.
 	 */
 	public int map(int[] dims, boolean[] periods) throws MPIException
 	{
@@ -231,7 +231,7 @@ private native int map(long comm, int[] dims, boolean[] periods)
 	 * <p>Java binding of the MPI operation {@code MPI_DIMS_CREATE}.
 	 * @param nnodes number of nodes in a grid
 	 * @param dims   array specifying the number of nodes in each dimension
-	 * @throws MPIException Signals that an MPI exception of some sort has occurred.
+	 * @throws MPIException Signals that an MPI error of some sort has occurred.
 	 */
 	public static void createDims(int nnodes, int[] dims) throws MPIException
 	{