Upgrade MPIs on linux

linx64/mpi/mpich/share/man/man3/MPI_Keyval_create.3

@@ -1,30 +1,31 @@
-.TH MPI_Keyval_create 3 "6/5/2019" " " "MPI"
+.TH MPI_Keyval_create 3 "2/3/2025" " " "MPI"
 .SH NAME
-MPI_Keyval_create \-  Greates a new attribute key 
+MPI_Keyval_create \-  Creates a new attribute key 
 .SH SYNOPSIS
 .nf
-int MPI_Keyval_create(MPI_Copy_function * copy_fn,
-                      MPI_Delete_function * delete_fn, int *keyval, void *extra_state)
 .fi
+.nf
+int MPI_Keyval_create(MPI_Copy_function *copy_fn,
+MPI_Delete_function *delete_fn, int *keyval,
+void *extra_state)
+.fi
+
+
 .SH INPUT PARAMETERS
 .PD 0
 .TP
 .B copy_fn 
-- Copy callback function for 
-.I keyval
-
+- Copy callback function for keyval (function)
 .PD 1
 .PD 0
 .TP
 .B delete_fn 
-- Delete callback function for 
-.I keyval
-
+- Delete callback function for keyval (function)
 .PD 1
 .PD 0
 .TP
 .B extra_state 
-- Extra state for callback functions
+- Extra state for callback functions (None)
 .PD 1
 
 .SH OUTPUT PARAMETERS
@@ -34,15 +35,13 @@ int MPI_Keyval_create(MPI_Copy_function * copy_fn,
 - key value for future access (integer)
 .PD 1
 
-.SH NOTES
-Key values are global (available for any and all communicators).
+.SH DEPRECATED FUNCTION
+The current MPI standard defines this routine as deprecated. The routine may
+continue to be used, but new code should use the replacement routine.
+The replacement for this routine is 
+.I MPI_Comm_create_keyval
+\&.
 
-There are subtle differences between C and Fortran that require that the
-copy_fn be written in the same language that 
-.I MPI_Keyval_create
-is called from.
-This should not be a problem for most users; only programmers using both
-Fortran and C in the same program need to be sure that they follow this rule.
 
 .SH THREAD AND INTERRUPT SAFETY
 
@@ -53,16 +52,6 @@ this is due to the use of memory allocation routines such as
 .I malloc
 or other non-MPICH runtime routines that are themselves not interrupt-safe.
 
-.SH DEPRECATED FUNCTION
-The MPI-2 standard deprecated a number of routines because MPI-2 provides
-better versions.  This routine is one of those that was deprecated.  The
-routine may continue to be used, but new code should use the replacement
-routine.
-The replacement for this routine is 
-.I MPI_Comm_create_keyval
-\&.
-
-
 .SH NOTES FOR FORTRAN
 All MPI routines in Fortran (except for 
 .I MPI_WTIME
@@ -111,7 +100,7 @@ its use is deprecated.  The predefined error handler
 may be used to cause error values to be returned.
 Note that MPI does 
 .B not
-guarentee that an MPI program can continue past
+guarantee that an MPI program can continue past
 an error; however, MPI implementations will attempt to continue whenever
 possible.
 
@@ -122,18 +111,20 @@ possible.
 .PD 1
 .PD 0
 .TP
-.B MPI_ERR_INTERN 
-- This error is returned when some part of the MPICH 
-implementation is unable to acquire memory.  
-.PD 1
-.PD 0
-.TP
 .B MPI_ERR_ARG 
 - Invalid argument.  Some argument is invalid and is not
 identified by a specific error class (e.g., 
 .I MPI_ERR_RANK
 ).
 .PD 1
+.PD 0
+.TP
+.B MPI_ERR_OTHER 
+- Other error; use 
+.I MPI_Error_string
+to get more information
+about this error code. 
+.PD 1
 
 .SH SEE ALSO
 MPI_Keyval_free, MPI_Comm_create_keyval