Normalizes the public headers (#3292)

* Also brings over the apostrophe fix

11 files changed, 44 insertions, 44 deletions

diff --git a/fortran/src/H5Af.c b/fortran/src/H5Af.c
index 0fdd8fd..c17d3f8 100644
--- a/fortran/src/H5Af.c
+++ b/fortran/src/H5Af.c
@@ -284,7 +284,7 @@ done:
  *                          H5_ITER_NATIVE   - No particular order, whatever is fastest
  *                          H5_ITER_N	     - Number of iteration orders
  *
- *  n  - Attribute’s position in index
+ *  n  - Attribute's position in index
  *  attr_id  - Attribute identifier
  *  size  - Buffer size ! *TEST* check for 0 value *CHECK* should this return the correct value
  *
@@ -361,7 +361,7 @@ done:
  *
  *  corder_valid - Indicates whether the creation order data is valid for this attribute
  *  corder - Is a positive integer containing the creation order of the attribute
- *  cset - Indicates the character set used for the attribute’s name
+ *  cset - Indicates the character set used for the attribute's name
  *  data_size - indicates the size, in the number of characters, of the attribute
  *
  * RETURNS
@@ -423,13 +423,13 @@ done:
  *                          H5_ITER_NATIVE   - No particular order, whatever is fastest
  *                          H5_ITER_N	     - Number of iteration orders
  *
- *  n - Attribute’s position in index
+ *  n - Attribute's position in index
  *  lapl_id - Link access property list
  * OUTPUTS
  *
  *  corder_valid - Indicates whether the creation order data is valid for this attribute
  *  corder - Is a positive integer containing the creation order of the attribute
- *  cset - Indicates the character set used for the attribute’s name
+ *  cset - Indicates the character set used for the attribute's name
  *  data_size - indicates the size, in the number of characters, of the attribute
  *
  * RETURNS
@@ -495,7 +495,7 @@ done:
  *
  *  corder_valid - Indicates whether the creation order data is valid for this attribute
  *  corder - Is a positive integer containing the creation order of the attribute
- *  cset - Indicates the character set used for the attribute’s name
+ *  cset - Indicates the character set used for the attribute's name
  *  data_size - indicates the size, in the number of characters, of the attribute
  *
  * RETURNS
diff --git a/fortran/src/H5Aff.F90 b/fortran/src/H5Aff.F90
index b30044d..57e4bdb 100644
--- a/fortran/src/H5Aff.F90
+++ b/fortran/src/H5Aff.F90
@@ -457,7 +457,7 @@ CONTAINS
 !!                 \li H5_ITER_DEC_F       - Decreasing order
 !!                 \li H5_ITER_NATIVE_F    - No particular order, whatever is fastest
 !!                 \li H5_ITER_N_F         - Number of iteration orders
-!! \param n        Attribute’s position in index
+!! \param n        Attribute's position in index
 !! \param name     Attribute name
 !! \param hdferr   \fortran_error
 !!
@@ -688,7 +688,7 @@ CONTAINS
 !! \brief Gets an attribute creation property list identifier
 !!
 !! \param attr_id          Identifier of the attribute
-!! \param creation_prop_id Identifier for the attribute’s creation property
+!! \param creation_prop_id Identifier for the attribute's creation property
 !! \param hdferr           \fortran_error
 !!
 !! See C API: @ref H5Aget_create_plist()
@@ -1081,7 +1081,7 @@ CONTAINS
 !!                 \li H5_ITER_DEC_F       - Decreasing order
 !!                 \li H5_ITER_NATIVE_F    - No particular order, whatever is fastest
 !!                 \li H5_ITER_N_F         - Number of iteration orders
-!! \param n        Attribute’s position in index.
+!! \param n        Attribute's position in index.
 !! \param attr_id  Attribute identifier.
 !! \param hdferr   \fortran_error
 !! \param aapl_id  Attribute access property list.
@@ -1153,7 +1153,7 @@ CONTAINS
 !!                 \li H5_ITER_DEC_F       - Decreasing order
 !!                 \li H5_ITER_NATIVE_F    - No particular order, whatever is fastest
 !!                 \li H5_ITER_N_F         - Number of iteration orders
-!! \param n        Attribute’s position in index.
+!! \param n        Attribute's position in index.
 !! \param attr_id  Attribute identifier.
 !! \param es_id    \fortran_es_id
 !! \param hdferr   \fortran_error
@@ -1238,7 +1238,7 @@ CONTAINS
 !!                       NOTE: In C it is defined as a structure: H5A_info_t.
 !! \param f_corder_valid Indicates whether the creation order data is valid for this attribute.
 !! \param corder         Is a positive integer containing the creation order of the attribute.
-!! \param cset           Indicates the character set used for the attribute’s name.
+!! \param cset           Indicates the character set used for the attribute's name.
 !! \param data_size      Indicates the size, in the number of characters, of the attribute.
 !! \param hdferr         \fortran_error
 !!
@@ -1284,10 +1284,10 @@ CONTAINS
 !! \param obj_name       Name of object to which attribute is attached, relative to location
 !! \param idx_type       Type of index
 !! \param order          Index traversal order
-!! \param n              Attribute’s position in index
+!! \param n              Attribute's position in index
 !! \param f_corder_valid Indicates whether the creation order data is valid for this attribute
 !! \param corder         Is a positive integer containing the creation order of the attribute
-!! \param cset           Indicates the character set used for the attribute’s name
+!! \param cset           Indicates the character set used for the attribute's name
 !! \param data_size      Indicates the size, in the number of characters, of the attribute
 !! \param hdferr         \fortran_error
 !! \param lapl_id        Link access property list
@@ -1360,7 +1360,7 @@ CONTAINS
 !! \param attr_name      Attribute name
 !! \param f_corder_valid Indicates whether the creation order data is valid for this attribute
 !! \param corder         Is a positive integer containing the creation order of the attribute
-!! \param cset           Indicates the character set used for the attribute’s name
+!! \param cset           Indicates the character set used for the attribute's name
 !! \param data_size      Indicates the size, in the number of characters, of the attribute
 !! \param hdferr         \fortran_error
 !! \param lapl_id        Link access property list
@@ -1702,7 +1702,7 @@ CONTAINS
 !! \brief Determines whether an attribute with a given name exists on an object
 !!
 !! \param loc_id      Location identifier
-!! \param obj_name    Object name either relative to loc_id, absolute from the file’s root group, or '. '(a dot)
+!! \param obj_name    Object name either relative to loc_id, absolute from the file's root group, or '. '(a dot)
 !! \param attr_name   Attribute name
 !! \param attr_exists Attribute exists status
 !! \param hdferr      \fortran_error
@@ -1759,7 +1759,7 @@ CONTAINS
 !! \brief Asynchronously determines whether an attribute with a given name exists on an object
 !!
 !! \param loc_id      Location identifier
-!! \param obj_name    Object name either relative to loc_id, absolute from the file’s root group, or '. '(a dot)
+!! \param obj_name    Object name either relative to loc_id, absolute from the file's root group, or '. '(a dot)
 !! \param attr_name   Attribute name
 !! \param attr_exists Pointer to attribute exists status, must be of type LOGICAL(C_BOOL) and initialize to .FALSE.
 !! \param es_id       \fortran_es_id
@@ -1830,7 +1830,7 @@ CONTAINS
 !! \brief Opens an attribute for an object by object name and attribute name.
 !!
 !! \param loc_id    Location from which to find object to which attribute is attached
-!! \param obj_name  Object name either relative to loc_id, absolute from the file’s root group, or '.' (a dot)
+!! \param obj_name  Object name either relative to loc_id, absolute from the file's root group, or '.' (a dot)
 !! \param attr_name Attribute name
 !! \param attr_id   Attribute identifier
 !! \param hdferr    \fortran_error
@@ -1889,7 +1889,7 @@ CONTAINS
 !! \brief Asynchronously opens an attribute for an object by object name and attribute name.
 !!
 !! \param loc_id    Location from which to find object to which attribute is attached
-!! \param obj_name  Object name either relative to loc_id, absolute from the file’s root group, or '.' (a dot)
+!! \param obj_name  Object name either relative to loc_id, absolute from the file's root group, or '.' (a dot)
 !! \param attr_name Attribute name
 !! \param attr_id   Attribute identifier
 !! \param es_id     \fortran_es_id
diff --git a/fortran/src/H5Gff.F90 b/fortran/src/H5Gff.F90
index c8701a2..94a7285 100644
--- a/fortran/src/H5Gff.F90
+++ b/fortran/src/H5Gff.F90
@@ -1171,7 +1171,7 @@ CONTAINS
 !>
 !! \ingroup FH5G
 !!
-!! \brief Retrieves information about a group, according to the group’s position within an index.
+!! \brief Retrieves information about a group, according to the group's position within an index.
 !!
 !! \attention  \fortran_approved
 !!
@@ -1226,7 +1226,7 @@ CONTAINS
 !>
 !! \ingroup FH5G
 !!
-!! \brief Asynchronously retrieves information about a group, according to the group’s position within an index.
+!! \brief Asynchronously retrieves information about a group, according to the group's position within an index.
 !!
 !! \param loc_id     Location identifier. The identifier may be that of a file, group, dataset, named datatype, or attribute.
 !! \param group_name Name of group containing group for which information is to be retrieved.
@@ -1285,7 +1285,7 @@ CONTAINS
 !>
 !! \ingroup FH5G
 !!
-!! \brief Retrieves information about a group, according to the group’s position within an index.
+!! \brief Retrieves information about a group, according to the group's position within an index.
 !!
 !! \attention  \fortran_obsolete. Both nlinks and max_corder can overflow.
 !!
diff --git a/fortran/src/H5Lf.c b/fortran/src/H5Lf.c
index c7ce511..ffc1d3d 100644
--- a/fortran/src/H5Lf.c
+++ b/fortran/src/H5Lf.c
@@ -158,8 +158,8 @@ done:
  * OUTPUTS
  *
  *
- *  cset - indicates the character set used for link’s name.
- *  corder - specifies the link’s creation order position.
+ *  cset - indicates the character set used for link's name.
+ *  corder - specifies the link's creation order position.
  *  corder_valid - indicates whether the value in corder is valid.
  *  link_type -  specifies the link class:
  *     	                H5L_LINK_HARD_F      - Hard link
@@ -234,7 +234,7 @@ done:
  *
  *  corder_valid - Indicates whether the creation order data is valid for this attribute
  *  corder - Is a positive integer containing the creation order of the attribute
- *  cset - Indicates the character set used for the attribute’s name
+ *  cset - Indicates the character set used for the attribute's name
  *  data_size - indicates the size, in the number of characters, of the attribute
  *
  * RETURNS
diff --git a/fortran/src/H5Lff.F90 b/fortran/src/H5Lff.F90
index 72a471e..219ebec 100644
--- a/fortran/src/H5Lff.F90
+++ b/fortran/src/H5Lff.F90
@@ -833,8 +833,8 @@ CONTAINS
 !! \param link_loc_id File or group identifier.
 !! \param link_name   Name of the link for which information is being sought.
 !!                     NOTE: In C these are contained in the structure H5L_info_t
-!! \param cset         Indicates the character set used for link’s name.
-!! \param corder       Specifies the link’s creation order position.
+!! \param cset         Indicates the character set used for link's name.
+!! \param corder       Specifies the link's creation order position.
 !! \param f_corder_valid Indicates whether the value in corder is valid.
 !! \param link_type    Specifies the link class:
 !!                     \li H5L_TYPE_HARD_F     - Hard link
@@ -929,7 +929,7 @@ CONTAINS
 !!                       \li H5L_TYPE_ERROR _F    - Error
 !! \param f_corder_valid Indicates whether the creation order data is valid for this attribute.
 !! \param corder         Is a positive integer containing the creation order of the attribute.
-!! \param cset           Indicates the character set used for the attribute’s name.
+!! \param cset           Indicates the character set used for the attribute's name.
 !! \param token          If the link is a hard link, token specifies the object token that the link points to.
 !! \param val_size       If the link is a symbolic link, val_size will be the length of the link value, e.g.,
 !!                       the length of the name of the pointed-to object with a null terminator.
diff --git a/fortran/src/H5Of.c b/fortran/src/H5Of.c
index 54e5187..5abe745 100644
--- a/fortran/src/H5Of.c
+++ b/fortran/src/H5Of.c
@@ -139,7 +139,7 @@ done:
  *  Calls H5open_by_token
  * INPUTS
  *  loc_id - File or group identifier
- *  token  - Object’s token in the file
+ *  token  - Object's token in the file
  *
  * OUTPUTS
  *  obj_id  - Object identifier
diff --git a/fortran/src/H5Off.F90 b/fortran/src/H5Off.F90
index 54c503e..90e9990 100644
--- a/fortran/src/H5Off.F90
+++ b/fortran/src/H5Off.F90
@@ -406,7 +406,7 @@ CONTAINS
 !! \brief Opens an object using its token within an HDF5 file.
 !!
 !! \param loc_id File or group identifier.
-!! \param token  Object’s token in the file.
+!! \param token  Object's token in the file.
 !! \param obj_id Object identifier for the opened object.
 !! \param hdferr \fortran_error
 !!
diff --git a/fortran/src/H5Pff.F90 b/fortran/src/H5Pff.F90
index c6229f7..6be8337 100644
--- a/fortran/src/H5Pff.F90
+++ b/fortran/src/H5Pff.F90
@@ -5776,7 +5776,7 @@ SUBROUTINE h5pset_attr_phase_change_f(ocpl_id, max_compact, min_dense, hdferr)
 !!                      unlimited selection.
 !! \param src_file_name The name of the HDF5 file where the source dataset is located.
 !! \param src_dset_name The path to the HDF5 dataset in the file specified by src_file_name.
-!! \param src_space_id  The source dataset’s dataspace identifier with a selection applied, possibly an unlimited selection.
+!! \param src_space_id  The source dataset's dataspace identifier with a selection applied, possibly an unlimited selection.
 !! \param hdferr        \fortran_error
 !!
 !! See C API: @ref H5Pset_virtual()
diff --git a/fortran/src/H5Tff.F90 b/fortran/src/H5Tff.F90
index 29550b7..08ee51d 100644
--- a/fortran/src/H5Tff.F90
+++ b/fortran/src/H5Tff.F90
@@ -1954,7 +1954,7 @@ CONTAINS
 !>
 !! \ingroup FH5T
 !!
-!! \brief Check whether the library’s default conversion is hard conversion.
+!! \brief Check whether the library's default conversion is hard conversion.
 !!
 !! \param src_id Identifier for the source datatype.
 !! \param dst_id Identifier for the destination datatype.
diff --git a/fortran/test/tH5A_1_8.F90 b/fortran/test/tH5A_1_8.F90
index 03e26ec..17d152b 100644
--- a/fortran/test/tH5A_1_8.F90
+++ b/fortran/test/tH5A_1_8.F90
@@ -236,7 +236,7 @@ SUBROUTINE test_attr_corder_create_compact(fcpl,fapl, total_error)
 
   LOGICAL :: f_corder_valid ! Indicates whether the creation order data is valid for this attribute
   INTEGER :: corder ! Is a positive integer containing the creation order of the attribute
-  INTEGER :: cset ! Indicates the character set used for the attribute’s name
+  INTEGER :: cset ! Indicates the character set used for the attribute's name
   INTEGER(HSIZE_T) :: data_size   ! indicates the size, in the number of characters
 
   data_dims = 0
@@ -413,7 +413,7 @@ SUBROUTINE test_attr_null_space(fcpl, fapl, total_error)
 
   LOGICAL :: f_corder_valid ! Indicates whether the creation order data is valid for this attribute
   INTEGER :: corder ! Is a positive integer containing the creation order of the attribute
-  INTEGER :: cset ! Indicates the character set used for the attribute’s name
+  INTEGER :: cset ! Indicates the character set used for the attribute's name
   INTEGER(HSIZE_T) :: data_size   ! indicates the size, in the number of characters
 
   LOGICAL :: equal
@@ -755,7 +755,7 @@ SUBROUTINE test_attr_info_by_idx(new_format, fcpl, fapl, total_error)
 
   LOGICAL :: f_corder_valid ! Indicates whether the creation order data is valid for this attribute
   INTEGER :: corder ! Is a positive integer containing the creation order of the attribute
-  INTEGER :: cset ! Indicates the character set used for the attribute’s name
+  INTEGER :: cset ! Indicates the character set used for the attribute's name
   INTEGER(HSIZE_T) :: data_size   ! indicates the size, in the number of characters
   INTEGER(HSIZE_T) :: n
   LOGICAL, DIMENSION(1:2) :: use_index = (/.FALSE.,.TRUE./)
@@ -936,7 +936,7 @@ SUBROUTINE attr_info_by_idx_check(obj_id, attrname, n, use_index, total_error )
   LOGICAL :: use_index
   LOGICAL :: f_corder_valid ! Indicates whether the creation order data is valid for this attribute
   INTEGER :: corder ! Is a positive integer containing the creation order of the attribute
-  INTEGER :: cset ! Indicates the character set used for the attribute’s name
+  INTEGER :: cset ! Indicates the character set used for the attribute's name
   INTEGER(HSIZE_T) :: data_size   ! indicates the size, in the number of characters
 
   INTEGER(SIZE_T) :: NAME_BUF_SIZE = 7
@@ -1399,7 +1399,7 @@ SUBROUTINE test_attr_delete_by_idx(new_format, fcpl, fapl, total_error)
 
   LOGICAL :: f_corder_valid ! Indicates whether the creation order data is valid for this attribute
   INTEGER :: corder ! Is a positive integer containing the creation order of the attribute
-  INTEGER :: cset ! Indicates the character set used for the attribute’s name
+  INTEGER :: cset ! Indicates the character set used for the attribute's name
   INTEGER(HSIZE_T) :: data_size   ! indicates the size, in the number of characters
   LOGICAL, DIMENSION(1:2) :: use_index = (/.FALSE.,.TRUE./)
 
@@ -2692,7 +2692,7 @@ SUBROUTINE attr_open_check(fid, dsetname, obj_id, max_attrs, total_error )
   INTEGER :: error
   LOGICAL :: f_corder_valid ! Indicates whether the creation order data is valid for this attribute
   INTEGER :: corder ! Is a positive integer containing the creation order of the attribute
-  INTEGER :: cset ! Indicates the character set used for the attribute’s name
+  INTEGER :: cset ! Indicates the character set used for the attribute's name
   INTEGER(HSIZE_T) :: data_size   ! indicates the size, in the number of characters
 
   INTEGER(HSIZE_T) :: storage_size   ! attributes storage requirements
diff --git a/fortran/test/tH5G_1_8.F90 b/fortran/test/tH5G_1_8.F90
index 9444619..1764c08 100644
--- a/fortran/test/tH5G_1_8.F90
+++ b/fortran/test/tH5G_1_8.F90
@@ -764,8 +764,8 @@ END SUBROUTINE group_info
      INTEGER ::   arank = 1                      ! Attribute rank
      INTEGER :: error
 
-     INTEGER :: cset ! Indicates the character set used for the link’s name.
-     INTEGER :: corder ! Specifies the link’s creation order position.
+     INTEGER :: cset ! Indicates the character set used for the link's name.
+     INTEGER :: corder ! Specifies the link's creation order position.
      LOGICAL :: f_corder_valid ! Indicates whether the value in corder is valid.
      INTEGER :: link_type ! Specifies the link class:
                           !  H5L_TYPE_HARD_F      - Hard link
@@ -867,8 +867,8 @@ END SUBROUTINE group_info
     INTEGER :: crt_order_flags !  Status of creation order info for GCPL
     CHARACTER(LEN=12), PARAMETER :: filename = 'TestLinks.h5'
 
-    INTEGER :: cset ! Indicates the character set used for the link’s name.
-    INTEGER :: corder ! Specifies the link’s creation order position.
+    INTEGER :: cset ! Indicates the character set used for the link's name.
+    INTEGER :: corder ! Specifies the link's creation order position.
     LOGICAL :: f_corder_valid ! Indicates whether the value in corder is valid.
     INTEGER :: link_type ! Specifies the link class:
                          !  H5L_TYPE_HARD_F      - Hard link
@@ -1281,7 +1281,7 @@ SUBROUTINE delete_by_idx(cleanup, fapl, total_error)
 
   LOGICAL :: f_corder_valid ! Indicates whether the creation order data is valid for this attribute
   INTEGER :: corder ! Is a positive integer containing the creation order of the attribute
-  INTEGER :: cset ! Indicates the character set used for the attribute’s name
+  INTEGER :: cset ! Indicates the character set used for the attribute's name
   INTEGER(SIZE_T) :: val_size
   INTEGER :: link_type
   TYPE(H5O_TOKEN_T_F) :: token
@@ -1510,7 +1510,7 @@ SUBROUTINE link_info_by_idx_check(group_id, linkname, n, &
 
   LOGICAL :: f_corder_valid ! Indicates whether the creation order data is valid for this attribute
   INTEGER :: corder ! Is a positive integer containing the creation order of the attribute
-  INTEGER :: cset ! Indicates the character set used for the attribute’s name
+  INTEGER :: cset ! Indicates the character set used for the attribute's name
   INTEGER :: link_type
   TYPE(H5O_TOKEN_T_F) :: token
   INTEGER(SIZE_T) :: val_size   ! Indicates the size, in the number of characters, of the attribute
@@ -1611,8 +1611,8 @@ SUBROUTINE link_info_by_idx_check(group_id, linkname, n, &
   INTEGER(HID_T) :: type_id
   INTEGER(HID_T) :: lcpl_id
 
-  INTEGER :: cset ! Indicates the character set used for the link’s name.
-  INTEGER :: corder ! Specifies the link’s creation order position.
+  INTEGER :: cset ! Indicates the character set used for the link's name.
+  INTEGER :: corder ! Specifies the link's creation order position.
   LOGICAL :: f_corder_valid ! Indicates whether the value in corder is valid.
   INTEGER :: link_type ! Specifies the link class:
                        !  H5L_TYPE_HARD_F      - Hard link