summaryrefslogtreecommitdiffstats
path: root/doxygen/dox/H5Literate.dox
blob: 4d3a8dcc0206b8bca5b8c2a50a0e5a18a9a0528b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
/**
 * \ingroup TRAV
 * \def H5Literate()
 * H5Literate() is a macro that is mapped to either H5Literate1() or
 * H5Literate2() Such macros are provided to facilitate application
 * compatibility. Their use and mappings are fully described in
 * Compatibility Macros in HDF5. If the library and/or application is
 * compiled for Release 1.12 emulation, H5Literate() will be mapped to
 * H5Literate2() and H5Literate1() is deprecated. With earlier versions,
 * H5Literate() is mapped to H5Literate1(). Specific compile-time compatibility
 * flags and the resulting mappings are as follows:
 * \li No compatibility flag: H5Literate2() (using 1.12 source) H5Literate1()
 *     (using 1.10 or 1.8 source)
 * \li Emulate Release 1.12: H5Literate2()
 * \li Emulate Release 1.8 or 1.10 interface: H5Literate1()
 *
 *  \todo Fix the reference.
 *
 * \version 1.12.0 The function H5Literate() was renamed to H5Literate1() and
 *          deprecated in this release. The macro H5Literate() and the
 *          function H5Literate2() were introduced in this release.
 */