From f3840b4b18603a90ce7949116d2429af83b3976f Mon Sep 17 00:00:00 2001
From: Ed Hartnett <edwardjameshartnett@gmail.com>
Date: Tue, 4 Jun 2019 15:25:52 -0600
Subject: [PATCH] documentation changes

---
 src/clib/pio.h      |  3 ++-
 src/clib/pio_spmd.c | 18 ++++++++++++++++++
 src/clib/pioc.c     | 20 +-------------------
 3 files changed, 21 insertions(+), 20 deletions(-)

diff --git a/src/clib/pio.h b/src/clib/pio.h
index 481898aa772..980dc60070d 100644
--- a/src/clib/pio.h
+++ b/src/clib/pio.h
@@ -840,7 +840,8 @@ extern "C" {
     int PIOc_Init_Intracomm(MPI_Comm comp_comm, int num_iotasks, int stride, int base, int rearr,
                             int *iosysidp);
 
-    /* Shut down an iosystem and free all associated resources. */
+    /** Shut down an iosystem and free all associated resources. Use
+     * PIOc_free_iosystem() instead. */
     int PIOc_finalize(int iosysid);
 
     /* Shut down an iosystem and free all associated resources. */
diff --git a/src/clib/pio_spmd.c b/src/clib/pio_spmd.c
index 59ccce7fc61..358ee1cd621 100644
--- a/src/clib/pio_spmd.c
+++ b/src/clib/pio_spmd.c
@@ -372,6 +372,24 @@ int pio_swapm(void *sendbuf, int *sendcounts, int *sdispls, MPI_Datatype *sendty
     return PIO_NOERR;
 }
 
+/**
+ * Clean up internal data structures, and free MPI resources,
+ * associated with an IOSystem. This is the old name for
+ * PIOc_free_iosystem(). This function is maintained for backward
+ * compatibility. Use PIOc_free_iosystem() for new code.
+ *
+ * @param iosysid: the io system ID provided by PIOc_Init_Intracomm()
+ * or PIOc_init_async().
+ * @returns 0 for success or non-zero for error.
+ * @ingroup PIO_finalize_c
+ * @author Jim Edwards, Ed Hartnett
+ */
+int
+PIOc_finalize(int iosysid)
+{
+    return PIOc_free_iosystem(iosysid);
+}
+
 /**
  * Provides the functionality of MPI_Gatherv with flow control
  * options. This function is not currently used, but we hope it will
diff --git a/src/clib/pioc.c b/src/clib/pioc.c
index ff67b6123e3..c5e21174702 100644
--- a/src/clib/pioc.c
+++ b/src/clib/pioc.c
@@ -1138,7 +1138,7 @@ PIOc_set_hint(int iosysid, const char *hint, const char *hintval)
  * or PIOc_init_async().
  * @returns 0 for success or non-zero for error.
  * @ingroup PIO_finalize_c
- * @author Ed Hartnett
+ * @author Jim Edwards, Ed Hartnett
  */
 int
 PIOc_free_iosystem(int iosysid)
@@ -1243,24 +1243,6 @@ PIOc_free_iosystem(int iosysid)
     return PIO_NOERR;
 }
 
-/**
- * Clean up internal data structures, and free MPI resources,
- * associated with an IOSystem. This is the old name for
- * PIOc_free_iosystem(). This function is maintained for backward
- * compatibility. Use PIOc_free_iosystem() for new code.
- *
- * @param iosysid: the io system ID provided by PIOc_Init_Intracomm()
- * or PIOc_init_async().
- * @returns 0 for success or non-zero for error.
- * @ingroup PIO_finalize_c
- * @author Jim Edwards, Ed Hartnett
- */
-int
-PIOc_finalize(int iosysid)
-{
-    return PIOc_free_iosystem(iosysid);
-}
-
 /**
  * Return a logical indicating whether this task is an IO task.
  *