NetCDF  4.9.2
RELEASE_NOTES.md
1 Release Notes {#RELEASE_NOTES}
2 =============
3 
4 \brief Release notes file for the netcdf-c package.
5 
6 This file contains a high-level description of this package's evolution. Releases are in reverse chronological order (most recent first). Note that, as of netcdf 4.2, the `netcdf-c++` and `netcdf-fortran` libraries have been separated into their own libraries.
7 
8 ## 4.9.3 - TBD
9 
10 ## 4.9.2 - March 14, 2023
11 
12 This is the maintenance release which adds support for HDF5 version 1.14.0, in addition to a handful of other changes and bugfixes.
13 
14 * Fix 'make distcheck' error in run_interop.sh. See [Github #????](https://github.com/Unidata/netcdf-c/pull/????).
15 * Update `nc-config` to remove inclusion from automatically-detected `nf-config` and `ncxx-config` files, as the wrong files could be included in the output. This is in support of [GitHub #2274](https://github.com/Unidata/netcdf-c/issues/2274).
16 * Update H5FDhttp.[ch] to work with HDF5 version 1.13.2 and later. See [Github #2635](https://github.com/Unidata/netcdf-c/pull/2635).
17 * [Bug Fix] Update DAP code to enable CURLOPT_ACCEPT_ENCODING by default. See [Github #2630](https://github.com/Unidata/netcdf-c/pull/2630).
18 * [Bug Fix] Fix byterange failures for certain URLs. See [Github #2649](https://github.com/Unidata/netcdf-c/pull/2649).
19 * [Bug Fix] Fix 'make distcheck' error in run_interop.sh. See [Github #2631](https://github.com/Unidata/netcdf-c/pull/2631).
20 * [Enhancement] Update `nc-config` to remove inclusion from automatically-detected `nf-config` and `ncxx-config` files, as the wrong files could be included in the output. This is in support of [GitHub #2274](https://github.com/Unidata/netcdf-c/issues/2274).
21 * [Enhancement] Update H5FDhttp.[ch] to work with HDF5 version 1.14.0. See [Github #2615](https://github.com/Unidata/netcdf-c/pull/2615).
22 
23 ## 4.9.1 - February 2, 2023
24 
25 ## Known Issues
26 
27 * A test in the `main` branch of `netcdf-cxx4` is broken by this rc; this will bear further investigation, but not being treated as a roadblock for the release candidate.
28 * The new document, `netcdf-c/docs/filter_quickstart.md` is in rough-draft form.
29 * Race conditions exist in some of the tests when run concurrently with large numbers of processors
30 
31 ## What's Changed from v4.9.0 (automatically generated)
32 
33 * Fix nc_def_var_fletcher32 operation by \@DennisHeimbigner in https://github.com/Unidata/netcdf-c/pull/2403
34 * Merge relevant info updates back into `main` by \@WardF in https://github.com/Unidata/netcdf-c/pull/2387
35 * Add manual GitHub actions triggers for the tests. by \@WardF in https://github.com/Unidata/netcdf-c/pull/2404
36 * Use env variable USERPROFILE instead of HOME for windows and mingw. by \@DennisHeimbigner in https://github.com/Unidata/netcdf-c/pull/2405
37 * Make public a limited API for programmatic access to internal .rc tables by \@DennisHeimbigner in https://github.com/Unidata/netcdf-c/pull/2408
38 * Fix typo in CMakeLists.txt by \@georgthegreat in https://github.com/Unidata/netcdf-c/pull/2412
39 * Fix choice of HOME dir by \@DennisHeimbigner in https://github.com/Unidata/netcdf-c/pull/2416
40 * Check for libxml2 development files by \@WardF in https://github.com/Unidata/netcdf-c/pull/2417
41 * Updating Doxyfile.in with doxygen-1.8.17, turned on WARN_AS_ERROR, added doxygen build to CI run by \@edwardhartnett in https://github.com/Unidata/netcdf-c/pull/2377
42 * updated release notes by \@edwardhartnett in https://github.com/Unidata/netcdf-c/pull/2392
43 * increase read block size from 1 KB to 4 MB by \@wkliao in https://github.com/Unidata/netcdf-c/pull/2319
44 * fixed RELEASE_NOTES.md by \@edwardhartnett in https://github.com/Unidata/netcdf-c/pull/2423
45 * Fix pnetcdf tests in cmake by \@WardF in https://github.com/Unidata/netcdf-c/pull/2437
46 * Updated CMakeLists to avoid corner case cmake error by \@WardF in https://github.com/Unidata/netcdf-c/pull/2438
47 * Add `--disable-quantize` to configure by \@WardF in https://github.com/Unidata/netcdf-c/pull/2439
48 * Fix the way CMake handles -DPLUGIN_INSTALL_DIR by \@DennisHeimbigner in https://github.com/Unidata/netcdf-c/pull/2430
49 * fix and test quantize mode for NC_CLASSIC_MODEL by \@edwardhartnett in https://github.com/Unidata/netcdf-c/pull/2445
50 * Guard _declspec(dllexport) in support of #2446 by \@WardF in https://github.com/Unidata/netcdf-c/pull/2460
51 * Ensure that netcdf_json.h does not interfere with ncjson. by \@DennisHeimbigner in https://github.com/Unidata/netcdf-c/pull/2448
52 * Prevent cmake writing to source dir by \@magnusuMET in https://github.com/Unidata/netcdf-c/pull/2463
53 * more quantize testing and adding pre-processor constant NC_MAX_FILENAME to nc_tests.h by \@edwardhartnett in https://github.com/Unidata/netcdf-c/pull/2457
54 * Provide a default enum const when fill value does not match any enum constant by \@DennisHeimbigner in https://github.com/Unidata/netcdf-c/pull/2462
55 * Fix support for reading arrays of HDF5 fixed size strings by \@DennisHeimbigner in https://github.com/Unidata/netcdf-c/pull/2466
56 * fix musl build by \@magnusuMET in https://github.com/Unidata/netcdf-c/pull/1701
57 * Fix AWS SDK linking errors by \@dzenanz in https://github.com/Unidata/netcdf-c/pull/2470
58 * Address jump-misses-init issue. by \@WardF in https://github.com/Unidata/netcdf-c/pull/2488
59 * Remove stray merge conflict markers by \@WardF in https://github.com/Unidata/netcdf-c/pull/2493
60 * Add support for Zarr string type to NCZarr by \@DennisHeimbigner in https://github.com/Unidata/netcdf-c/pull/2492
61 * Fix some problems with PR 2492 by \@DennisHeimbigner in https://github.com/Unidata/netcdf-c/pull/2497
62 * Fix some bugs in the blosc filter wrapper by \@DennisHeimbigner in https://github.com/Unidata/netcdf-c/pull/2461
63 * Add option to control accessing external servers by \@DennisHeimbigner in https://github.com/Unidata/netcdf-c/pull/2491
64 * Changed attribute case in documentation by \@WardF in https://github.com/Unidata/netcdf-c/pull/2482
65 * Adding all-error-codes.md back in to distribution documentation. by \@WardF in https://github.com/Unidata/netcdf-c/pull/2501
66 * Update hdf5 version in github actions. by \@WardF in https://github.com/Unidata/netcdf-c/pull/2504
67 * Minor update to doxygen function documentation by \@gsjaardema in https://github.com/Unidata/netcdf-c/pull/2451
68 * Fix some addtional errors in NCZarr by \@DennisHeimbigner in https://github.com/Unidata/netcdf-c/pull/2503
69 * Cleanup szip handling some more by \@DennisHeimbigner in https://github.com/Unidata/netcdf-c/pull/2421
70 * Check for zstd development headers in autotools by \@WardF in https://github.com/Unidata/netcdf-c/pull/2507
71 * Add new options to nc-config by \@WardF in https://github.com/Unidata/netcdf-c/pull/2509
72 * Cleanup built test sources in nczarr_test by \@DennisHeimbigner in https://github.com/Unidata/netcdf-c/pull/2508
73 * Fix inconsistency in netcdf_meta.h by \@WardF in https://github.com/Unidata/netcdf-c/pull/2512
74 * Small fix in nc-config.in by \@WardF in https://github.com/Unidata/netcdf-c/pull/2513
75 * For loop initial declarations are only allowed in C99 mode by \@gsjaardema in https://github.com/Unidata/netcdf-c/pull/2517
76 * Fix some dependencies in tst_nccopy3 by \@WardF in https://github.com/Unidata/netcdf-c/pull/2518
77 * Update plugins/Makefile.am by \@WardF in https://github.com/Unidata/netcdf-c/pull/2519
78 * Fix prereqs in ncdump/tst_nccopy4 in order to avoid race conditions. by \@WardF in https://github.com/Unidata/netcdf-c/pull/2520
79 * Move construction of VERSION file to end of the build by \@DennisHeimbigner in https://github.com/Unidata/netcdf-c/pull/2527
80 * Add draft filter quickstart guide by \@WardF in https://github.com/Unidata/netcdf-c/pull/2531
81 * Turn off extraneous debug output by \@DennisHeimbigner in https://github.com/Unidata/netcdf-c/pull/2537
82 * typo fix by \@wkliao in https://github.com/Unidata/netcdf-c/pull/2538
83 * replace 4194304 with READ_BLOCK_SIZE by \@wkliao in https://github.com/Unidata/netcdf-c/pull/2539
84 * Rename variable to avoid function name conflict by \@ibaned in https://github.com/Unidata/netcdf-c/pull/2550
85 * Add Cygwin CI and stop installing unwanted plugins by \@DWesl in https://github.com/Unidata/netcdf-c/pull/2529
86 * Merge subset of v4.9.1 files back into main development branch by \@WardF in https://github.com/Unidata/netcdf-c/pull/2530
87 * Add a Filter quickstart guide document by \@WardF in https://github.com/Unidata/netcdf-c/pull/2524
88 * Fix race condition in ncdump (and other) tests. by \@DennisHeimbigner in https://github.com/Unidata/netcdf-c/pull/2552
89 * Make dap4 reference dap instead of hard-wired to be disabled. by \@WardF in https://github.com/Unidata/netcdf-c/pull/2553
90 * Suppress nczarr_test/tst_unknown filter test by \@DennisHeimbigner in https://github.com/Unidata/netcdf-c/pull/2557
91 * Add fenceposting for HAVE_DECL_ISINF and HAVE_DECL_ISNAN by \@WardF in https://github.com/Unidata/netcdf-c/pull/2559
92 * Add an old static file. by \@WardF in https://github.com/Unidata/netcdf-c/pull/2575
93 * Fix infinite loop in file inferencing by \@DennisHeimbigner in https://github.com/Unidata/netcdf-c/pull/2574
94 * Merge Wellspring back into development branch by \@WardF in https://github.com/Unidata/netcdf-c/pull/2560
95 * Allow ncdump -t to handle variable length string attributes by \@srherbener in https://github.com/Unidata/netcdf-c/pull/2584
96 * Fix an issue I introduced with make distcheck by \@WardF in https://github.com/Unidata/netcdf-c/pull/2590
97 * make UDF0 not require NC_NETCDF4 by \@jedwards4b in https://github.com/Unidata/netcdf-c/pull/2586
98 * Expose user-facing documentation related to byterange DAP functionality. by \@WardF in https://github.com/Unidata/netcdf-c/pull/2596
99 * Fix Memory Leak by \@DennisHeimbigner in https://github.com/Unidata/netcdf-c/pull/2598
100 * CI: Change autotools CI build to out-of-tree build. by \@DWesl in https://github.com/Unidata/netcdf-c/pull/2577
101 * Update github action configuration scripts. by \@WardF in https://github.com/Unidata/netcdf-c/pull/2600
102 * Update the filter quickstart guide. by \@WardF in https://github.com/Unidata/netcdf-c/pull/2602
103 * Fix symbol export on Windows by \@WardF in https://github.com/Unidata/netcdf-c/pull/2604
104 
105 ## New Contributors
106 * \@georgthegreat made their first contribution in https://github.com/Unidata/netcdf-c/pull/2412
107 * \@dzenanz made their first contribution in https://github.com/Unidata/netcdf-c/pull/2470
108 * \@DWesl made their first contribution in https://github.com/Unidata/netcdf-c/pull/2529
109 * \@srherbener made their first contribution in https://github.com/Unidata/netcdf-c/pull/2584
110 * \@jedwards4b made their first contribution in https://github.com/Unidata/netcdf-c/pull/2586
111 
112 **Full Changelog**: https://github.com/Unidata/netcdf-c/compare/v4.9.0...v4.9.1
113 
114 ### 4.9.1 - Release Candidate 2 - November 21, 2022
115 
116 #### Known Issues
117 
118 * A test in the `main` branch of `netcdf-cxx4` is broken by this rc; this will bear further investigation, but not being treated as a roadblock for the release candidate.
119 * The new document, `netcdf-c/docs/filter_quickstart.md` is in rough-draft form.
120 
121 #### Changes
122 
123 * [Bug Fix] Fix a race condition when testing missing filters. See [Github #2557](https://github.com/Unidata/netcdf-c/pull/2557).
124 * [Bug Fix] Fix some race conditions due to use of a common file in multiple shell scripts . See [Github #2552](https://github.com/Unidata/netcdf-c/pull/2552).
125 
126 
127 ### 4.9.1 - Release Candidate 1 - October 24, 2022
128 
129 * [Enhancement][Documentation] Add Plugins Quick Start Guide. See [GitHub #2524](https://github.com/Unidata/netcdf-c/pull/2524) for more information.
130 * [Enhancement] Add new entries in `netcdf_meta.h`, `NC_HAS_BLOSC` and `NC_HAS_BZ2`. See [Github #2511](https://github.com/Unidata/netcdf-c/issues/2511) and [Github #2512](https://github.com/Unidata/netcdf-c/issues/2512) for more information.
131 * [Enhancement] Add new options to `nc-config`: `--has-multifilters`, `--has-stdfilters`, `--has-quantize`, `--plugindir`. See [Github #2509](https://github.com/Unidata/netcdf-c/pull/2509) for more information.
132 * [Bug Fix] Fix some errors detected in PR 2497. [PR #2497](https://github.com/Unidata/netcdf-c/pull/2497) . See [Github #2503](https://github.com/Unidata/netcdf-c/pull/2503).
133 * [Bug Fix] Split the remote tests into two parts: one for the remotetest server and one for all other external servers. Also add a configure option to enable the latter set. See [Github #2491](https://github.com/Unidata/netcdf-c/pull/2491).
134 * [Bug Fix] Fix blosc plugin errors. See [Github #2461](https://github.com/Unidata/netcdf-c/pull/2461).
135 * [Bug Fix] Fix support for reading arrays of HDF5 fixed size strings. See [Github #2466](https://github.com/Unidata/netcdf-c/pull/2466).
136 * [Bug Fix] Fix some errors detected in [PR #2492](https://github.com/Unidata/netcdf-c/pull/2492) . See [Github #2497](https://github.com/Unidata/netcdf-c/pull/2497).
137 * [Enhancement] Add support for Zarr (fixed length) string type in nczarr. See [Github #2492](https://github.com/Unidata/netcdf-c/pull/2492).
138 * [Bug Fix] Split the remote tests into two parts: one for the remotetest server and one for all other external servers. Also add a configure option to enable the latter set. See [Github #2491](https://github.com/Unidata/netcdf-c/pull/2491).
139 * [Bug Fix] Fix support for reading arrays of HDF5 fixed size strings. See [Github #2462](https://github.com/Unidata/netcdf-c/pull/2466).
140 * [Bug Fix] Provide a default enum const when fill value does not match any enum constant for the value zero. See [Github #2462](https://github.com/Unidata/netcdf-c/pull/2462).
141 * [Bug Fix] Fix the json submodule symbol conflicts between libnetcdf and the plugin specific netcdf_json.h. See [Github #2448](https://github.com/Unidata/netcdf-c/pull/2448).
142 * [Bug Fix] Fix quantize with CLASSIC_MODEL files. See [Github #2405](https://github.com/Unidata/netcdf-c/pull/2445).
143 * [Enhancement] Add `--disable-quantize` option to `configure`.
144 * [Bug Fix] Fix CMakeLists.txt to handle all acceptable boolean values for -DPLUGIN_INSTALL_DIR. See [Github #2430](https://github.com/Unidata/netcdf-c/pull/2430).
145 * [Bug Fix] Fix tst_vars3.c to use the proper szip flag. See [Github #2421](https://github.com/Unidata/netcdf-c/pull/2421).
146 * [Enhancement] Provide a simple API to allow user access to the internal .rc file table: supports get/set/overwrite of entries of the form "key=value". See [Github #2408](https://github.com/Unidata/netcdf-c/pull/2408).
147 * [Bug Fix] Use env variable USERPROFILE instead of HOME for windows and mingw. See [Github #2405](https://github.com/Unidata/netcdf-c/pull/2405).
148 * [Bug Fix] Fix the nc_def_var_fletcher32 code in hdf5 to properly test value of the fletcher32 argument. See [Github #2403](https://github.com/Unidata/netcdf-c/pull/2403).
149 
150 ## 4.9.0 - June 10, 2022
151 
152 * [Enhancement] Add quantize functions nc_def_var_quantize() and nc_inq_var_quantize() to enable lossy compression. See [Github #1548](https://github.com/Unidata/netcdf-c/pull/1548).
153 * [Enhancement] Add zstandard compression functions nc_def_var_zstandard() and nc_inq_var_zstandard(). See [Github #2173](https://github.com/Unidata/netcdf-c/issues/2173).
154 * [Enhancement] Have netCDF-4 logging output one file per processor when used with parallel I/O. See [Github #1762](https://github.com/Unidata/netcdf-c/issues/1762).
155 * [Enhancement] Improve filter installation process to avoid use of an extra shell script. See [Github #2348](https://github.com/Unidata/netcdf-c/pull/2348).
156 * [Bug Fix] Get "make distcheck" to work See [Github #2343](https://github.com/Unidata/netcdf-c/pull/2343).
157 * [Enhancement] Allow the read/write of JSON-valued Zarr attributes to allow
158 for domain specific info such as used by GDAL/Zarr. See [Github #2278](https://github.com/Unidata/netcdf-c/pull/2278).
159 * [Enhancement] Turn on the XArray convention for NCZarr files by default. WARNING, this means that the mode should explicitly specify "nczarr" or "zarr" even if "xarray" or "noxarray" is specified. See [Github #2257](https://github.com/Unidata/netcdf-c/pull/2257).
160 * [Enhancement] Update the documentation to match the current filter capabilities See [Github #2249](https://github.com/Unidata/netcdf-c/pull/2249).
161 * [Enhancement] Update the documentation to match the current filter capabilities. See [Github #2249](https://github.com/Unidata/netcdf-c/pull/2249).
162 * [Enhancement] Support installation of pre-built standard filters into user-specified location. See [Github #2318](https://github.com/Unidata/netcdf-c/pull/2318).
163 * [Enhancement] Improve filter support. More specifically (1) add nc_inq_filter_avail to check if a filter is available, (2) add the notion of standard filters, (3) cleanup szip support to fix interaction with NCZarr. See [Github #2245](https://github.com/Unidata/netcdf-c/pull/2245).
164 * [Enhancement] Switch to tinyxml2 as the default xml parser implementation. See [Github #2170](https://github.com/Unidata/netcdf-c/pull/2170).
165 * [Bug Fix] Require that the type of the variable in nc_def_var_filter is not variable length. See [Github #/2231](https://github.com/Unidata/netcdf-c/pull/2231).
166 * [File Change] Apply HDF5 v1.8 format compatibility when writing to previous files, as well as when creating new files. The superblock version remains at 2 for newly created files. Full backward read/write compatibility for netCDF-4 is maintained in all cases. See [Github #2176](https://github.com/Unidata/netcdf-c/issues/2176).
167 * [Enhancement] Add ability to set dataset alignment for netcdf-4/HDF5 files. See [Github #2206](https://github.com/Unidata/netcdf-c/pull/2206).
168 * [Bug Fix] Improve UTF8 support on windows so that it can use utf8 natively. See [Github #2222](https://github.com/Unidata/netcdf-c/pull/2222).
169 * [Enhancement] Add complete bitgroom support to NCZarr. See [Github #2197](https://github.com/Unidata/netcdf-c/pull/2197).
170 * [Bug Fix] Clean up the handling of deeply nested VLEN types. Marks nc_free_vlen() and nc_free_string as deprecated in favor of ncaux_reclaim_data(). See [Github #2179](https://github.com/Unidata/netcdf-c/pull/2179).
171 * [Bug Fix] Make sure that netcdf.h accurately defines the flags in the open/create mode flags. See [Github #2183](https://github.com/Unidata/netcdf-c/pull/2183).
172 * [Enhancement] Improve support for msys2+mingw platform. See [Github #2171](https://github.com/Unidata/netcdf-c/pull/2171).
173 * [Bug Fix] Clean up the various inter-test dependencies in ncdump for CMake. See [Github #2168](https://github.com/Unidata/netcdf-c/pull/2168).
174 * [Bug Fix] Fix use of non-aws appliances. See [Github #2152](https://github.com/Unidata/netcdf-c/pull/2152).
175 * [Enhancement] Added options to suppress the new behavior from [Github #2135](https://github.com/Unidata/netcdf-c/pull/2135). The options for `cmake` and `configure` are, respectively `-DENABLE_LIBXML2` and `--(enable/disable)-libxml2`. Both of these options defaul to 'on/enabled'. When disabled, the bundled `ezxml` XML interpreter is used regardless of whether `libxml2` is present on the system.
176 * [Enhancement] Support optional use of libxml2, otherwise default to ezxml. See [Github #2135](https://github.com/Unidata/netcdf-c/pull/2135) -- H/T to [Egbert Eich](https://github.com/e4t).
177 * [Bug Fix] Fix several os related errors. See [Github #2138](https://github.com/Unidata/netcdf-c/pull/2138).
178 * [Enhancement] Support byte-range reading of netcdf-3 files stored in private buckets in S3. See [Github #2134](https://github.com/Unidata/netcdf-c/pull/2134)
179 * [Enhancement] Support Amazon S3 access for NCZarr. Also support use of the existing Amazon SDK credentials system. See [Github #2114](https://github.com/Unidata/netcdf-c/pull/2114)
180 * [Bug Fix] Fix string allocation error in H5FDhttp.c. See [Github #2127](https://github.com/Unidata/netcdf-c/pull/2127).
181 * [Bug Fix] Apply patches for ezxml and for selected oss-fuzz detected errors. See [Github #2125](https://github.com/Unidata/netcdf-c/pull/2125).
182 * [Bug Fix] Ensure that internal Fortran APIs are always defined. See [Github #2098](https://github.com/Unidata/netcdf-c/pull/2098).
183 * [Enhancement] Support filters for NCZarr. See [Github #2101](https://github.com/Unidata/netcdf-c/pull/2101)
184 * [Bug Fix] Make PR 2075 long file name be idempotent. See [Github #2094](https://github.com/Unidata/netcdf-c/pull/2094).
185 ## 4.8.1 - August 18, 2021
186 
187 * [Bug Fix] Fix multiple bugs in libnczarr. See [Github #2066](https://github.com/Unidata/netcdf-c/pull/2066).
188 * [Enhancement] Support windows network paths (e.g. \\svc\...). See [Github #2065](https://github.com/Unidata/netcdf-c/pull/2065).
189 * [Enhancement] Convert to a new representation of the NCZarr meta-data extensions: version 2. Read-only backward compatibility is provided. See [Github #2032](https://github.com/Unidata/netcdf-c/pull/2032).
190 * [Bug Fix] Fix dimension_separator bug in libnczarr. See [Github #2035](https://github.com/Unidata/netcdf-c/pull/2035).
191 * [Bug Fix] Fix bugs in libdap4. See [Github #2005](https://github.com/Unidata/netcdf-c/pull/2005).
192 * [Bug Fix] Store NCZarr fillvalue as a singleton instead of a 1-element array. See [Github #2017](https://github.com/Unidata/netcdf-c/pull/2017).
193 * [Bug Fixes] The netcdf-c library was incorrectly determining the scope of dimension; similar to the type scope problem. See [Github #2012](https://github.com/Unidata/netcdf-c/pull/2012) for more information.
194 * [Bug Fix] Re-enable DAP2 authorization testing. See [Github #2011](https://github.com/Unidata/netcdf-c/issues/2011).
195 * [Bug Fix] Fix bug with windows version of mkstemp that causes failure to create more than 26 temp files. See [Github #1998](https://github.com/Unidata/netcdf-c/pull/1998).
196 * [Bug Fix] Fix ncdump bug when printing VLENs with basetype char. See [Github #1986](https://github.com/Unidata/netcdf-c/issues/1986).
197 * [Bug Fixes] The netcdf-c library was incorrectly determining the scope of types referred to by nc_inq_type_equal. See [Github #1959](https://github.com/Unidata/netcdf-c/pull/1959) for more information.
198 * [Bug Fix] Fix bug in use of XGetopt when building under Mingw. See [Github #2009](https://github.com/Unidata/netcdf-c/issues/2009).
199 * [Enhancement] Improve the error reporting when attempting to use a filter for which no implementation can be found in HDF5_PLUGIN_PATH. See [Github #2000](https://github.com/Unidata/netcdf-c/pull/2000) for more information.
200 * [Bug Fix] Fix `make distcheck` issue in `nczarr_test/` directory. See [Github #2007](https://github.com/Unidata/netcdf-c/issues/2007).
201 * [Bug Fix] Fix bug in NCclosedir in dpathmgr.c. See [Github #2003](https://github.com/Unidata/netcdf-c/issues/2003).
202 * [Bug Fix] Fix bug in ncdump that assumes that there is a relationship between the total number of dimensions and the max dimension id. See [Github #2004](https://github.com/Unidata/netcdf-c/issues/2004).
203 * [Bug Fix] Fix bug in JSON processing of strings with embedded quotes. See [Github #1993](https://github.com/Unidata/netcdf-c/issues/1993).
204 * [Enhancement] Add support for the new "dimension_separator" enhancement to Zarr v2. See [Github #1990](https://github.com/Unidata/netcdf-c/pull/1990) for more information.
205 * [Bug Fix] Fix hack for handling failure of shell programs to properly handle escape characters. See [Github #1989](https://github.com/Unidata/netcdf-c/issues/1989).
206 * [Bug Fix] Allow some primitive type names to be used as identifiers depending on the file format. See [Github #1984](https://github.com/Unidata/netcdf-c/issues/1984).
207 * [Enhancement] Add support for reading/writing pure Zarr storage format that supports the XArray _ARRAY_DIMENSIONS attribute. See [Github #1952](https://github.com/Unidata/netcdf-c/pull/1952) for more information.
208 * [Update] Updated version of bzip2 used in filter testing/functionality, in support of [Github #1969](https://github.com/Unidata/netcdf-c/issues/1969).
209 * [Bug Fix] Corrected HDF5 version detection logic as described in [Github #1962](https://github.com/Unidata/netcdf-c/issues/1962).
210 
211 ## 4.8.0 - March 30, 2021
212 
213 * [Enhancement] Bump the NC_DISPATCH_VERSION from 2 to 3, and as a side effect, unify the definition of NC_DISPATCH_VERSION so it only needs to be defined in CMakeLists.txt and configure.ac. See [Github #1945](https://github.com/Unidata/netcdf-c/pull/1945) for more information.
214 * [Enhancement] Provide better cross platform path name management. This converts paths for various platforms (e.g. Windows, MSYS, etc.) so that they are in the proper format for the executing platform. See [Github #1958](https://github.com/Unidata/netcdf-c/pull/1958) for more information.
215 * [Bug Fixes] The nccopy program was treating -d0 as turning deflation on rather than interpreting it as "turn off deflation". See [Github #1944](https://github.com/Unidata/netcdf-c/pull/1944) for more information.
216 * [Enhancement] Add support for storing NCZarr data in zip files. See [Github #1942](https://github.com/Unidata/netcdf-c/pull/1942) for more information.
217 * [Bug Fixes] Make fillmismatch the default for DAP2 and DAP4; too many servers ignore this requirement.
218 * [Bug Fixes] Fix some memory leaks in NCZarr, fix a bug with long strides in NCZarr. See [Github #1913](https://github.com/Unidata/netcdf-c/pull/1913) for more information.
219 * [Enhancement] Add some optimizations to NCZarr, dosome cleanup of code cruft, add some NCZarr test cases, add a performance test to NCZarr. See [Github #1908](https://github.com/Unidata/netcdf-c/pull/1908) for more information.
220 * [Bug Fix] Implement a better chunk cache system for NCZarr. The cache now uses extendible hashing plus a linked list for provide a combination of expandibility, fast access, and LRU behavior. See [Github #1887](https://github.com/Unidata/netcdf-c/pull/1887) for more information.
221 * [Enhancement] Provide .rc fields for S3 authentication: HTTP.S3.ACCESSID and HTTP.S3.SECRETKEY.
222 * [Enhancement] Give the client control over what parts of a DAP2 URL are URL encoded (i.e. %xx). This is to support the different decoding rules that servers apply to incoming URLS. See [Github #1884](https://github.com/Unidata/netcdf-c/pull/1884) for more information.
223 * [Bug Fix] Fix incorrect time offsets from `ncdump -t`, in some cases when the time `units` attribute contains both a **non-zero** time-of-day, and a time zone suffix containing the letter "T", such as "UTC". See [Github #1866](https://github.com/Unidata/netcdf-c/pull/1866) for more information.
224 * [Bug Fix] Cleanup the NCZarr S3 build options. See [Github #1869](https://github.com/Unidata/netcdf-c/pull/1869) for more information.
225 * [Bug Fix] Support aligned access for selected ARM processors. See [Github #1871](https://github.com/Unidata/netcdf-c/pull/1871) for more information.
226 * [Documentation] Migrated the documents in the NUG/ directory to the dedicated NUG repository found at https://github.com/Unidata/netcdf
227 * [Bug Fix] Revert the internal filter code to simplify it. From the user's point of view, the only visible change should be that (1) the functions that convert text to filter specs have had their signature reverted and renamed and have been moved to netcdf_aux.h, and (2) Some filter API functions now return NC_ENOFILTER when inquiry is made about some filter. Internally, the dispatch table has been modified to get rid of the complex structures.
228 * [Bug Fix] If the HDF5 byte-range Virtual File Driver is available )HDf5 1.10.6 or later) then use it because it has better performance than the one currently built into the netcdf library.
229 * [Bug Fix] Fixed byte-range support with cURL > 7.69. See [https://github.com/Unidata/netcdf-c/pull/1798].
230 * [Enhancement] Added new test for using compression with parallel I/O: nc_test4/tst_h_par_compress.c. See [https://github.com/Unidata/netcdf-c/pull/1784].
231 * [Bug Fix] Don't return error for extra calls to nc_redef() for netCDF/HDF5 files, unless classic model is in use. See [https://github.com/Unidata/netcdf-c/issues/1779].
232 * [Enhancement] Added new parallel I/O benchmark program to mimic NOAA UFS data writes, built when --enable-benchmarks is in configure. See [https://github.com/Unidata/netcdf-c/pull/1777].
233 * [Bug Fix] Now allow szip to be used on variables with unlimited dimension [https://github.com/Unidata/netcdf-c/issues/1774].
234 * [Enhancement] Add support for cloud storage using a variant of the Zarr storage format. Warning: this feature is highly experimental and is subject to rapid evolution [https://www.unidata.ucar.edu/blogs/developer/en/entry/overview-of-zarr-support-in].
235 * [Bug Fix] Fix nccopy to properly set default chunking parameters when not otherwise specified. This can significantly improve performance in selected cases. Note that if seeing slow performance with nccopy, then, as a work-around, specifically set the chunking parameters. [https://github.com/Unidata/netcdf-c/issues/1763].
236 * [Bug Fix] Fix some protocol bugs/differences between the netcdf-c library and the OPeNDAP Hyrax server. Also cleanup checksum handling [https://github.com/Unidata/netcdf-c/issues/1712].* [Bug Fix] IMPORTANT: Ncgen was not properly handling large
237 data sections. The problem manifests as incorrect ordering of
238 data in the created file. Aside from examining the file with
239 ncdump, the error can be detected by running ncgen with the -lc
240 flag (to produce a C file). Examine the file to see if any
241 variable is written in pieces as opposed to a single call to
242 nc_put_vara. If multiple calls to nc_put_vara are used to write
243 a variable, then it is probable that the data order is
244 incorrect. Such multiple writes can occur for large variables
245 and especially when one of the dimensions is unlimited.
246 * [Bug Fix] Add necessary __declspec declarations to allow compilation
247 of netcdf library without causing errors or (_declspec related)
248 warnings [https://github.com/Unidata/netcdf-c/issues/1725].
249 * [Enhancement] When a filter is applied twice with different
250 parameters, then the second set is used for writing the dataset
251 [https://github.com/Unidata/netcdf-c/issues/1713].
252 * [Bug Fix] Now larger cache settings are used for sequential HDF5 file creates/opens on parallel I/O capable builds; see [Github #1716](https://github.com/Unidata/netcdf-c/issues/1716) for more information.
253 * [Bug Fix] Add functions to libdispatch/dnotnc4.c to support
254 dispatch table operations that should work for any dispatch
255 table, even if they do not do anything; functions such as
256 nc_inq_var_filter [https://github.com/Unidata/netcdf-c/issues/1693].
257 * [Bug Fix] Fixed a scalar annotation error when scalar == 0; see [Github #1707](https://github.com/Unidata/netcdf-c/issues/1707) for more information.
258 * [Bug Fix] Use proper CURLOPT values for VERIFYHOST and VERIFYPEER; the semantics for VERIFYHOST in particular changed. Documented in NUG/DAP2.md. See [https://github.com/Unidata/netcdf-c/issues/1684].
259 * [Bug Fix][cmake] Correct an issue with parallel filter test logic in CMake-based builds.
260 * [Bug Fix] Now allow nc_inq_var_deflate()/nc_inq_var_szip() to be called for all formats, not just HDF5. Non-HDF5 files return NC_NOERR and report no compression in use. This reverts behavior that was changed in the 4.7.4 release. See [https://github.com/Unidata/netcdf-c/issues/1691].
261 * [Bug Fix] Compiling on a big-endian machine exposes some missing forward delcarations in dfilter.c.
262 * [File Change] Change from HDF5 v1.6 format compatibility, back to v1.8 compatibility, for newly created files. The superblock changes from version 0 back to version 2. An exception is when using libhdf5 deprecated versions 1.10.0 and 1.10.1, which can only create v1.6 compatible format. Full backward read/write compatibility for netCDF-4 is maintained in all cases. See [Github #951](https://github.com/Unidata/netcdf-c/issues/951).
263 
264 ## 4.7.4 - March 27, 2020
265 
266 * [Windows] Bumped packaged HDF5 to 1.10.6, HDF4 to 4.2.14, and libcurl to 7.60.0.
267 * [Enhancement] Support has been added for HDF5-1.12.0. See [https://github.com/Unidata/netcdf-c/issues/1528].
268 * [Bug Fix] Correct behavior for the command line utilities when directly accessing a directory using utf8 characters. See [Github #1669](https://github.com/Unidata/netcdf-c/issues/1669), [Github #1668](https://github.com/Unidata/netcdf-c/issues/1668) and [Github #1666](https://github.com/Unidata/netcdf-c/issues/1666) for more information.
269 * [Bug Fix] Attempts to set filters or chunked storage on scalar vars will now return NC_EINVAL. Scalar vars cannot be chunked, and only chunked vars can have filters. Previously the library ignored these attempts, and always storing scalars as contiguous storage. See [https://github.com/Unidata/netcdf-c/issues/1644].
270 * [Enhancement] Support has been added for multiple filters per variable. See [https://github.com/Unidata/netcdf-c/issues/1584].
271 * [Enhancement] Now nc_inq_var_szip retuns 0 for parameter values if szip is not in use for var. See [https://github.com/Unidata/netcdf-c/issues/1618].
272 * [Enhancement] Now allow parallel I/O with filters, for HDF5-1.10.3 and later. See [https://github.com/Unidata/netcdf-c/issues/1473].
273 * [Enhancement] Increased default size of cache buffer to 16 MB, from 4 MB. Increased number of slots to 4133. See [https://github.com/Unidata/netcdf-c/issues/1541].
274 * [Enhancement] Allow zlib compression to be used with parallel I/O writes, if HDF5 version is 1.10.3 or greater. See [https://github.com/Unidata/netcdf-c/issues/1580].
275 * [Enhancement] Restore use of szip compression when writing data (including writing in parallel if HDF5 version is 1.10.3 or greater). See [https://github.com/Unidata/netcdf-c/issues/1546].
276 * [Enhancement] Enable use of compact storage option for small vars in netCDF/HDF5 files. See [https://github.com/Unidata/netcdf-c/issues/1570].
277 * [Enhancement] Updated benchmarking program bm_file.c to better handle very large files. See [https://github.com/Unidata/netcdf-c/issues/1555].
278 * [Enhancement] Added version number to dispatch table, and now check version with nc_def_user_format(). See [https://github.com/Unidata/netcdf-c/issues/1599].
279 * [Bug Fix] Fixed user setting of MPI launcher for parallel I/O HDF5 test in h5_test. See [https://github.com/Unidata/netcdf-c/issues/1626].
280 * [Bug Fix] Fixed problem of growing memory when netCDF-4 files were opened and closed. See [https://github.com/Unidata/netcdf-c/issues/1575 and https://github.com/Unidata/netcdf-c/issues/1571].
281 * [Enhancement] Increased size of maximum allowed name in HDF4 files to NC_MAX_NAME. See [https://github.com/Unidata/netcdf-c/issues/1631].
282 
283 ## 4.7.3 - November 20, 2019
284 
285 * [Bug Fix]Fixed an issue where installs from tarballs will not properly compile in parallel environments.
286 * [Bug Fix] Library was modified so that rewriting the same attribute happens without deleting the attribute, to avoid a limit on how many times this may be done in HDF5. This fix was thought to be in 4.6.2 but was not. See [https://github.com/Unidata/netcdf-c/issues/350].
287 * [Enhancement] Add a dispatch version number to netcdf_meta.h and libnetcdf.settings, in case we decide to change dispatch table in future. See [https://github.com/Unidata/netcdf-c/issues/1469].
288 * [Bug Fix] Now testing that endianness can only be set on atomic ints and floats. See [https://github.com/Unidata/netcdf-c/issues/1479].
289 * [Bug Fix] Fix for subtle error involving var and unlimited dim of the same name, but unrelated, in netCDF-4. See [https://github.com/Unidata/netcdf-c/issues/1496].
290 * [Enhancement] Update for attribute documentation. See [https://github.com/Unidata/netcdf-c/issues/1512].
291 * [Bug Fix][Enhancement] Corrected assignment of anonymous (a.k.a. phony) dimensions in an HDF5 file. Now when a dataset uses multiple dimensions of the same size, netcdf assumes they are different dimensions. See [GitHub #1484](https://github.com/Unidata/netcdf-c/issues/1484) for more information.
292 
293 ## 4.7.2 - October 22, 2019
294 
295 * [Bug Fix][Enhancement] Various bug fixes and enhancements.
296 * [Bug Fix][Enhancement] Corrected an issue where protected memory was being written to with some pointer slight-of-hand. This has been in the code for a while, but appears to be caught by the compiler on OSX, under circumstances yet to be completely nailed down. See [GitHub #1486](https://github.com/Unidata/netcdf-c/issues/1486) for more information.
297 * [Enhancement] [Parallel IO] Added support for parallel functions in MSVC. See [Github #1492](https://github.com/Unidata/netcdf-c/pull/1492) for more information.
298 * [Enhancement] Added a function for changing the ncid of an open file. This function should only be used if you know what you are doing, and is meant to be used primarily with PIO integration. See [GitHub #1483](https://github.com/Unidata/netcdf-c/pull/1483) and [GitHub #1487](https://github.com/Unidata/netcdf-c/pull/1487) for more information.
299 
300 ## 4.7.1 - August 27, 2019
301 
302 * [Enhancement] Added unit_test directory, which contains unit tests for the libdispatch and libsrc4 code (and any other directories that want to put unit tests there). Use --disable-unit-tests to run without unit tests (ex. for code coverage analysis). See [GitHub #1458](https://github.com/Unidata/netcdf-c/issues/1458).
303 
304 * [Bug Fix] Remove obsolete _CRAYMPP and LOCKNUMREC macros from code. Also brought documentation up to date in man page. These macros were used in ancient times, before modern parallel I/O systems were developed. Programmers interested in parallel I/O should see nc_open_par() and nc_create_par(). See [GitHub #1459](https://github.com/Unidata/netcdf-c/issues/1459).
305 
306 * [Enhancement] Remove obsolete and deprecated functions nc_set_base_pe() and nc_inq_base_pe() from the dispatch table. (Both functions are still supported in the library, this is an internal change only.) See [GitHub #1468](https://github.com/Unidata/netcdf-c/issues/1468).
307 
308 * [Bug Fix] Reverted nccopy behavior so that if no -c parameters are given, then any default chunking is left to the netcdf-c library to decide. See [GitHub #1436](https://github.com/Unidata/netcdf-c/issues/1436).
309 
310 ## 4.7.0 - April 29, 2019
311 
312 * [Enhancement] Updated behavior of `pkgconfig` and `nc-config` to allow the use of the `--static` flags, e.g. `nc-config --libs --static`, which will show information for linking against `libnetcdf` statically. See [Github #1360](https://github.com/Unidata/netcdf-c/issues/1360) and [Github #1257](https://github.com/Unidata/netcdf-c/issues/1257) for more information.
313 
314 * [Enhancement] Provide byte-range reading of remote datasets. This allows
315 read-only access to, for example, Amazon S3 objects and also Thredds Server
316 datasets via the HTTPService access method.
317 See [GitHub #1251](https://github.com/Unidata/netcdf-c/issues/1251).
318 
319 * Update the license from the home-brewed NetCDF license to the standard 3-Clause BSD License. This change does not result in any new restrictions; it is merely the adoption of a standard, well-known and well-understood license in place of the historic NetCDF license written at Unidata. This is part of a broader push by Unidata to adopt modern, standardized licensing.
320 
321 ## 4.6.3 - February 28, 2019
322 
323 * [Bug Fix] Correctly generated `netcdf.pc` generated either by `configure` or `cmake`. If linking against a static netcdf, you would need to pass the `--static` argument to `pkg-config` in order to list all of the downstream dependencies. See [Github #1324](https://github.com/Unidata/netcdf-c/issues/1324) for more information.
324 * Now always write hidden coordinates attribute, which allows faster file opens when present. See [Github #1262](https://github.com/Unidata/netcdf-c/issues/1262) for more information.
325 * Some fixes for rename, including fix for renumbering of varids after a rename (#1307), renaming var to dim without coordinate var. See [Github #1297](https://github.com/Unidata/netcdf-c/issues/1297).
326 * Fix of NULL parameter causing segfaults in put_vars functions. See [Github #1265](https://github.com/Unidata/netcdf-c/issues/1265) for more information.
327 * Fix of --enable-benchmark benchmark tests [Github #1211](https://github.com/Unidata/netcdf-c/issues/1211)
328 * Update the license from the home-brewed NetCDF license to the standard 3-Clause BSD License. This change does not result in any new restrictions; it is merely the adoption of a standard, well-known and well-understood license in place of the historic NetCDF license written at Unidata. This is part of a broader push by Unidata to adopt modern, standardized licensing.
329 * [BugFix] Corrected DAP-related issues on big-endian machines. See [Github #1321](https://github.com/Unidata/netcdf-c/issues/1321), [Github #1302](https://github.com/Unidata/netcdf-c/issues/1302) for more information.
330 * [BugFix][Enhancement] Various and sundry bugfixes and performance enhancements, thanks to \@edhartnett, \@gsjarrdema, \@t-b, \@wkliao, and all of our other contributors.
331 * [Enhancement] Extended `nccopy -F` syntax to support multiple variables with a single invocation. See [Github #1311](https://github.com/Unidata/netcdf-c/issues/1311) for more information.
332 * [BugFix] Corrected an issue where DAP2 was incorrectly converting signed bytes, resulting in an erroneous error message under some circumstances. See [GitHub #1317](https://github.com/Unidata/netcdf-c/issues/1317) for more information. See [Github #1319](https://github.com/Unidata/netcdf-c/issues/1319) for related information.
333 * [BugFix][Enhancement] Modified `nccopy` so that `_NCProperties` is not copied over verbatim but is instead generated based on the version of `libnetcdf` used when copying the file. Additionally, `_NCProperties` are displayed if/when associated with a netcdf3 file, now. See [GitHub #803](https://github.com/Unidata/netcdf-c/issues/803) for more information.
334 
335 ## 4.6.2 - November 16, 2018
336 
337 * [Enhancement] Lazy att read - only read atts when user requests one of them. See [GitHub #857](https://github.com/Unidata/netcdf-c/issues/857).
338 * [Enhancement] Fast global att read - when global atts are read, they are read much more quickly. See [GitHub #857](https://github.com/Unidata/netcdf-c/issues/857).
339 
340 ## 4.6.2-rc2 November 1, 2018
341 
342 
343 * [Enhancement] Add nccopy command options for per-variable chunk sizing, and minimum chunk size. See [GitHub #1087](https://github.com/Unidata/netcdf-c/pull/1087).
344 * [Bug Fix] Fix nccopy handling of user specified chunk sizes. See [GitHub #725](https://github.com/Unidata/netcdf-c/issues/725),[#1087](https://github.com/Unidata/netcdf-c/issues/1087).
345 * [Bug Fix] Avoid limit on number of times a netCDF4 attribute can be updated. Not a complete fix for the HDF5 "maximum creation order" problem, but should greatly reduce occurrences in many real-world cases. See [GitHub #350](https://github.com/Unidata/netcdf-c/issues/350).
346 * [Bug Fix] The use of NC_DISKLESS has been modified to make it cleaner. This adds a new flag called NC_PERSIST that takes over the now obsolete NC_MPIPOSIX.
347 * [Obsolete] Obsolete the MPIPOSIX flag.
348 * [Bug Fix] When using filters with HDF5 1.10.x or later, it is necessary to utilize the HDF5 replacements for malloc, realloc, and free in the filter code.
349 
350 ## 4.6.2-rc1 - September 19, 2018
351 
352 * [Enhancement] Create a new version of _NCProperties provenance attribute. This version (version 2) supports arbitrary key-value pairs. It is the default when new files are created. Version 1 continues to be accepted.
353 * [Enhancement] Allow user to set http read buffersize for DAP2 and DAP4 using the tag HTTP.READ.BUFFERSIZE in the .daprc file.
354 * [Enhancement] Allow user to set http keepalive for DAP2 and DAP4 using the tag HTTP.KEEPALIVE in the .daprc file (see the OPeNDAP documentation for details).
355 * [Enhancement] Support DAP4 remote tests using a new remote test server located on the Unidata JetStream project.
356 * [Enhancement] Improved the performance of the nc_get/put_vars operations by using the equivalent slab capabilities of hdf5. Result is a significant speedup of these operations. See [GitHub #1001](https://github.com/Unidata/netcdf-c/pull/1001) for more information.
357 * [Enhancement] Expanded the capabilities of `NC_INMEMORY` to support writing and accessing the final modified memory. See [GitHub #879](https://github.com/Unidata/netcdf-c/pull/879) for more information.
358 * [Enhancement] Made CDF5 support enabled by default. See [Github #931](https://github.com/Unidata/netcdf-c/issues/931) for more information.
359 * [Bug Fix] Corrected a number of memory issues identified in `ncgen`. See [GitHub #558 for more information](https://github.com/Unidata/netcdf-c/pull/558).
360 
361 ## 4.6.1 - March 19, 2018
362 
363 * [Bug Fix] Corrected an issue which could result in a dap4 failure. See [Github #888](https://github.com/Unidata/netcdf-c/pull/888) for more information.
364 * [Bug Fix][Enhancement] Allow `nccopy` to control output filter suppresion. See [Github #894](https://github.com/Unidata/netcdf-c/pull/894) for more information.
365 * [Enhancement] Reverted some new behaviors that, while in line with the netCDF specification, broke existing workflows. See [Github #843](https://github.com/Unidata/netcdf-c/issues/843) for more information.
366 * [Bug Fix] Improved support for CRT builds with Visual Studio, improves zlib detection in hdf5 library. See [Github #853](https://github.com/Unidata/netcdf-c/pull/853) for more information.
367 * [Enhancement][Internal] Moved HDF4 into a distinct dispatch layer. See [Github #849](https://github.com/Unidata/netcdf-c/pull/849) for more information.
368 
369 ## 4.6.0 - January 24, 2018
370 * [Enhancement] Full support for using HDF5 dynamic filters, both for reading and writing. See the file docs/filters.md.
371 * [Enhancement] Added an option to enable strict null-byte padding for headers; this padding was specified in the spec but was not enforced. Enabling this option will allow you to check your files, as it will return an E_NULLPAD error. It is possible for these files to have been written by older versions of libnetcdf. There is no effective problem caused by this lack of null padding, so enabling these options is informational only. The options for `configure` and `cmake` are `--enable-strict-null-byte-header-padding` and `-DENABLE_STRICT_NULL_BYTE_HEADER_PADDING`, respectively. See [Github #657](https://github.com/Unidata/netcdf-c/issues/657) for more information.
372 * [Enhancement] Reverted behavior/handling of out-of-range attribute values to pre-4.5.0 default. See [Github #512](https://github.com/Unidata/netcdf-c/issues/512) for more information.
373 * [Bug] Fixed error in tst_parallel2.c. See [Github #545](https://github.com/Unidata/netcdf-c/issues/545) for more information.
374 * [Bug] Fixed handling of corrupt files + proper offset handling for hdf5 files. See [Github #552](https://github.com/Unidata/netcdf-c/issues/552) for more information.
375 * [Bug] Corrected a memory overflow in `tst_h_dimscales`, see [Github #511](https://github.com/Unidata/netcdf-c/issues/511), [Github #505](https://github.com/Unidata/netcdf-c/issues/505), [Github #363](https://github.com/Unidata/netcdf-c/issues/363) and [Github #244](https://github.com/Unidata/netcdf-c/issues/244) for more information.
376 
377 ## 4.5.0 - October 20, 2017
378 
379 * Corrected an issue which could potential result in a hang while using parallel file I/O. See [Github #449](https://github.com/Unidata/netcdf-c/pull/449) for more information.
380 * Addressed an issue with `ncdump` not properly handling dates on a 366 day calendar. See [GitHub #359](https://github.com/Unidata/netcdf-c/issues/359) for more information.
381 
382 ### 4.5.0-rc3 - September 29, 2017
383 
384 * [Update] Due to ongoing issues, native CDF5 support has been disabled by **default**. You can use the options mentioned below (`--enable-cdf5` or `-DENABLE_CDF5=TRUE` for `configure` or `cmake`, respectively). Just be aware that for the time being, Reading/Writing CDF5 files on 32-bit platforms may result in unexpected behavior when using extremely large variables. For 32-bit platforms it is best to continue using `NC_FORMAT_64BIT_OFFSET`.
385 * [Bug] Corrected an issue where older versions of curl might fail. See [GitHub #487](https://github.com/Unidata/netcdf-c/issues/487) for more information.
386 * [Enhancement] Added options to enable/disable `CDF5` support at configure time for autotools and cmake-based builds. The options are `--enable/disable-cdf5` and `ENABLE_CDF5`, respectively. See [Github #484](https://github.com/Unidata/netcdf-c/issues/484) for more information.
387 * [Bug Fix] Corrected an issue when subsetting a netcdf3 file via `nccopy -v/-V`. See [Github #425](https://github.com/Unidata/netcdf-c/issues/425) and [Github #463](https://github.com/Unidata/netcdf-c/issues/463) for more information.
388 * [Bug Fix] Corrected `--has-dap` and `--has-dap4` output for cmake-based builds. See [GitHub #473](https://github.com/Unidata/netcdf-c/pull/473) for more information.
389 * [Bug Fix] Corrected an issue where `NC_64BIT_DATA` files were being read incorrectly by ncdump, despite the data having been written correctly. See [GitHub #457](https://github.com/Unidata/netcdf-c/issues/457) for more information.
390 * [Bug Fix] Corrected a potential stack buffer overflow. See [GitHub #450](https://github.com/Unidata/netcdf-c/pull/450) for more information.
391 
392 ### 4.5.0-rc2 - August 7, 2017
393 
394 * [Bug Fix] Addressed an issue with how cmake was implementing large file support on 32-bit systems. See [GitHub #385](https://github.com/Unidata/netcdf-c/issues/385) for more information.
395 * [Bug Fix] Addressed an issue where ncgen would not respect keyword case. See [GitHub #310](https://github.com/Unidata/netcdf-c/issues/310) for more information.
396 
397 ### 4.5.0-rc1 - June 5, 2017
398 
399 * [Enhancement] DAP4 is now included. Since dap2 is the default for urls, dap4 must be specified by
400  1. using "dap4:" as the url protocol, or
401  2. appending "\#protocol=dap4" to the end of the url, or
402  3. appending "\#dap4" to the end of the url
403 
404  Note that dap4 is enabled by default but remote-testing is
405  disabled until the testserver situation is resolved.
406 
407 * [Enhancement] The remote testing server can now be specified with the `--with-testserver` option to ./configure.
408 * [Enhancement] Modified netCDF4 to use ASCII for NC_CHAR. See [Github Pull request #316](https://github.com/Unidata/netcdf-c/pull/316) for more information.
409 * [Bug Fix] Corrected an error with how dimsizes might be read. See [Github #410](https://github.com/unidata/netcdf-c/issues/410) for more information.
410 * [Bug Fix] Corrected an issue where 'make check' would fail if 'make' or 'make all' had not run first. See [Github #339](https://github.com/Unidata/netcdf-c/issues/339) for more information.
411 * [Bug Fix] Corrected an issue on Windows with Large file tests. See [Github #385](https://github.com/Unidata/netcdf-c/issues/385]) for more information.
412 * [Bug Fix] Corrected an issue with diskless file access, see [Pull Request #400](https://github.com/Unidata/netcdf-c/issues/400) and [Pull Request #403](https://github.com/Unidata/netcdf-c/issues/403) for more information.
413 * [Upgrade] The bash based test scripts have been upgraded to use a common test_common.sh include file that isolates build specific information.
414 * [Upgrade] The bash based test scripts have been upgraded to use a common test_common.sh include file that isolates build specific information.
415 * [Refactor] the oc2 library is no longer independent of the main netcdf-c library. For example, it now uses ncuri, nclist, and ncbytes instead of its homegrown equivalents.
416 * [Bug Fix] `NC_EGLOBAL` is now properly returned when attempting to set a global `_FillValue` attribute. See [GitHub #388](https://github.com/Unidata/netcdf-c/issues/388) and [GitHub #389](https://github.com/Unidata/netcdf-c/issues/389) for more information.
417 * [Bug Fix] Corrected an issue where data loss would occur when `_FillValue` was mistakenly allowed to be redefined. See [Github #390](https://github.com/Unidata/netcdf-c/issues/390), [GitHub #387](https://github.com/Unidata/netcdf-c/pull/387) for more information.
418 * [Upgrade][Bug] Corrected an issue regarding how "orphaned" DAS attributes were handled. See [GitHub #376](https://github.com/Unidata/netcdf-c/pull/376) for more information.
419 * [Upgrade] Update utf8proc.[ch] to use the version now maintained by the Julia Language project (https://github.com/JuliaLang/utf8proc/blob/master/LICENSE.md).
420 * [Bug] Addressed conversion problem with Windows sscanf. This primarily affected some OPeNDAP URLs on Windows. See [GitHub #365](https://github.com/Unidata/netcdf-c/issues/365) and [GitHub #366](https://github.com/Unidata/netcdf-c/issues/366) for more information.
421 * [Enhancement] Added support for HDF5 collective metadata operations when available. Patch submitted by Greg Sjaardema, see [Pull request #335](https://github.com/Unidata/netcdf-c/pull/335) for more information.
422 * [Bug] Addressed a potential type punning issue. See [GitHub #351](https://github.com/Unidata/netcdf-c/issues/351) for more information.
423 * [Bug] Addressed an issue where netCDF wouldn't build on Windows systems using MSVC 2012. See [GitHub #304](https://github.com/Unidata/netcdf-c/issues/304) for more information.
424 * [Bug] Fixed an issue related to potential type punning, see [GitHub #344](https://github.com/Unidata/netcdf-c/issues/344) for more information.
425 * [Enhancement] Incorporated an enhancement provided by Greg Sjaardema, which may improve read/write times for some complex files. Basically, linked lists were replaced in some locations where it was safe to use an array/table. See [Pull request #328](https://github.com/Unidata/netcdf-c/pull/328) for more information.
426 
427 ## 4.4.1.1 - November 21, 2016
428 
429 * [Bug] Fixed an issue where `ncgen` would potentially crash or write incorrect netCDF4 binary data under very specific circumstances. This bug did *not* affect data written on 32-bit systems or by using the netCDF library; it was specific to `ncgen`. This would only happen when writing a compound data type containing an 8-byte data type followed by a 4-byte data type *and* the 4-byte data type was not properly aligned; this would *possibly* result in incorrect padding. This did not affect 32-bit systems, or data written directly by the library. See [GitHub #323](https://github.com/Unidata/netcdf-c/issues/323) for more information.
430 * [Documentation] Updated documentation related to netCDF variable names and DAP2 access to reflect the undefined behavior potentially observed when DAP2 reserved keywords are used as netCDF variable names. See [GitHub #308](https://github.com/Unidata/netcdf-c/issues/308) for more information.
431 * [Bug] Fixed an issue with `nc_inq_type()` not returning proper value in some circumstances. See [GitHub #317](https://github.com/Unidata/netcdf-c/issues/317) for more information.
432 * [Bug] Corrected an issue related to test failures when `--disable-utilities` or `-DENABLE_UTILITIES=OFF` are specified when building with autotools or cmake, respectively. See [GitHub #313](https://github.com/Unidata/netcdf-c/issues/313) for more information.
433 * [Bug][Enhancement] Corrected a behavioral issue with the `_NCProperties` attribute taking up too much space. See [GitHub #300](https://github.com/Unidata/netcdf-c/issues/300) and [GitHub #301](https://github.com/Unidata/netcdf-c/pull/301) for more information.
434 
435 * [Bug] Corrected behavior for `nc-config` so that, if `nf-config` is found in system, the proper fortran-related information will be conveyed. See [GitHub #296](https://github.com/Unidata/netcdf-c/issues/296] for more information.
436 
437 ## 4.4.1 - June 28, 2016
438 
439 * [File Change] Starting with release 4.4.1, netCDF-4 files are created with HDF5 v1.6 format compatibility, rather than v1.8. The superblock changes from version 2, as was observed in previous netCDF versions, to version 0. This is due to a workaround required to avoid backwards binary incompatibility when using libhdf5 1.10.x or greater. Superblock versions 0 and 2 appear to be forward and backward compatible for netCDF purposes. Other than a different superblock number, the data should remain consistent. See [GitHub #250](https://github.com/Unidata/netcdf-c/issues/250).
440 * [Enhancement] Added better error reporting when ncdump/nccopy are given a bad constraint in a DAP url. See [GitHub #279](https://github.com/Unidata/netcdf-c/pull/279) for more information.
441 
442 ### 4.4.1-RC3 - June 17, 2016
443 
444 * [Bug Fix] Misc. bug fixes and improvements.
445 * [Bug Fix] Corrected an issue where adding a \_FillValue attribute to a variable would result in other attributes being lost. See [GitHub #239](https://github.com/Unidata/netcdf-c/issues/239) for more details.
446 * [Bug Fix][Parallel I/O] Corrected an issue reported by Kent Yang at the HDF group related to Collective Parallel I/O and a potential hang.
447 
448 ### 4.4.1-RC2 - May 13, 2016
449 
450 * [Enhancement] Added provenance information to files created. This information consists of a persistent attribute named `_NCProperties` plus two computed attributes, `_IsNetcdf4` and `_SuperblockVersion`. Associated documentation was added to the file `docs/attribute_conventions.md`. See [GitHub pull request #260](https://github.com/Unidata/netcdf-c/pull/260) for more information.
451 * [Bug Fix] Cleaned up some dead links in the doxygen-generated documentation.
452 * [Bug Fix] Corrected several issues related to building under Visual Studio 2014.
453 * [Bug Fix] Corrected several test failures related to HDF5 `1.10.0`
454 * [Bug Fix] Reverted SOVersion *current* to 11 from 12; it was incorrectly incremented in netCDF-C release 4.4.1-RC1.
455 * [Enhancement][Windows] Bumped the included libhdf5 to 1.8.16 from 1.8.15 for pre-built Visual Studio installer files.
456 
457 
458 ### 4.4.1-RC1 - April 15, 2016
459 
460 * [Bug Fix][Enhancement] Fixed an issue with netCDF4 files generated using version `1.10.0` of the HDF5 library. The 1.10 release potentially changed the underlying file format, introducing a backwards compatibility issue with the files generated. HDF5 provided an API for retaining the 1.8.x file format, which is now on by default. See [GitHub Issue #250](https://github.com/Unidata/netcdf-c/issues/250) for more information.
461 * [Bug Fix] Corrected an issue with autotools-based builds performed out-of-source-tree. See [GitHub Issue #242](https://github.com/Unidata/netcdf-c/issues/242) for more information.
462 * [Enhancement] Modified `nc_inq_type()` so that it would work more broadly without requiring a valid ncid. See [GitHub Issue #240](https://github.com/Unidata/netcdf-c/issues/240) for more information.
463 * [Enhancement] Accepted a patch code which added a hashmap lookup for rapid var and dim retrieval in nc3 files, contributed by Greg Sjaardema. See [GitHub Pull Request #238](https://github.com/Unidata/netcdf-c/pull/238) for more information.
464 * [Bug Fix] Accepted a contributed pull request which corrected an issue with how the cmake-generated `nc-config` file determined the location of installed files. See [GitHub Pull Request #235](https://github.com/Unidata/netcdf-c/pull/235) for more information.
465 * [Enhancement] Added an advanced option for CMake-based builds, `ENABLE_SHARED_LIBRARY_VERSION`. This option is `ON` by default, but if turned off, only `libnetcdf.dylib` will be generated, instead of files containing the SOVERSION in the file name. This is a requested feature most people might not care about. See [GitHub #228](https://github.com/Unidata/netcdf-c/issues/228) for more information.
466 * [Bug Fix] Corrected an issue with duplicated error codes defined in multiple header files. See [GitHub #213](https://github.com/Unidata/netcdf-c/issues/213) for more information.
467 * [Bug Fix] Addressed an issue specific to Visual Studio 2015 on Windows. On very large files, some calls to the `fstat` class of functions would fail for no apparent reason. This behavior was **not** observed under Visual Studio 2013. This has now been mitigated. See [GitHub #188](https://github.com/Unidata/netcdf-c/issues/188) for more information.
468 * [Enhancement] Updated `nc-config` to report whether `logging` is enabled in netcdf. Additionally, if `f03` is available in an installed netcdf-fortran library, it will now be reported as well.
469 * [Bug Fix] Addressed an issue where `netcdf_mem.h` was not being installed by cmake. See [GitHub #227](https://github.com/Unidata/netcdf-c/issues/227) for more information.
470 * [Bug Fix] Addressed an issue where `ncdump` would crash when trying to read a netcdf file containing an empty ragged `VLEN` variable in an unlimited dimension. See [GitHub #221](https://github.com/Unidata/netcdf-c/issues/221) for more information.
471 
472 ## 4.4.0 Released - January 13, 2016
473 
474 * Bumped SO version to 11.0.0.
475 
476 * Modified `CMakeLists.txt` to work with the re-organized cmake configuration used by the latest HDF5, `1.8.16`, on Windows. Before this fix, netCDF would fail to locate hdf5 1.8.16 when using cmake on Windows. See [GitHub #186](https://github.com/Unidata/netcdf-c/issues/186) for more information.
477 
478 * Addressed an issue with `ncdump` when annotations were used. The indices for the last row suffered from an off-by-1 error. See [GitHub issue #181](https://github.com/Unidata/netcdf-c/issues/181) for more information.
479 
480 * Addressed an issue on platforms where `char` is `unsigned` by default (such as `ARM`), as well as an issue describing regarding undefined behavior, again on `ARM`. See [GitHub issue #159](https://github.com/Unidata/netcdf-c/issues/159) for detailed information.
481 
482 * Fixed an ambiguity in the grammar for cdl files. See [GitHub #178](https://github.com/Unidata/netcdf-c/issues/178) for more information.
483 
484 * Updated documentation for `nc_get_att_string()` to reflect the fact that it returns allocated memory which must be explicitly free'd using `nc_free_string()`. Reported by Constantine Khroulev, see [GitHub Issue 171](https://github.com/Unidata/netcdf-c/issues/171) for more information.
485 
486 * Modified ncgen to properly handle the L and UL suffixes for integer constants
487  to keep backward compatibility. Now it is the case the single L suffix
488  (e.g. 111L) is treated as a 32 bit integer. This makes it consistent with
489  the fact that NC_LONG (netcdf.h) is an alias for NC_INT. Existing .cdl
490  files should be examined for occurrences of the L prefix to ensure that
491  this change will not affect them.
492  (see Github issue 156[https://github.com/Unidata/netcdf-c/issues/156]).
493 
494 * Updated documentation to reference the new `NodeJS` interface to netcdf4, by Sven Willner. It is available from [https://www.npmjs.com/package/netcdf4](https://www.npmjs.com/package/netcdf4) or from the GitHub repository at [https://github.com/swillner/netcdf4-js](https://github.com/swillner/netcdf4-js).
495 
496 * Incorporated pull request https://github.com/Unidata/netcdf-c/pull/150 from Greg Sjaardema to remove the internal hard-wired use of `NC_MAX_DIMS`, instead using a dynamic memory allocation.
497 
498 ### 4.4.0-RC5 Released - November 11, 2015
499 
500 * Added a fix for https://github.com/Unidata/netcdf-c/issues/149, which was reported several times in quick succession within an hour of the RC4 release.
501 
502 ### 4.4.0-RC4 Released - November 10, 2015
503 
504 * Added CDM-5 support via new mode flag called NC_64BIT_DATA (alias NC_CDF5).
505 
506  Major kudos to Wei-Keng Liao for all the effort he put into getting this to work.
507 
508  This cascaded into a number of other changes.
509 
510  1. Renamed libsrcp5 -> libsrcp because PnetCDF can do parallel io for CDF-1, CDF-2 and CDF-5, not just CDF-5.
511  2. Given #1, then the NC_PNETCDF mode flag becomes a subset of NC_MPIIO, so made NC_PNETCDF an alias for NC_MPII.
512  3. NC_FORMAT_64BIT is now deprecated. Use NC_FORMAT_64BIT_OFFSET.
513 
514 Further information regarding the CDF-5 file format specifrication may be found here: http://cucis.ece.northwestern.edu/projects/PnetCDF/CDF-5.html
515 
516 * Modified configure.ac to provide finer control over parallel
517  support. Specifically, add flags for:
518 
519  1. HDF5_PARALLEL when hdf5 library has parallel enabled
520  2. --disable-parallel4 to be used when we do not want
521  netcdf-4 to use parallelism even if hdf5 has it enabled.
522 
523 
524 * Deprecating various extended format flags.
525 
526 The various extended format flags of the format `NC_FORMAT_FOO` have been refactored into the form `NC_FORMATX_FOO`. The old flags still exist but have been marked as deprecated and will be removed at some point. This was done to avoid confusion between the extended format flags and the format flags `NC_FORMAT_CLASSIC`, `NC_FORMAT_64BIT_OFFSET`, etc. The mapping of deprecated-to-new flags is as follows:
527 
528 Deprecated | Replaced with
529 -----------|-------------
530 NC\_FORMAT\_NC3 | NC\_FORMATX\_NC3
531 NC\_FORMAT\_NC\_HDF5 | NC\_FORMATX\_NC\_HDF5
532 NC\_FORMAT\_NC4 | NC\_FORMATX\_NC4
533 NC\_FORMAT\_NC\_HDF4 | NC\_FORMATX\_NC\_HDF4
534 NC\_FORMAT\_PNETCDF | NC\_FORMATX\_PNETCDF
535 NC\_FORMAT\_DAP2 | NC\_FORMATX\_DAP2
536 NC\_FORMAT\_DAP4 | NC\_FORMATX\_DAP4
537 NC\_FORMAT\_UNDEFINED | NC\_FORMATX\_UNDEFINED
538 
539 * Reduced minimum cmake version to `2.8.11` from `2.8.12`. This will allow for cmake use on a broader set of popular linux platforms without having to do a custom cmake install. See https://github.com/Unidata/netcdf-c/issues/135 for more information.
540 
541 * The documentation section `The Default Chunking Scheme` has been updated with more information. This lives in the `guide.dox` file in the `docs/` directory, or can be found online in the appropriate location (typically https://docs.unidata.ucar.edu/netcdf-c/), once this release has been published.
542 
543 ### 4.4.0-RC3 2015-10-08
544 
545 * Addressed an inefficiency in how bytes would be swapped when converting between `LITTLE` and `BIG` ENDIANNESS. See [NCF-338](https://bugtracking.unidata.ucar.edu/browse/NCF-338) for more information.
546 
547 * Addressed an issue where an interrupted read on a `POSIX` system would return an error even if errno had been properly set to `EINTR`. This issue was initially reported by David Knaak at Cray. More information may be found at [NCF-337](https://bugtracking.unidata.ucar.edu/browse/NCF-337).
548 
549 * Added a note to the install directions pointing out that parallel make
550 cannot be used for 'make check'.
551 
552 ### 4.4.0-RC2 Released 2015-07-09
553 
554 * Minor bug fixes and cleanup of issues reported with first release candidate.
555 
556 ### 4.4.0-RC1 Released 2015-06-09
557 
558 * The pre-built Windows binaries are now built using `Visual Studio 2012`, instead of `Visual Studio 2010`. Source-code compilation remains function with `Visual Studio 2010`, this is just a change in the pre-built binaries.
559 
560 * Added support for opening in-memory file content. See `include/netcdf_mem.h` for the procedure signature. Basically, it allows one to fill a chunk of memory with the equivalent of some netCDF file and then open it and read from it as if it were any other file. See [NCF-328](https://bugtracking.unidata.ucar.edu/browse/NCF-328) for more information.
561 
562 * Addressed an issue when reading hdf4 files with explicit little-endian datatypes. This issue was [reported by Tim Burgess at GitHub](https://github.com/Unidata/netcdf-c/issues/113). See [NCF-332](https://bugtracking.unidata.ucar.edu/browse/NCF-332) for more information.
563 
564 * Addressed an issue with IBM's `XL C` compiler on AIX and how it handled some calls to malloc. Also, as suggested by Wolfgang Hayek, developers using this compiler may need to pass `CPPFLAGS=-D_LINUX_SOURCE_COMPAT` to avoid some test failures.
565 
566 * Addressed an issure in netcdf4 related to specifying an endianness explicitly. When specifying an endianness for `NC_FLOAT`, the value would appear to not be written to file, if checked with `ncdump -s`. The issue was more subtle; the value would be written but was not being read from file properly for non-`NC_INT`. See [GitHub Issue](https://github.com/Unidata/netcdf-c/issues/112) or [NCF-331](https://bugtracking.unidata.ucar.edu/browse/NCF-331) for more information.
567 
568 * Addressed an issue in netcdf4 on Windows w/DAP related to how byte values were copied with sscanf. Issue originally reported by Ellen Johnson at Mathworks, see [NCF-330](https://bugtracking.unidata.ucar.edu/browse/NCF-330) for more information.
569 
570 * Addressed in issue in netcdf4 files on Windows, built with Microsoft Visual Studio, which could result in a memory leak. See [NCF-329](https://bugtracking.unidata.ucar.edu/browse/NCF-329) for more information.
571 
572 * Addressed an issue in netcdf4 files where writing unlimited dimensions that were not declared at head of the dimensions list, as reported by Ellen Johnson at Mathworks. See [NCF-326](https://bugtracking.unidata.ucar.edu/browse/NCF-326) for more information.
573 
574 * Added an authorization reference document as oc2/ocauth.html.
575 
576 * Fixed bug resulting in segmentation violation when trying to add a
577  _FillValue attribute to a variable in an existing netCDF-4 file
578  defined without it (thanks to Alexander Barth). See
579  [NCF-187](https://bugtracking.unidata.ucar.edu/browse/NCF-187) for
580  more information.
581 
582 ## 4.3.3.1 Released 2015-02-25
583 
584 * Fixed a bug related to renaming the attributes of coordinate variables in a subgroup. See [NCF-325](https://bugtracking.unidata.ucar.edu/browse/NCF-325) for more information.
585 
586 ## 4.3.3 Released 2015-02-12
587 
588 * Fixed bug resulting in error closing a valid netCDF-4 file with a dimension and a non-coordinate variable with the same name. [NCF-324](https://bugtracking.unidata.ucar.edu/browse/NCF-324)
589 
590 * Enabled previously-disabled shell-script-based tests for Visual Studio when `bash` is detected.
591 
592 ### 4.3.3-rc3 Released 2015-01-14
593 
594 * Added functionality to make it easier to build `netcdf-fortran` as part of the `netcdf-c` build for *NON-MSVC* builds. This functionality is enabled at configure time by using the following **Highly Experimental** options:
595 
596  * CMake: `-DENABLE_REMOTE_FORTRAN_BOOTSTRAP=ON`
597  * Autotools: `--enable-remote-fortran-bootstrap`
598 
599 Details are as follows:
600 
601 ----
602 
603 Enabling these options creates two new make targets:
604 
605 * `build-netcdf-fortran`
606 * `install-netcdf-fortran`
607 
608 Example Work Flow from netcdf-c source directory:
609 
610 * $ `./configure --enable-remote-fortran-bootstrap --prefix=$HOME/local`
611 * $ `make check`
612 * $ `make install`
613 * $ `make build-netcdf-fortran`
614 * $ `make install-netcdf-fortran`
615 
616 > These make targets are **only** valid after `make install` has been invoked. This cannot be enforced rigidly in the makefile for reasons we will expand on in the documentation, but in short: `make install` may require sudo, but using sudo will discard environmental variables required when attempting to build netcdf-fortran in this manner.<br><br>
617 
618 > It is important to note that this is functionality is for *convenience only*. It will remain possible to build `netcdf-c` and `netcdf-fortran` manually. These make targets should hopefully suffice for the majority of our users, but for corner cases it may still be required of the user to perform a manual build. [NCF-323](https://bugtracking.unidata.ucar.edu/browse/NCF-323)
619 
620 ----
621 
622 * Added a failure state if the `m4` utility is not found on non-Windows systems; previously, the build would fail when it reached the point of invoking m4.
623 
624 * Added an explicit check in the build systems (autotools, cmake) for the CURL-related option `CURLOPT_CHUNK_BGN_FUNCTION`. This option was introduced in libcurl version `7.21.0`. On installations which require libcurl and have this version, `CURLOPT_CHUNK_BGN_FUNCTION` will be available. Otherwise, it will not.
625 
626 * The PnetCDF support was not properly being used to provide mpi parallel io for netcdf-3 classic files. The wrong dispatch table was being used. [NCF-319](https://bugtracking.unidata.ucar.edu/browse/NCF-319)
627 
628 * In nccopy utility, provided proper default for unlimited dimension in chunk-size specification instead of requiring explicit chunk size. Added associated test. [NCF-321](https://bugtracking.unidata.ucar.edu/browse/NCF-321)
629 
630 * Fixed documentation typo in FILL_DOUBLE definition in classic format specification grammar. Fixed other typos and inconsistencies in Doxygen version of User Guide.
631 
632 * For nccopy and ncgen, added numeric options (-3, -4, -6, -7) for output format, to provide less confusing format version specifications than the error-prone equivalent -k options (-k1, -k2, -k3, -k4). The new numeric options are compatible with NCO's mnemonic version options. The old -k numeric options will still be accepted but are deprecated, due to easy confusion between format numbers and format names. [NCF-314](https://bugtracking.unidata.ucar.edu/browse/NCF-314)
633 
634 * Fixed bug in ncgen. When classic format was in force (k=1 or k=4), the "long" datatype should be treated as int32. Was returning an error. [NCF-318](https://bugtracking.unidata.ucar.edu/browse/NCF-318)
635 
636 * Fixed bug where if the netCDF-C library is built with the HDF5 library but without the HDF4 library and one attempts to open an HDF4 file, an abort occurs rather than returning a proper error code (NC_ENOTNC). [NCF-317](https://bugtracking.unidata.ucar.edu/browse/NCF-317)
637 
638 * Added a new option, `NC_EXTRA_DEPS`, for cmake-based builds. This is analogous to `LIBS` in autotools-based builds. Example usage:
639 
640  $ cmake .. -NC_EXTRA_DEPS="-lcustom_lib"
641 
642 More details may be found at the Unidata JIRA Dashboard. [NCF-316](https://bugtracking.unidata.ucar.edu/browse/NCF-316)
643 
644 
645 ### 4.3.3-rc2 Released 2014-09-24
646 
647 * Fixed the code for handling character constants
648  in datalists in ncgen. Two of the problems were:
649  1. It failed on large constants
650  2. It did not handle e.g. var = 'a', 'b', ...
651  in the same way that ncgen3 did.
652  See [NCF-309](https://bugtracking.unidata.ucar.edu/browse/NCF-309).
653 
654 * Added a new file, `netcdf_meta.h`. This file is generated automatically at configure time and contains information related to the capabilities of the netcdf library. This file may be used by projects dependent upon `netcdf` to make decisions during configuration, based on how the `netcdf` library was built. The macro `NC_HAVE_META_H` is defined in `netcdf.h`. Paired with judicious use of `ifdef`'s, this macro will indicate to developers whether or not the meta-header file is present. See [NCF-313](https://bugtracking.unidata.ucar.edu/browse/NCF-313).
655 
656  > Determining the presence of `netcdf_meta.h` can also be accomplished by methods common to autotools and cmake-based build systems.
657 
658 * Changed `Doxygen`-generated documentation hosted by Unidata to use more robust server-based searching.
659 * Corrected embedded URLs in release notes.
660 * Corrected an issue where building with HDF4 support with Visual Studio would fail.
661 
662 ### 4.3.3-rc1 Released 2014-08-25
663 
664 * Added `CMake`-based export files, contributed by Nico Schlömer. See https://github.com/Unidata/netcdf-c/pull/74.
665 
666 * Documented that ncgen input can come from standard input.
667 
668 * Regularized generation of libnetcdf.settings file to make parsing it easier.
669 
670 * Fixed ncdump bug for char variables with multiple unlimited dimensions and added an associated test. Now the output CDL properly disambiguates dimension groupings, so that ncgen can generate the original file from the CDL. [NCF-310](https://bugtracking.unidata.ucar.edu/browse/NCF-310)
671 
672 * Converted the [Manually-maintained FAQ page](https://docs.unidata.ucar.edu/netcdf-c/current/faq.html) into markdown and added it to the `docs/` directory. This way the html version will be generated when the rest of the documentation is built, the FAQ will be under version control, and it will be in a more visible location, hopefully making it easier to maintain.
673 
674 * Bumped minimum required version of `cmake` to `2.8.12`. This was necessitated by the adoption of the new `CMAKE_MACOSX_RPATH` property, for use on OSX.
675 
676 * Jennifer Adams has requested a reversion in behavior so that all dap requests include a constraint. Problem is caused by change in prefetch where if all variables are requested, then no constraint is generated. Fix is to always generate a constraint in prefetch.
677  [NCF-308](https://bugtracking.unidata.ucar.edu/browse/NCF-308)
678 
679 * Added a new option for cmake-based builds, `ENABLE_DOXYGEN_LATEX_OUTPUT`. On those systems with `make` and `pdflatex`, setting this option **ON** will result in pdf versions of the documentation being built. This feature is experimental.
680 
681 * Bumped minimum CMake version to `2.8.9` from `2.8.8` as part of a larger pull request contributed by Nico Schlömer. [Pull Request #64](https://github.com/Unidata/netcdf-c/pull/64)
682 
683 * Replaced the `NetCDF Library Architecture` image with an updated version from the 2012 NetCDF Workshop slides.
684 
685 * Fix HDF4 files to support chunking.
686  [NCF-272](https://bugtracking.unidata.ucar.edu/browse/NCF-272)
687 
688 * NetCDF creates a `libnetcdf.settings` file after configuration now, similar to those generated by `HDF4` and `HDF5`. It is installed into the same directory as the libraries. [NCF-303](https://bugtracking.unidata.ucar.edu/browse/NCF-303).
689 
690 
691 * Renamed `man4/` directory to `docs/` to make the purpose and contents clearer. See [man4 vs. docs #60](https://github.com/Unidata/netcdf-c/issues/60).
692 
693 * Removed redundant variable `BUILD_DOCS` from the CMake configuration file. See the issue at github: [#59](https://github.com/Unidata/netcdf-c/issues/59).
694 
695 * Added missing documentation templates to `man4/Makefile.am`, to correct an issue when trying to build the local `Doxygen`-generated documentation. This issue was reported by Nico Schlömer and may be viewed on github. [Releases miss Doxygen files #56](https://github.com/Unidata/netcdf-c/issues/56)
696 
697 * When the NC_MPIPOSIX flag is given for parallel I/O access and the HDF5 library does not have the MPI-POSIX VFD configured in, the NC_MPIPOSIX flag is transparently aliased to the NC_MPIIO flag within the netCDF-4 library.
698 
699 ## 4.3.2 Released 2014-04-23
700 
701 * As part of an ongoing project, the Doxygen-generated netcdf documentation has been reorganized. The goal is to make the documentation easier to parse, and to eliminate redundant material. This project is ongoing.
702 
703 * The oc .dodsrc reader was improperly handling the user name and password entries. [NCF-299](https://bugtracking.unidata.ucar.edu/browse/NCF-299)
704 
705 * CTestConfig.cmake has been made into a template so that users may easily specify the location of an alternative CDash-based Dashboard using the following two options:
706 
707  * `NC_TEST_DROP_SITE` - Specify an alternative Dashboard by URL or IP address.
708 
709  * `NC_CTEST_DROP_LOC_PREFIX` - Specify a prefix on the remote webserver relative to the root directory. This lets CTest accommodate dashboards that do not live at the top level of the web server.
710 
711 * Return an error code on open instead of an assertion violation for truncated file.
712 
713 * Documented limit on number of Groups per netCDF-4 file (32767).
714 
715 ### 4.3.2-rc2 Released 2014-04-15
716 
717 * Cleaned up a number of CMake inconsistencies related to CMake usage, parallel builds.
718 * Now passing -Wl,--no-undefined to linker when appropriate.
719 * Corrected an issue preventing large file tests from running correctly under Windows.
720 * Misc Bug Fixes detected by static analysis.
721 
722 ### 4.3.2-rc1 Released 2014-03-20
723 
724 * Pre-built Windows downloads will now be bundled with the latest (as of the time of this writing) versions of the various dependencies:
725  * `hdf5: 1.8.12`
726  * `zlib: 1.2.8`
727  * `libcurl: 7.35.0`
728 
729 * Added a separate flag to enable DAP AUTH tests. These tests are disabled by default. The flags for autotools and CMAKE-based builds are (respectively):
730  * --enable-dap-auth-tests
731  * -DENABLE\_DAP\_AUTH\_TESTS
732 
733 * Fixed small default chunk size for 1-dimensional record variables. [NCF-211](https://bugtracking.unidata.ucar.edu/browse/NCF-211)
734 
735 * Cleaned up type handling in netCDF-4 to fix bugs with fill-values.
736 
737 * Corrected "BAIL" macros to avoid infinite loop when logging is disabled and an error occurs.
738 
739 * Refactored how types are used for attributes, variables, and committed types, clarifying and categorizing fields in structs, and eliminating duplicated type information between variables and types they use.
740 
741 * Made type structure shareable by committed datatypes and variables that use it.
742 
743 * Handled string datatypes correctly, particularly for fill value attributes. Expanded testing for string fill values.
744 
745 * Simplified iteration of objects in the file when it's opened, tracking fewer objects and using less memory.
746 
747 * Enabled netCDF-4 bit-for-bit reproducibility for nccopy and other applications (thanks to Rimvydas Jasinskas and Quincey Koziol) by turning off HDF5 object creation, access, and modification time tracking. [NCF-290](https://bugtracking.unidata.ucar.edu/browse/NCF-290)
748 
749 * Addressed an issue where `cmake`-based builds would not properly create a `pkg-config` file. This file is now created properly by `cmake`. [NCF-288](https://bugtracking.unidata.ucar.edu/browse/NCF-288)
750 
751 * Addressed an issue related to old DAP servers. [NCF-287](https://bugtracking.unidata.ucar.edu/browse/NCF-287)
752 
753 * Modified nc_{get/put}_vars to no longer use
754  nc_get/put_varm. They now directly use nc_get/put_vara
755  directly. This means that nc_get/put_vars now work
756  properly for user defined types as well as atomic types.
757  [NCF-228] (https://bugtracking.unidata.ucar.edu/browse/NCF-228)
758 
759 ## 4.3.1.1 Released 2014-02-05
760 
761 This is a bug-fix-only release for version 4.3.1.
762 
763 * Corrected a DAP issue reported by Jeff Whitaker related to non-conforming servers.
764 
765 * Corrected an issue with DAP tests failing in a 64-bit Cygwin environment. [NCF-286](https://bugtracking.unidata.ucar.edu/browse/NCF-286)
766 
767 ## 4.3.1 Released 2014-01-16
768 
769 * Add an extended format inquiry method to the netCDF API: nc\_inq\_format\_extended. NC\_HAVE\_INQ\_FORMAT\_EXTENDED is defined in netcdf.h [NCF-273]
770 
771 [NCF-273]:https://bugtracking.unidata.ucar.edu/browse/NCF-273
772 
773 
774 ### 4.3.1-rc6 Released 2013-12-19
775 
776 * Fixed fill value handling for string types in nc4\_get\_vara().
777 
778 * Corrected behavior of nc\_inq\_unlimdim and nv\_inq\_unlimdims to report dimids
779  in same order as nc\_inq\_dimids.
780 
781 * Addressed an issue reported by Jeff Whitaker regarding `nc_inq_nvars` returning an incorrect number of dimensions (this issue was introduced in 4.3.1-rc5). Integrated a test contributed by Jeff Whitaker.
782 
783 * A number of previously-disabled unit tests were reviewed and made active.
784 
785 
786 ### 4.3.1-rc5 Released 2013-12-06
787 
788 * When opening a netCDF-4 file, streamline the iteration over objects in the underlying HDF5 file.
789 
790 * Fixed netCDF-4 failure when renaming a dimension and renaming a variable using that dimension, in either order. [NCF-177]
791 
792 [NCF-177]:https://bugtracking.unidata.ucar.edu/browse/NCF-177
793 
794 * When compiling with `hdf4` support, both autotools and cmake-based builds now properly look for the `libjpeg` dependency and will link against it when found (or complain if it's not). Also added `ENABLE_HDF4_FILE_TESTS` option to CMake-based builds.
795 
796 * Fixed bug in ncgen; it was not properly filling empty string constants ("") to be the proper length. [NCF-279]
797 
798 [NCF-279]:https://bugtracking.unidata.ucar.edu/browse/NCF-279
799 
800 * Fixed bug in ncgen where it was interpreting int64 constants
801  as uint64 constants. [NCF-278]
802 
803 [NCF-278]:https://bugtracking.unidata.ucar.edu/browse/NCF-278
804 
805 * Fixed bug in handling Http Basic Authorization. The code was actually there but was not being executed. [NCF-277]
806 
807 [NCF-277]:https://bugtracking.unidata.ucar.edu/browse/NCF-277
808 
809 * Added hack to the DAP code to address a problem with the Columbia.edu server. That server does not serve up proper DAP2 DDS replies. The Dataset {...} name changes depending on if the request has certain kinds of constraints. [NCF-276]
810 
811 [NCF-276]:https://bugtracking.unidata.ucar.edu/browse/NCF-276
812 
813 * Fixed bugs with ncdump annotation of values, using -b or -f
814  options. [NCF-275]
815 
816 [NCF-275]:https://bugtracking.unidata.ucar.edu/browse/NCF-275
817 
818 
819 ### 4.3.1-rc4 Released 2013-11-06
820 
821 * Addressed an issue on Windows where `fstat` would report an incorrect file size on files > 4GB. [NCF-219]
822 
823 
824 * Added better documentation about accessing ESG datasets.
825  See https://docs.unidata.ucar.edu/netcdf-c/current/esg.html.
826 
827 * Corrected an issue with CMake-based builds enabling HDF4 support where the HDF4 libraries were in a non-standard location.
828 
829 * Fix bug introduced by [NCF-267] where octal constants above
830 '\177' were not recognized as proper octal constants. [NCF-271]
831 
832 [NCF-271]:https://bugtracking.unidata.ucar.edu/browse/NCF-271
833 
834 * Fixed an issue where the `netcdf.3` man page was not being installed by CMake-based builds. [Github](https://github.com/Unidata/netcdf-c/issues/3)
835 
836 
837 
838 ### 4.3.1-rc3 Released 2013-09-24
839 
840 * Modify ncgen to support NUL characters in character array
841  constants. [NCF-267]
842 
843 [NCF-267]:https://bugtracking.unidata.ucar.edu/browse/NCF-267
844 
845 * Modify ncgen to support disambiguating references to
846  an enum constant in a data list. [NCF-265]
847 
848 [NCF-265]:https://bugtracking.unidata.ucar.edu/browse/NCF-265
849 
850 * Corrected bug in netCDF-4 dimension ID ordering assumptions, resulting in access that works locally but fails through DAP server. [NCF-166]
851 
852 [NCF-166]:https://bugtracking.unidata.ucar.edu/browse/NCF-166
853 
854 * Added a new configuration flag, `NC_USE_STATIC_CRT` for CMake-based Windows builds. The default value is 'OFF'. This will allow the user to define whether to use the shared CRT libraries (\\MD) or static CRT libraries (\\MT) in Visual Studio builds.
855 
856 * Ensure netCDF-4 compiles with OpenMPI as an alternative to MPICH2. [NCF-160]
857 
858 [NCF-160]:https://bugtracking.unidata.ucar.edu/browse/NCF-160
859 
860 * Addressed issue with hanging Parallel netCDF-4 using HDF5 1.8.10. [NCF-240]
861 
862 [NCF-240]:https://bugtracking.unidata.ucar.edu/browse/NCF-240
863 
864 * Addressed issue with Large File Support on Windows, using both 32 and 64-bit builds. [NCF-219]
865 
866 [NCF-219]:https://bugtracking.unidata.ucar.edu/browse/NCF-219
867 
868 * Removed deprecated directories:
869  * librpc/
870  * udunits/
871  * libcf/
872  * libcdmr/
873 
874 ### 4.3.1-rc2 Released 2013-08-19
875 
876 * Added `configure` and accompanying configuration files/templates to release repository. **These will only be added to tagged releases on GitHub**.
877 
878 * Integrated a fix by Quincey Koziol which addressed a variation of [NCF-250], *Fix issue of netCDF-4 parallel independent access with unlimited dimension hanging*.
879 
880 [NCF-250]:https://bugtracking.unidata.ucar.edu/browse/NCF-250
881 
882 * Integrated change contributed by Orion Poplawski which integrated GNUInstallDirs into the netCDF-C CMake system; this will permit systems that install into lib64 (such as Fedora) to `make install` without problem.
883 
884 * Corrected an error with the CMake config files that resulted in the `netcdf.3` manpage not being built or installed.
885 
886 ### 4.3.1-rc1 Released 2013-08-09
887 
888 * Migrated from the netCDF-C `subversion` repository to a publicly available GitHub repository available at https://github.com/Unidata/netCDF-C. This repository may be checked out (cloned) with the following command:
889 
890  $ git clone https://github.com/Unidata/netCDF-C.git
891 
892 * Note: in this release, it is necessary to generate the `configure` script and makefile templates using `autoreconf` in the root netCDF-C directory.:
893 
894  $ autoreconf -i -f
895 
896 * Added `nc_rename_grp` to allow for group renaming in netCDF-4 files. [NCF-204]
897 
898 [NCF-204]: https://bugtracking.unidata.ucar.edu/browse/NCF-204
899 
900 * Added a `NC_HAVE_RENAME_GRP` macro to netcdf.h, [as per a request by Charlie Zender][cz1]. This will allow software compiling against netcdf to easily query whether or not nc\_rename\_grp() is available.
901 
902 [cz1]: https://bugtracking.unidata.ucar.edu/browse/NCF-204
903 
904 * Added Greg Sjaardema's contributed optimization for the nc4\_find\_dim\_len function in libsrc4/nc4internal.c. The patch eliminates several malloc/free calls that exist in the original coding.
905 
906 * Added support for dynamic loading, to compliment the dynamic loading support introduced in hdf 1.8.11. Dynamic loading support depends on libdl, and is enabled as follows: [NCF-258]
907  * autotools-based builds: --enable-dynamic-loading
908  * cmake-based builds: -DENABLE\_DYNAMIC\_LOADING=ON
909 
910 [NCF-258]: https://bugtracking.unidata.ucar.edu/browse/NCF-258
911 
912 * Fix issue of netCDF-4 parallel independent access with unlimited dimension hanging. Extending the size of an unlimited dimension in HDF5 must be a collective operation, so now an error is returned if trying to extend in independent access mode. [NCF-250]
913 
914 [NCF-250]: https://bugtracking.unidata.ucar.edu/browse/NCF-250
915 
916 * Fixed bug with netCDF-4's inability to read HDF5 scalar numeric attributes. Also allow, in addition to zero length strings, a new NULL pointer as a string value. to improve interoperability with HDF5. This required a new CDL constant, 'NIL', that can be output from ncdump for such a string value in an HDF5 or netCDF-4 file. The ncgen utility was also modified to properly handle such NIL values for strings. [NCF-56]
917 
918 [NCF-56]: https://bugtracking.unidata.ucar.edu/browse/NCF-56
919 
920 * Parallel-build portability fixes, particularly for OpenMPI and gcc/gfortran-4.8.x on OSX.
921 
922 * Fix contributed by Nath Gopalaswamy to large file problem reading netCDF classic or 64-bit offset files that have a UINT32_MAX flag for large last record size of a variable that has values larger than 1 byte. This problem had previously been fixed for *writing* such data, but was only tested with an ncbyte variable.
923 
924 * Fixed various minor documentation problems.
925 
926 ## 4.3.0 Released 2013-04-29
927 
928 * fsync: Changed default in autotools config file; fsync must now be
929 explicitly enabled instead of explicitly disabled. [NCF-239]
930 
931 [NCF-239]: https://bugtracking.unidata.ucar.edu/browse/NCF-239
932 
933 * Fixed netCDF-4 bug where odometer code for libdap2 mishandled stride > 1. Bug reported by Ansley Manke. [NCF-249]
934 
935 [NCF-249]: https://bugtracking.unidata.ucar.edu/browse/NCF-249
936 
937 * Fixed netCDF-4 bug so netCDF just ignores objects of HDF5 reference type in
938 the file, instead of rejecting the file. [NCF-29]
939 
940 [NCF-29]: https://bugtracking.unidata.ucar.edu/browse/NCF-29
941 
942 * Fixed netCDF-4 bug with particular order of creation of dimensions,
943 coordinate variables, and subgroups resulting in two dimensions with the
944 same dimension ID. [NCF-244]
945 
946 [NCF-244]: https://bugtracking.unidata.ucar.edu/browse/NCF-244
947 
948 * Fixed netCDF-4 bug with a multidimensional coordinate variable in a
949 subgroup getting the wrong dimension IDs for its dimensions. [NCF-247]
950 
951 [NCF-247]: https://bugtracking.unidata.ucar.edu/browse/NCF-247
952 
953 * Fixed bug with incorrect fixed-size variable offsets in header getting
954 written when schema changed for files created by PnetCDF Thanks
955 to Wei-keng Liao for developing and contributing the fix. [NCF-234]
956 
957 [NCF-234]: https://bugtracking.unidata.ucar.edu/browse/NCF-234
958 
959 * Fixed bug in handling old servers that do not do proper Grid to
960 Structure conversions. [NCF-232]
961 
962 [NCF-232]: https://bugtracking.unidata.ucar.edu/browse/NCF-232
963 
964 * Replaced the oc library with oc2.0
965 
966 * Fix bug with nc\_get\_var1\_uint() not accepting unsigned ints larger
967 than 2\*\*31. [NCF-226]
968 
969 [NCF-226]: https://bugtracking.unidata.ucar.edu/browse/NCF-226
970 
971 * Fix to convert occurrences of '/' in DAP names to %2f. [NCF-223]
972 
973 [NCF-223]: https://bugtracking.unidata.ucar.edu/browse/NCF-223
974 
975 * Fix bug in netCDF-4 with scalar non-coordinate variables with same name
976 as dimensions. [NCF-222]
977 
978 [NCF-222]: https://bugtracking.unidata.ucar.edu/browse/NCF-222
979 
980 * Fix bug in which calling netCDF-4 functions in which behavior that
981 should not depend on order of calls sometimes produces the wrong
982 results. [NCF-217]
983 
984 [NCF-217]: https://bugtracking.unidata.ucar.edu/browse/NCF-217
985 
986 * Merged in nccopy additions from Martin van Driel to support -g and -v
987 options for specifying which groups or variables are to be copied.
988 [NCF-216]
989 
990 [NCF-216]: https://bugtracking.unidata.ucar.edu/browse/NCF-216
991 
992 * Merged in PnetCDF bugs fixes from Greg Sjaardema. [NCF-214]
993 
994 [NCF-214]: https://bugtracking.unidata.ucar.edu/browse/NCF-214
995 
996 * Modify ncgen so that if the incoming file has a special attribute, then
997 it is used to establish the special property of the netcdf file, but the
998 attribute is not included as a real attribute in the file. [NCF-213].
999 
1000 [NCF-213]: https://bugtracking.unidata.ucar.edu/browse/NCF-213
1001 
1002 * Added library version info to the user-agent string so that the server
1003 logs will be more informative. [NCF-210]
1004 
1005 [NCF-210]: https://bugtracking.unidata.ucar.edu/browse/NCF-210
1006 
1007 * Added work around for bad servers that sometimes sends DAP dataset with
1008 duplicate field names. [NCF-208]
1009 
1010 [NCF-208]: https://bugtracking.unidata.ucar.edu/browse/NCF-208
1011 
1012 * Fixed bug with strided access for NC\_STRING type. [NCF-206]
1013 
1014 [NCF-206]: https://bugtracking.unidata.ucar.edu/browse/NCF-206
1015 
1016 * Prevented adding an invalid \_FillValue attribute to a variable (with
1017 nonmatching type or multiple values), to avoid later error when any
1018 record variable is extended. [NCF-190]
1019 
1020 [NCF-190]: https://bugtracking.unidata.ucar.edu/browse/NCF-190
1021 
1022 * Fix bug in which some uses of vlen within compounds causes HDF5 errors.
1023 [NCF-155]
1024 
1025 [NCF-155]: https://bugtracking.unidata.ucar.edu/browse/NCF-155
1026 
1027 * Fixed ncdump bug in display of data values of variables that use
1028 multiple unlimited dimensions. [NCF-144]
1029 
1030 [NCF-144]: https://bugtracking.unidata.ucar.edu/browse/NCF-144
1031 
1032 * Fix bug in which interspersing def\_var calls with put\_var calls can
1033 lead to corrupt metadata in a netCDF file with groups and inherited
1034 dimensions. [NCF-134]
1035 
1036 [NCF-134]: https://bugtracking.unidata.ucar.edu/browse/NCF-134
1037 
1038 * Building shared libraries works with DAP and netCDF4 functionality.
1039 [NCF-205] [NCF-57]
1040 
1041 [NCF-205]: https://bugtracking.unidata.ucar.edu/browse/NCF-205
1042 [NCF-57]: https://bugtracking.unidata.ucar.edu/browse/NCF-57
1043 
1044 * 32-and-64-bit builds are working under MinGW on Windows. [NCF-112]
1045 
1046 [NCF-112]: https://bugtracking.unidata.ucar.edu/browse/NCF-112
1047 
1048 * Config.h for Windows compiles are included in the build. [NCF-98]
1049 
1050 [NCF-98]: https://bugtracking.unidata.ucar.edu/browse/NCF-98
1051 
1052 * NetCDF-4 dependency on NC\_MAX\_DIMS has been removed. [NCF-71]
1053 
1054 [NCF-71]: https://bugtracking.unidata.ucar.edu/browse/NCF-71
1055 
1056 * 64-bit DLL's are produced on Windows. [NCF-65]
1057 
1058 [NCF-65]: https://bugtracking.unidata.ucar.edu/browse/NCF-65
1059 
1060 * DLL Packaging issues are resolved. [NCF-54]
1061 
1062 [NCF-54]: https://bugtracking.unidata.ucar.edu/browse/NCF-54
1063 
1064 * The CMake build system (with related ctest and cdash systems for
1065 testing) has been integrated into netCDF-C. This allows for Visual
1066 Studio-based builds in addition to gcc-based builds. This requires at
1067 least CMake version 2.8.8. This replaces/supplements the cross-compiled
1068 set of Visual-Studio compatible netCDF libraries introduced in netCDF
1069 4.2.1-rc1.
1070 
1071 ## 4.2.1.1 Released 2012-08-03
1072 
1073 * Patched libdap2/ncdap3.c to fix DAP performance bug remotely accessing large files (> 2GiB).
1074 
1075 * Patched ncdump/dumplib.c to properly escape special characters in CDL output from ncdump for netCDF-4 string data.
1076 
1077 
1078 ### 4.2.1 Released 2012-07-18
1079 
1080 * Added a specific NC\_MMAP mode flag to modify behavior of NC\_DISKLESS.
1081 
1082 * Changed the file protections for NC\_DISKLESS created files to 0666
1083 [NCF-182]
1084 
1085 * Fixed ncdump to report error when an unsupported option is specified.
1086 [NCF-180]
1087 
1088 * Fixed documentation of CDL char constants in Users Guide and ncgen man
1089 page.
1090 
1091 * Fixed memory leak detected by valgrind in one of the HDF5 tests.
1092 
1093 * Fixed problem with \#elif directives in posixio.c revealed by PGI
1094 compilers.
1095 
1096 ### 4.2.1-rc1 Released 2012-06-18
1097 
1098 * Ported static and shared libraries (DLL's) for both 32- and 64-bit
1099 Windows, including support for DAP remote access, with netCDF-3 and
1100 netCDF-4/HDF5 support enabled. The environment for this build is
1101 MSYS/MinGW/MinGW64, but the resulting DLLs may be used with Visual
1102 Studio. [NCF-112] [NCF-54] [NCF-57] [NCF-65]
1103 
1104 * Implemented diskless files for all netCDF formats. For nc\_create(),
1105 diskless operation performs all operations in memory and then optionally
1106 persists the results to a file on close. For nc\_open(), but only for
1107 netcdf classic files, diskless operation caches the file in-memory,
1108 performs all operations on the memory resident version and then writes
1109 all changes back to the original file on close.
1110 [NCF-110][NCF-109][NCF-5]
1111 
1112 * Added MMAP support. If diskless file support is enabled, then it is
1113 possible to enable implementation of diskless files using the operating
1114 system's MMAP facility (if available). The enabling flag is
1115 "--enable-mmap". This is most useful when using nc\_open() and when only
1116 parts of files, a single variable say, need to be read.
1117 
1118 * Added configure flag for --disable-diskless.
1119 
1120 * Added nccopy command-line options to exploit diskless files, resulting
1121 in large speedups for some operations, for example converting unlimited
1122 dimension to fixed size or rechunking files for faster access. Upgraded
1123 doxygen and man-page documentation for ncdump and nccopy utilities,
1124 including new -w option for diskless nccopy, with an example.
1125 
1126 * Modified Makefile to allow for concurrent builds and to support builds
1127 outside the source tree, e.g. 'mkdir build; cd build;
1128 SOURCE-DIR/configure' where SOURCE-DIR is the top-level source
1129 directory.
1130 
1131 * Fixed some netCDF-4 bugs with handling strings in non-netCDF-4 HDF5
1132 files. [NCF-150]
1133 
1134 * Fixed bug using nccopy to compress with shuffling that doesn't compress
1135 output variables unless they were already compressed in the input file.
1136 [NCF-162]
1137 
1138 * Fixed bug in 64-bit offset files with large records, when last record
1139 variable requires more than 2\*\*32 bytes per record. [NCF-164]
1140 
1141 * Fix bug in which passing a NULL path to nc\_open causes failure.
1142 [NCF-173]
1143 
1144 * Fixed ncgen bugs in parsing and handling opaque data.
1145 
1146 * Fixed ncdump bug, not escaping characters special to CDL in enumeration
1147 labels. [NCF-169]
1148 
1149 * Fixed bug reading netCDF int into a C longlong or writing from longlong
1150 to external int on 32-bit platforms with classic format files. The upper
1151 32 bits of the longlong were not cleared on read or used on write.
1152 [NCF-171]
1153 
1154 * Resolved some erroneous returns of BADTYPE errors and RANGE errors due
1155 to conflating C memory types with external netCDF types when accessing
1156 classic or 64-bit offset files. [NCF-172]
1157 
1158 * Fixed bug with ncdump -t interpreting unit attribute without base time
1159 as a time unit. [NCF-175]
1160 
1161 * Changed port for testing remote access test server to increase
1162 reliability of tests.
1163 
1164 * Modified ncio mechanism to support multiple ncio packages, so that it is
1165 possible to have e.g. posixio and memio operating at the same time.
1166 
1167 * Generation of documentation is disabled by default. Use --enable-doxygen
1168 to generate. [NCF-168]
1169 
1170 * Added description of configure flags to installation guide.
1171 
1172 * Clarified documentation of arguments to nc**open() and nc**create() and
1173 their default values.
1174 
1175 * Fixed doxygen installation guide source file to preserve line breaks in
1176 code and scripts. [NCF-174]
1177 
1178 * Cleaned up a bunch of lint issues (unused variables, etc.) and some
1179 similar problems reported by clang static analysis.
1180 
1181 * Updated and fixed pkg-config source file netcdf.pc.in to work with
1182 separated netCDF language-specific packages. Also fixed nc-config to
1183 call nf-config, ncxx-config, and ncxx4-config for for backward
1184 compatibility with use of nc-config in current Makefiles. [NCF-165]
1185 [NCF-179]
1186 
1187 ## 4.2.0 2012-05-01
1188 
1189 * Completely rebuilt the DAP constraint handling. This primarily affects
1190 users who specify a DAP constraint as part of their URL. [NCF-120]
1191 
1192 * Fixed cause of slow nccopy performance on file systems with many records
1193 and large disk block size or many record variables, by accessing data a
1194 record at a time instead of a variable at a time. [NCF-142]
1195 
1196 * Performance improvement to DAP code to support fetching partial
1197 variables into the cache; especially important when using nc\_get\_var()
1198 API. A partial variable is one that has ranges attached to the
1199 projection variables (e.g. x[1:10][20:21]) [NCF-157]
1200 
1201 * Separate the Fortran and C++ libraries and release the C library and
1202 ncdump/ncgen/nccopy without Fortran or C++. [NCF-24]
1203 
1204 * Documentation mostly migrated to Doxygen, from Texinfo. [NCF-26]
1205 
1206 * Properly convert vara start/count parameters to DAP [NCF-105][NCF-106]
1207 
1208 * Fixed major wasted space from previous default variable chunk sizes
1209 algorithm. [NCF-81]
1210 
1211 * Fixed bug in nccopy, in which compression and chunking options were
1212 ignored for netCDF-4 input files. [NCF-79]
1213 
1214 * Fixed bug in ncgen in which large variables (more than 2**18 elements)
1215 duplicates the first 2**18 values into subsequent chunks of data
1216 [NCF-154].
1217 
1218 * Applied Greg Sjaardema's nccopy bug fix, not compressing output
1219 variables f they were not already using compression on the input file
1220 when shuffle specified. [NCF-162]
1221 
1222 * Fixed problem when a URL is provided that contains only a host name.
1223 [NCF-103]
1224 
1225 * Fixed behavior of ncgen flags so that -o => -lb and, in the absence of
1226 any other markers, make the default be -k1 [NCF-158]
1227 
1228 * Created a text INSTALL file for netCDF-4.2 release. [NCF-161]
1229 
1230 * Fixed bug in ncgen for vlen arrays as fields of compound types where
1231 datalists for those types was improperly interpreted [NCF-145] (but see
1232 NCF-155).
1233 
1234 * Improve use of chunk cache in nccopy utility, making it practical for
1235 rechunking large files. [NCF-85]
1236 
1237 * Fixed nccopy bug copying a netCDF-4 file with a chunksize for an
1238 unlimited dimension that is larger than the associated dimension size.
1239 [NCF-139]
1240 
1241 * Fixed nccopy bug when rechunking a netCDF-4 file with a chunkspec option
1242 that doesn't explicitly specify all dimensions. [NCF-140]
1243 
1244 * Fixed bug in netCDF-4 files with non-coordinate variable with the same
1245 name as a dimension. [NCF-141]
1246 
1247 * Incorporated Wei Huang's fix for bug where netCDF-4 sometimes skips over
1248 too many values before adding fill values to an in-memory buffer.
1249 [NCF-143]
1250 
1251 * Fixed ncgen bug with netCDF-4 variable-length constants (H/T to Lynton
1252 Appel). [NCF-145]
1253 
1254 * Incorporated Peter Cao's performance fixes using HDF5 link iterator for
1255 any group with many variables or types. [NCF-148]
1256 
1257 * Incorporated Constantine Khroulev's bug fix for invalid usage of
1258 MPI\_Comm\_f2c in nc\_create\_par. [NCF-135]
1259 
1260 * Fixed turning off fill values in HDF5 layers when NOFILL mode is set in
1261 netCDF-4 API (thanks to Karen Schuchardt). [NCF-151]
1262 
1263 * Fixed bug with scalar coordinate variables in netCDF-4 files, causing
1264 failure with --enable-extra-tests [NCF-149]
1265 
1266 * Cleaned up the definition and use of nulldup. [NCF-92][NCF-93][NCF-94]
1267 
1268 * Fixed various '\#include' bugs. [NCF-91][NCF-96][NCF-127]
1269 
1270 * v2 API functions modified to properly call the external API instead of
1271 directly calling the netcdf-3 functions. [NCF-100]
1272 
1273 * Fixed problem with 64-bit offset format where writing more than 2\*\*31
1274 records resulted in erroneous NC\_EINVALCOORDS error. [NCF-101]
1275 
1276 * Restored original functionality of ncgen so that a call with no flags,
1277 only does the syntax check. [NCF-104]
1278 
1279 * Corrected misc. test bugs [NCF-107]
1280 
1281 * Modified ncdump to properly output various new types (ubyte, ushort,
1282 uint, int64, and uint64). [NCF-111]
1283 
1284 * Fixed incorrect link flag for szip in configure.ac [NCF-116]
1285 
1286 * ncdump -t now properly parses ISO "T" separator in date-time strings.
1287 [NCF-16]
1288 
1289 * ncdump -t "human time" functionality now available for attributes and
1290 bounds variables [NCF-70]
1291 
1292 * In ncdump, add -g option to support selection of groups for which data
1293 is displayed. [NCF-11]
1294 
1295 * Now supports bluefire platform [NCF-52]
1296 
1297 * ncdump now properly displays values of attributes of type NC\_USHORT as
1298 signed shorts [NCF-82]
1299 
1300 * Rename some code files so that there are no duplicate filenames.
1301 [NCF-99]
1302 
1303 * Demonstration of netCDF-4 Performance Improvement with KNMI Data
1304 [NCF-113]
1305 
1306 * Dimension size in classic model netCDF-4 files now allows larger sizes
1307 than allowed for 64-bit offset classic files. [NCF-117]
1308 
1309 * ncdump now reports correct error message when "-x" option specifying
1310 NcML output is used on netCDF-4 enhanced model input. [NCF-129]
1311 
1312 * Fixed bug causing infinite loop in ncdump -c of netCDF-4 file with
1313 subgroup with variables using inherited dimensions. [NCF-136]
1314 
1315 ## 4.1.3 2011-06-17
1316 
1317 * Replace use of --with-hdf5= and other such configure options that
1318 violate conventions and causes build problems. Set environment variables
1319 CPPFLAGS, LDFLAGS, and LD\_LIBRARY\_PATH instead, before running
1320 configure script. [NCF-20]
1321 
1322 * Detect from configure script when szlib is needed [NCF-21]
1323 
1324 * Fix bug that can silently zero out portions of a file when writing data
1325 in nofill mode beyond the end of a file, crossing disk-block boundaries
1326 with region to be written while in-memory buffer is in a specific state.
1327 This bug was observed disabling fill mode using Lustre (or other large
1328 blksize file system) and writing data slices in reverse order on disk.
1329 [NCF-22]
1330 
1331 * Fix bug that prevents netCDF-4/HDF5 files created with netCDF-4.1.2 from
1332 being read by earlier versions of netCDF or HDF5 versions before 1.8.7.
1333 [NCF-23]
1334 
1335 * Fix bug in configure that did not make the search for the xdr library
1336 depend on --enable-dap. [NCF-41]
1337 
1338 * Fix ncgen bug that did not use the value of a \_Format attribute in the
1339 input CDL file to determine the kind of output file created, when not
1340 specified by the -k command-line flag. [NCF-42]
1341 
1342 * Fix ncgen bug, not properly handling unsigned longlong parsing. [NCF-43]
1343 
1344 * Fix DAP client code to suppress variables with names such as "x.y",
1345 which DAP protocol interprets as variable "y" inside container "x". Such
1346 variables will be invisible when accessed through DAP client. [NCF-47]
1347 
1348 * Define uint type for unsigned integer, if not otherwise available.
1349 Symptom was compile error involving uint in putget.c. [NCF-49]
1350 
1351 * Fix username+password handling in the DAP client code. [NCF-50]
1352 
1353 * Add test for handling parallel I/O problem from f77 when user forgets to
1354 turn on one of the two MPI flags. [NCF-60]
1355 
1356 * Resolved "make check" problems when ifort compiler. Some "make install"
1357 problems remain when using MPI and shared libraries. [NCF-61]
1358 
1359 * Fix problem with f90\_def\_var not always handle deflate setting when
1360 compiler was ifort. [NCF-67]
1361 
1362 * Check that either MPIIO or MPIPOSIX flag is set when parallel create or
1363 open is called. Also fix examples that didn't set at least one of these
1364 flags. [NCF-68]
1365 
1366 * Improve documentation on handling client-side certificates [NCF-48]
1367 
1368 * Document that array arguments, except in varm functions, must point to
1369 contiguous blocks of memory. [NCF-69]
1370 
1371 * Get netCDF-4 tests working for DLLs generated with mingw. [NCF-6]
1372 
1373 * Make changes necessary for upgrading to HDF5 1.8.7 [NCF-66]
1374 
1375 ### 4.1.3-rc1 2011-05-06
1376 
1377 * Stop looking for xdr if --disable-dap is used.
1378 
1379 * Don't try to run (some) fortran configure tests on machines with no
1380 fortran.
1381 
1382 * Allow nccopy to rechunk with chunksizes larger than current dimension
1383 lengths.
1384 
1385 * Initial implementation of CDMREMOTE is complete; needs comprehensive
1386 testing.
1387 
1388 ### 4.1.3-beta1 2011-04-29
1389 
1390 * Fixed szlib not linking bug.
1391 
1392 * Fixed dreaded "nofill bug", lurking in netCDF classic since at least
1393 1999. Writing more than a disk block's worth of data that crossed disk
1394 block boundaries more than a disk block beyond the end of file in nofill
1395 mode could zero out recently written earlier data that hadn't yet been
1396 flushed to disk.
1397 
1398 * Changed setting for H5Pset\_libver\_bounds to ensure that all netCDF-4
1399 files can be read by HDF5 1.8.x.
1400 
1401 * Merged libncdap3 and libncdap4 into new libdap2 library. The suffix dap2
1402 now refers to the dap protocol. This is in prep for adding dap4 protocol
1403 support.
1404 
1405 * Took out --with-hdf5 and related options due to high cost of maintaining
1406 this non-standard way of finding libraries.
1407 
1408 ## 4.1.2 2011-03-29
1409 
1410 * Changes in build system to support building dlls on cygwin/mingw32.
1411 
1412 * Changes to fix portability problems and get things running on all test
1413 platforms.
1414 
1415 * Some minor documentation fixes.
1416 
1417 * Fixed opendap performance bug for nc\_get\_vars; required adding
1418 nc\_get\_var{s,m} to the dispatch table.
1419 
1420 * Now check for libz in configure.ac.
1421 
1422 * Fixed some bugs and some performance problems with default chunksizes.
1423 
1424 ### 4.1.2-beta2 2011-01-11
1425 
1426 * Add "-c" option to nccopy to specify chunk sizes used in output in terms
1427 of list of dimension names.
1428 
1429 * Rewrite netCDF-4 attribute put code for a large speedup when writing
1430 lots of attributes.
1431 
1432 * Fix nc-config --libs when static dependent libraries are not installed
1433 in the same directory as netCDF libraries (thanks to Jeff Whitaker).
1434 
1435 * Build shared libraries by default, requiring separate Fortran library.
1436 Static libraries now built only with --disable-shared.
1437 
1438 * Refactor of HDF5 file metadata scan for large speedup in opening files,
1439 especially large files.
1440 
1441 * Complete rewrite of the handling of character datalist constants. The
1442 heuristics are documented in ncgen.1.
1443 
1444 * Eliminate use of NC\_MAX\_DIMS and NC\_MAX\_VARS in ncdump and nccopy,
1445 allocating memory as needed and reducing their memory footprint.
1446 
1447 * Add documentation for new nc\_inq\_path() function.
1448 
1449 * Use hashing to speedup lookups by name for files with lots of dimensions
1450 and variables (thanks to Greg Sjaardema).
1451 
1452 * Add options to nccopy to support uniform compression of variables in
1453 output, shuffling, and fixing unlimited dimensions. Documented in
1454 nccopy.1 man page and User's Guide.
1455 
1456 ### 4.1.2-beta1 2010-07-09
1457 
1458 * Fix "ncdump -c" bug identifying coordinate variables in groups.
1459 
1460 * Fix bug in libsrc/posixio.c when providing sizehint larger than default,
1461 which then doesn't get used (thanks to Harald Anlauf).
1462 
1463 * Fix netCDF-4 bug caused when doing enddef/redef and then defining
1464 coordinate variable out of order.
1465 
1466 * Fixed bug in man4 directory automake file which caused documentation to
1467 be rebuilt after make clean.
1468 
1469 * Turned off HDF5 caching when parallel I/O is in use because of its
1470 memory use.
1471 
1472 * Refactoring of netCDF code with dispatch layer to decide whether to call
1473 netCDF classic, netCDF-4, or opendap version of a function.
1474 
1475 * Refactoring of netCDF-4 memory internals to reduce memory use and end
1476 dependence on NC\_MAX\_DIMS and NC\_MAX\_NAME.
1477 
1478 * Modified constraint parser to be more compatible with a java version of
1479 the parser.
1480 
1481 * Modified ncgen to utilize iterators internally; should be no user
1482 visible effect.
1483 
1484 * Fixed two large-file bugs with using classic format or 64-bit offset
1485 format and accessing multidimensional variables with more than 2\*\*32
1486 values.
1487 
1488 ## 4.1.1 2010-04-01
1489 
1490 * Fixed various build issues.
1491 
1492 * Fixed various memory bugs.
1493 
1494 * Fixed bug for netCDF-4 files with dimensions and coord vars written in
1495 different orders, with data writes interspersed.
1496 
1497 * Added test for HDF5-1.8.4 bug.
1498 
1499 * Added new C++ API from Lynton Appel.
1500 
1501 ## 4.1 2010-01-30
1502 
1503 * Much better memory leak checking with valgrind.
1504 
1505 * Added per-variable chunk cache control for better performance. Use
1506 nc\_set\_var\_chunk\_cache / nf\_set\_var\_chunk\_cache /
1507 nf90\_set\_var\_chunk\_cache to set the per-variable cache.
1508 
1509 * Automatically set per-variable chunk cache when opening a file, or
1510 creating a variable, so that the cache is big enough for more than one
1511 chunk. (Can be overridden by user). Settings may be changed with
1512 configure options --max-default-chunk-size and
1513 --default-chunks-in-cache.
1514 
1515 * Better default chunks size. Now chunks are sized to fit inside the
1516 DEFAULT\_CHUNK\_SIZE (settable at configure time with
1517 --with-default-chunk-size= option.)
1518 
1519 * Added nccopy utility for converting among netCDF format variants or to
1520 copy data from DAP servers to netCDF files.
1521 
1522 * The oc library has been modified to allow the occurrence of alias
1523 definitions in the DAS, but they will be ignored.
1524 
1525 * The old ncgen has been moved to ncgen3 and ncgen is now the new ncgen4.
1526 
1527 * Modified --enable-remote-tests to be on by default.
1528 
1529 * Fixed the nc\_get\_varm code as applied to DAP data sources.
1530 
1531 * Added tests for nc-config.
1532 
1533 * Many documentation fixes.
1534 
1535 * Added capability to use the PnetCDF library to
1536 perform parallel I/O on classic and 32-bit offset files. Use the
1537 NC\_PNETCDF mode flag to get parallel I/O for non-netcdf-4 files.
1538 
1539 * Added libcf library to netCDF distribution. Turn it on with configure
1540 option --with-libcf.
1541 
1542 * Added capability to read HDF4 files created with the SD (Scientific
1543 Data) API.
1544 
1545 * The DAP support was revised to closely mimic the original libnc-dap
1546 support.
1547 
1548 * Significantly revised the data handling mechanism in ncgen4 to more
1549 closely mimic the output from the original ncgen.
1550 
1551 * Added prototype NcML output capability to ncgen4. It is specified by the
1552 -lcml flag.
1553 
1554 * Added capability to read HDF5 files without dimension scales. This will
1555 allow most existing HDF5 datasets to be read by netCDF-4.
1556 
1557 * Fixed bug with endianness of default fill values for integer types when
1558 variables are created with a non-native endianness and use the default
1559 fill value.
1560 
1561 * Significant refactoring of HDF5 type handling to improve performance and
1562 handle complicated nesting of types in cross-platform cases.
1563 
1564 * Added UDUNITS2 to the distribution. Use --with-udunits to build udunits
1565 along with netcdf.
1566 
1567 * Made changes suggested by HDF5 team to relax creation-order requirement
1568 (for read-only cases) which allows HDF5 1.6.x files to be retrofitted
1569 with dimension scales, and be readable to netCDF-4.
1570 
1571 * Handle duplicate type names within different groups in ncdump. Fix group
1572 path handling in absolute and relative variable names for "-v" option.
1573 
1574 * Added nc-config shell script to help users build netCDF programs without
1575 having to figure out all the compiler options they will need.
1576 
1577 * Fixed ncdump -s bug with displaying special attributes for classic and
1578 64-bit offset files.
1579 
1580 * For writers, nc\_sync() now calls fsync() to flush data to disk sooner.
1581 
1582 * The nc\_inq\_type() function now works for primitive types.
1583 
1584 ## 4.0.1 2009-03-26
1585 
1586 * Added optional arguments to F90 API to nf90\_open/create,
1587 nf90\_create\_var, and nf90\_inquire\_variable so that all netCDF-4
1588 settings may be accomplished with optional arguments, instead of
1589 separate function calls.
1590 
1591 * Added control of HDF5 chunk cache to allow for user performance tuning.
1592 
1593 * Added parallel example program in F90.
1594 
1595 * Changed default chunking to better handle very large variables.
1596 
1597 * Made contiguous the default for fixed size data sets with no filters.
1598 
1599 * Fixed bug in nc\_inq\_ncid; now it returns NC\_ENOGRP if the named group
1600 is not found.
1601 
1602 * Fixed man pages for C and F77 so that netCDF-4 builds will result in man
1603 pages that document new netCDF-4 functions.
1604 
1605 * Added OPeNDAP support based on a new C-only implementation. This is
1606 enabled using --enable-dap option and requires libcurl. The configure
1607 script will attempt to locate libcurl, but if it fails, then its
1608 location must be specified by the --with-curl option.
1609 
1610 ### 4.0.1-beta2 2008-12-26
1611 
1612 * Changed chunksizes to size\_t from int.
1613 
1614 * Fixed fill value problem from F77 API.
1615 
1616 * Fixed problems in netcdf-4 files with multi-dimensional coordinate
1617 variables.
1618 
1619 * Fixed ncgen to properly handle CDL input that uses Windows line endings
1620 ("\r\n"), instead of getting a syntax error.
1621 
1622 * Added "-s" option to ncdump to display performance characteristics of
1623 netCDF-4 files as special virtual attributes, such as \_Chunking,
1624 \_DeflateLevel, \_Format, and \_Endianness.
1625 
1626 * Added "-t" option to ncdump to display times in human readable form as
1627 strings. Added code to interpret "calendar" attribute according to CF
1628 conventions, if present, in displaying human-readable times.
1629 
1630 * Added experimental version of ncgen4 capable of generating netcdf-4 data
1631 files and C code for creating them. In addition, it supports the special
1632 attributes \_Format, etc.
1633 
1634 * 4.0.1-beta1 2008-10-16
1635 
1636 * Fixed Fortran 90 int64 problems.
1637 
1638 * Rewrote HDF5 read/write code in accordance with performance advice from
1639 Kent.
1640 
1641 * Fixed memory leaks in gets/puts of HDF5 data.
1642 
1643 * Fixed some broken tests for parallel I/O (i.e. MPI) builds.
1644 
1645 * Fixed some cross-compile problems.
1646 
1647 * Rewrote code which placed bogus errors on the HDF5 error stack, trying
1648 to open non-existent attributes and variables. Now no HDF5 errors are
1649 seen.
1650 
1651 * Removed man subdirectory. Now man4 subdirectory is used for all builds.
1652 
1653 * Changed build so that users with access to parallel make can use it.
1654 
1655 * Added experimental support for accessing data through OPeNDAP servers
1656 using the DAP protocol (use --enable-opendap to build it).
1657 
1658 * Fixed ncdump bugs with array field members of compound type variables.
1659 Fixed ncdump bug of assuming default fill value for data of type
1660 unsigned byte.
1661 
1662 ## 4.0 2008-05-31
1663 
1664 * Introduced the use of HDF5 as a storage layer, which allows use of
1665 groups, user-defined types, multiple unlimited dimensions, compression,
1666 data chunking, parallel I/O, and other features. See the netCDF Users
1667 Guide for more information.
1668 
1669 ## 3.6.3 2008-05-31
1670 
1671 * In ncdump and ncgen, added CDL support for UTF-8 encoding of characters
1672 in names and for escaped special chars in names. Made sure UTF-8 names
1673 are normalized using NFC rules before storing or comparing.
1674 
1675 * Handle IEEE NaNs and infinities in a platform-independent way in ncdump
1676 output.
1677 
1678 * Added support for ARM representation of doubles, (thanks to Warren
1679 Turkal).
1680 
1681 * Fixed bug in C++ API creating 64-bit offset files. (See
1682 https://docs.unidata.ucar.edu/netcdf-c/current/known_problems.html#cxx_64-bit).
1683 
1684 * Fixed bug for variables larger than 4 GB. (See
1685 https://docs.unidata.ucar.edu/netcdf-c/current/known_problems.html#large_vars_362).
1686 
1687 * Changed the configure.ac to build either 3.6.x or 4.x build from the
1688 same configure.ac.
1689 
1690 * Build now checks gfortran version and handles it cleanly, also Portland
1691 Group in Intel fortran, with various configurations.
1692 
1693 * A Fortran netcdf.inc file is now created at build time, based on the
1694 setting of --disable-v2.
1695 
1696 * Documentation has been fixed in several places.
1697 
1698 * Upgraded to automake 1.10, autoconf 2.62, and libtool 2.2.2.
1699 
1700 * Includes missing Windows Visual Studio build files.
1701 
1702 * Fixed missing include of config.h in a C++ test program.
1703 
1704 * Fixed maintainer-clean in man directory.
1705 
1706 * Fixed --enable-c-only and make check.
1707 
1708 * Fixed behavior when opening a zero-length file.
1709 
1710 * Many portability enhancements to build cleanly on various platforms.
1711 
1712 * Turned on some old test programs which were not being used in the build.
1713 
1714 ## 3.6.2 2007-03-05
1715 
1716 * Released.
1717 
1718 ### 3.6.2 beta6 2007-01-20
1719 
1720 * Fine tuning of build system to properly handle cygwin, Mingw, and
1721 strange configuration issues.
1722 
1723 * Automake 1.10 has a problem with running our tests on MinGW, so I'm
1724 switching back to automake 1.9.6 for this release.
1725 
1726 ### 3.6.2 beta5 2006-12-30
1727 
1728 * Now netCDF configuration uses autoconf 2.61, and automake 1.10. (Thanks
1729 to Ralf Wildenhues for the patches, and all the autotools help in
1730 general!)
1731 
1732 * Final major revision of netCDF tutorial before the 3.6.2 release.
1733 
1734 * Now netCDF builds under MinGW, producing a windows DLL with the C and
1735 F77 APIs. Use the --enable-shared --enable-dll --disable-cxx
1736 --disable-f90 flags to configure. (C++ and F90 have never been built as
1737 windows DLLs, but might be in a future release if there is user
1738 interest). This has all been documented in the netCDF Porting and
1739 Installation Guide.
1740 
1741 * Now extreme numbers (i.e. those close to the limits of their type) can
1742 be turned off in nc\_test/nf\_test, with --disable-extreme-numbers. It
1743 is turned off automatically for Solaris i386 systems.
1744 
1745 * Added --enable-c-only option to configure. This causes only the core
1746 netCDF-3 C library to be built. It's the same as --disable-f77
1747 --disable-cxx --disable-v2 --disable-utilities.
1748 
1749 * Added --disable-utilities to turn off building and testing of
1750 ncgen/ncdump.
1751 
1752 * Fix a long-standing bug in nf90\_get\_att\_text() pointed out by Ryo
1753 Furue, to make sure resulting string is blank-padded on return. This is
1754 fixed in the Fortran-90 interface, but is impractical to fix in the
1755 Fortran-77 interface implemented via cfortran.h.
1756 
1757 * Now large file tests are run if --enable-large-file-tests is used in the
1758 configure.
1759 
1760 * For Cray users, the ffio module is used if the --enable-ffio option is
1761 passed to configure.
1762 
1763 * Unrolled loops in byte-swapping code used on little-endian platforms to
1764 reduce loop overhead. This optimization resulted in a 22% speedup for
1765 some applications accessing floats or ints (e.g. NCO utilities ncap and
1766 ncbo) and a smaller speedup for shorts or doubles.
1767 
1768 * Added "-k" option to ncdump and ncgen, for identifying and specifying
1769 the kind of netCDF file, one of "classic", "64-bit-offset", "hdf5", or
1770 "hdf5-nc3". Removed output of kind of netCDF file in CDL comment
1771 produced by ncdump.
1772 
1773 * Fixed bug of ncdump seg-faulting if invoked incorrectly with option like
1774 "-c" or "-h" but no file name.
1775 
1776 ### 3.6.2 beta4 2006-08-15
1777 
1778 * Changed F77/F90 man pages from netcdf.3f and netcdf.3f90 to
1779 netcdf\_f77.3 and netcdf\_f90.3. Also fixed broken install of man pages.
1780 
1781 * Changed configure script so that "-g -O2" is no longer set as CFLAGS,
1782 CXXFLAGS, and FFLAGS by default if a GNU compiler is being used. Now
1783 nothing is set.
1784 
1785 * Changed configure script so that fortran flag is set in config.h.
1786 
1787 * Updated Installation and Porting Guide, C++ Interface Guide, F77 and F90
1788 Interface Guides.
1789 
1790 * Build with static libraries by default.
1791 
1792 * Added configure option --enable-separate-fortran, which causes the
1793 fortran library to be built separately. This is turned on automatically
1794 for shared libraries.
1795 
1796 * Improved clarity of error messages.
1797 
1798 * Changed configuration to get cygwin DLL and mingw DLL builds working,
1799 for the C library only (i.e. no F77, F90, or C++ APIs).
1800 
1801 * Changed type of ncbyte in C++ interface from unsigned char to signed
1802 char, for consistency with C interface. The C++ documentation warned
1803 this change would eventually occur.
1804 
1805 * Changed the C++ interface to use only the netCDF-3 C interface instead
1806 of the older netCDF-2 C interface. This has the added benefit that
1807 on-the-fly numeric conversions are now supported using get methods, for
1808 example you can get data of any type as double. When using --disable-v2
1809 flag to configure, the C++ interface can now be built and installed.
1810 
1811 ### 3.6.2 beta3 2006-05-24
1812 
1813 * Changed to use default prefix of /usr/local instead of package-based
1814 prefix of previous releases of netCDF. Use the --prefix argument to the
1815 configure script to override the default.
1816 
1817 * Made separate fortran library file, instead of appending fortran library
1818 functions to the C library file, if --enable-separate-fortran is used
1819 during configure (it's turned on automatically if --enable-shared is
1820 used). If uses, the fortran API users must link to *both* the C library
1821 and the new fortran library, like this: -lnetcdff -lnetcdf
1822 
1823 * Added netCDF examples in C, C++, F77, F90, and CDL. See the examples
1824 subdirectory.
1825 
1826 * Added the NetCDF Tutorial.
1827 
1828 * Minor fixes to some of the netCDF documentation.
1829 
1830 * Made it possible to build without V2 API using --disable-v2 from
1831 configure.
1832 
1833 * Switched to new build system, with automake and libtool. Now shared
1834 libraries are built (as well as static ones) on platforms which support
1835 it. For more information about shared libraries, see
1836 https://docs.unidata.ucar.edu/netcdf-c/current/faq.html#shared_intro
1837 
1838 * Fixed ncdump crash that happened when no arguments were used.
1839 
1840 * Fixed for building with gfortran 4.1.0.
1841 
1842 * Important fix for machines whose SIZEOF\_SIZE\_T != SIZEOF\_LONG, such
1843 as NEC-SX, thanks to Stephen Leak.
1844 
1845 * Fixed C++ on AIX platform.
1846 
1847 * Fixed 64-bit builds on AIX platform.
1848 
1849 * Removed bad assertion that could be triggered in rare cases when reading
1850 a small file.
1851 
1852 * Added comments in v1hpg.c to clarify purpose of each internal function.
1853 
1854 * Make sure filesize is determined in nc\_close() *after* buffers get
1855 flushed.
1856 
1857 * Fix long-standing problem resulting in files up to 3 bytes longer than
1858 necessary if there is exactly one record variable of type byte, char, or
1859 short and if the number of values per record for that variable is not
1860 divisible by 4 (or 2 in the case of short). Now the filesize determined
1861 from header info by NC\_calcsize should be correct in all cases.
1862 
1863 ## 3.6.1 2006-01-31
1864 
1865 * Updated installation manual for 3.6.1.
1866 
1867 * Changed installation to try to provide correct compiler flags for
1868 compiling in 64-bit mode on Sun, Irix, AIX, and HPUX. (HPUX doesn't work
1869 for me, however). Now run configure with --enable-64bit to get a 64 bit
1870 compile.
1871 
1872 * Fixed long-standing bug that would cause small netCDF files to be padded
1873 on the end with zero bytes to 4096 bytes when they were opened and
1874 changed. Now small files should stay small after you change a value.
1875 
1876 * Fixed bug in assertions in putget.c that would only be noticed if you
1877 change the manifest constant NC\_MAX\_DIMS in netcdf.h to be different
1878 from NC\_MAX\_VAR\_DIMS.
1879 
1880 * Moved test ftest.F from fortran to nf\_test directory, and fixed bug in
1881 ftest.F which caused it to return 0 even if tests failed (no tests were
1882 failing, however). Also renamed some test output files to make things a
1883 little clearer.
1884 
1885 * If open for writing, pad with up to 3 extra zero bytes before close to
1886 the correct canonical length, calculated from the header. Previously
1887 files could be short due to not padding when writing in NOFILL mode.
1888 
1889 * Doubled arbitrary limits on number of dimensions, variables, attributes,
1890 and length of names.
1891 
1892 * Change name of nc\_get\_format() to nc\_inq\_format(). Add analogous
1893 interfaces for nf\_inq\_format(), nf90\_inquire(), and
1894 NcFile::get\_format() to f77, f90, and C++ interfaces. Document new
1895 function in texinfo files. Add minimal test to nc\_test, nf\_test.
1896 
1897 ### 3.6.1-beta3 2005-02-17
1898 
1899 * Added function nc\_get\_format(int ncid, int\* formatp) that returns
1900 either NC\_FORMAT\_CLASSIC or NC\_FORMAT\_64BIT for a CDF1 or CDF2 file,
1901 respectively.
1902 
1903 * Added test to nc\_test that detects whether format version was changed
1904 after a file is reopened and define mode is entered.
1905 
1906 * Correctly configure for Intel ifort Fortran compiler on Linux.
1907 
1908 ### 3.6.0-p1 2005-02-18
1909 
1910 * Fixed bug that changes CDF2 files to CDF1 files if CDF2 file is reopened
1911 for write access and either an attribute is changed or define mode is
1912 entered.
1913 
1914 ### 3.6.1-beta2 2005-1-6
1915 
1916 * Fixed absoft compile problem. Maybe.
1917 
1918 ### 3.6.1-beta1 2005-1-3
1919 
1920 * Fixed Cygwin C++ problem.
1921 
1922 * Fixed large file problem in MS Visual C++.NET environment.
1923 
1924 * More information in installation and porting guide.
1925 
1926 ## 3.6.0 2004-12-16
1927 
1928 * Added texinfo source for the documentation.
1929 
1930 * Added large file tests to Windows directory in distribution.
1931 
1932 * Modified win32 visual studio project files so that m4 is no longer
1933 required to build netcdf under visual studio.
1934 
1935 * Modified rules.make to use install instead of cp, fixing install problem
1936 for cygwin users.
1937 
1938 * Modified configure/install stuff to support HP-UX.
1939 
1940 * Modified configure/install stuff to support G95.
1941 
1942 * In the f90 interface, applied Arnaud Desitter's fixes to correct
1943 mismatches between scalar and array arguments, eliminating (legitimate)
1944 complaints by the NAGWare f95 compiler. Also fixed bugs introduced in
1945 3.6.0-beta5 in the mapped array interfaces.
1946 
1947 ### 3.6.0-beta6 2004-10-05
1948 
1949 * Fixed AIX 64-bit/largefile install problems.
1950 
1951 * Removed FAQ section from netcdf.texi User's Guide, in deference to
1952 online version that can be kept up to date more easily.
1953 
1954 ### 3.6.0-beta5 2004-10-04
1955 
1956 * Fixed assertion violation on 64-bit platforms when size of last fixed
1957 size variable exceeds 2\^32 - 1.
1958 
1959 * Removed another restriction on file size by making record size (derived
1960 from other sizes, not part of the format) an off\_t instead of a
1961 size\_t, when an off\_t is larger than a size\_t. This permits records
1962 to be *much* larger in either classic format or 64-bit-offset format.
1963 
1964 * Incorporated patch from Mathis Rosenhauer to improve performance of
1965 Fortran 90 interface for calls to nf90\_put\_var\_TYPE(),
1966 nf90\_get\_var\_TYPE(), nf90\_put\_vara\_TYPE(), and
1967 nf90\_get\_vara\_TYPE() functions by not emulating them with the
1968 corresponding nf90\_put\_varm\_TYPE() and nf90\_get\_varm\_TYPE() calls.
1969 
1970 * Added tests for invalid offsets in classic format when defining multiple
1971 large variables.
1972 
1973 * Improved installation ease. Have configure script use Large File Support
1974 as a default, if available.
1975 
1976 * Add "extra\_test" as a target for testing Large File Support.
1977 
1978 ### 3.6.0-beta3 2004-08-24
1979 
1980 * Upgraded to recent autoconf, changed configure to (hopefully) improve
1981 installation. Also added macros to deal with large file systems.
1982 
1983 * Added nf\_set\_default\_format to Fortran interface.
1984 
1985 * Added testing to the set\_default\_format functions to nc\_test and
1986 nf\_test.
1987 
1988 * Added documentation to the man page for set\_default\_format functions.
1989 
1990 * Added two new error return codes to C, f77, and f90 interfaces for
1991 invalid dimension size and for bad variable size. Made test for max
1992 dimension size depend on whether 64-bit offsets used. Fixed bug with
1993 dimension sizes between 2\^31 and 2\^32 (for byte variables).
1994 
1995 * Fixed ncdump to properly print dimensions larger than 2\^31.
1996 
1997 * Fixed ncgen to properly handle dimensions between 2\^31 and 2\^32.
1998 
1999 ### 3.6.0-beta2
2000 
2001 * Added -v2 (version 2 format with 64-bit offsets) option to
2002 ncgen, to specify that generated files or generated C/Fortran code
2003 should create 64-bit offset files. Also added -x option to ncgen to
2004 specify use of no-fill mode for fast creation of large files.
2005 
2006 * Added function to set default create mode to C interface
2007 (nc\_set\_default\_create).
2008 
2009 * Added win32 directory, with NET subdirectory to hold .NET port of
2010 netCDF. To use, open netcdf.sln with Visual Studio, and do a clean and
2011 then a build of either the debug or release builds. Tests will be run as
2012 part of the build process. VC++ with managed extensions is required
2013 (i.e. VC++.NET).
2014 
2015 * Added windows installer files to build windows binary installs.
2016 
2017 ### 3.6.0-beta1
2018 
2019 * By incorporating Greg Sjaardema's patch, added support for
2020 64-bit offset files, which remove many of the restrictions relating to
2021 very large files (i.e. larger than 2 GB.) This introduces a new data
2022 format for the first time since the original netCDF format was
2023 introduced. Files in this new 64-bit offset format can't be read by
2024 earlier versions of netCDF. Users should continue to use the netCDF
2025 classic format unless they need to create very large files.
2026 
2027 * The test suite, nc\_test, will now be run twice, once for netCDF classic
2028 format testing, and once for 64-bit offset format testing.
2029 
2030 * The implementation of the Fortran-77 interface has been adapted to
2031 version 4.3 of Burkhard Burow's "cfortran.h".
2032 
2033 ### 3.6.0-alpha
2034 
2035 * Added NEC SX specific optimization for NFILL tunable
2036 parameter in libsrc/putget.c
2037 
2038 Added support for the ifc Fortran-90 compiler creating files "netcdf.d"
2039 and "typesizes.d" (instead of ".mod" files).
2040 
2041 * Fixed access to iargc and getarg functions from Fortran-90 for NAG f90
2042 compiler, contributed by Harald Anlauf.
2043 
2044 ## 3.5.1 2004-02-03
2045 
2046 * Updated INSTALL.html for Mac OS X (Darwin).
2047 
2048 * Made the installation of the netCDF Fortran-90 module file more robust
2049 regarding the name of the file.
2050 
2051 * Added support for eight-byte integers in Fortran90 interface.
2052 
2053 * Increased advisory limits in C netcdf.h and Fortran netcdf.inc for
2054 maximum number of dimensions, variables, and attributes.
2055 
2056 * Changed C++ declarations "friend NcFile" to "friend class NcFile" in
2057 cxx/netcdfcpp.h to conform to standard.
2058 
2059 * Added Dan Schmitt's backward compatible extension to the C++ record
2060 interface to work with arbitrary dimension slices.
2061 
2062 * Added C++ documentation note that caller is responsible for deleting
2063 pointer returned by Variable::values() method when no longer needed.
2064 
2065 * Made C++ interface more standard; the result may not compile on some old
2066 pre-standard C++ compilers.
2067 
2068 * Fixed bug in ncgen when parsing values of a multidimensional char
2069 variable that resulted in failure to pad a value with nulls on IRIX.
2070 
2071 * Fixed ncdump bug adding extra quote to char variable data when using -fc
2072 or -ff option.
2073 
2074 * Fixed so compiling with -DNO\_NETCDF\_2 will work for building without
2075 backward-compatibility netCDF-2 interfaces.
2076 
2077 * Eliminated use of ftruncate(), because it fails on FAT32 file systems
2078 under Linux.
2079 
2080 * Initialized a pointer in putget.m4 (used to generate putget.c) that was
2081 involved in uninitialized memory references when nc\_test is run under
2082 Purify. Two users had reported seeing crashes resulting from this
2083 problem in their applications.
2084 
2085 * Reverted pointer initializations in putget.m4, after testing revealed
2086 these caused a performance problem, resulting in many extra calls to
2087 px\_pgin and px\_pgout when running nc\_test.
2088 
2089 * Added checking of size of "dimids" vector in function
2090 nf90\_inquire\_variable(...) and error-returning if it isn't
2091 sufficiently capacious.
2092 
2093 * Added variable index to ncvarget() and ncattinq() error messages and
2094 attribute name to ncattinq() error message.
2095 
2096 * Tweaked configure script to work with recent C++ compilers.
2097 
2098 * Fixed a memory leak in C++ interface, making sure NcVar::cur\_rec[] gets
2099 deleted in NcVar destructor.
2100 
2101 * Reimplemented nc\_sync() fix of version 3.5.0 to eliminate performance
2102 penalty when synchronization is unnecessary.
2103 
2104 * Changed order of targets in Makefile to build Fortran interface last, as
2105 a workaround for problem with make on AIX platforms.
2106 
2107 ## 3.5.0 2001-03-23
2108 
2109 * Added Fortran 90 interface.
2110 
2111 * Changed C macro TIMELEN in file cxx/nctst.cpp to TIMESTRINGLEN to avoid
2112 clash with macro defined on AIX systems in /usr/include/time.h.
2113 
2114 * Fixed miswriting of netCDF header when exiting define mode. Because the
2115 header was always written correctly later, this was only a problem if
2116 there was another reader of the netCDF file.
2117 
2118 * Fixed explicit synchronizing between netCDF writer and readers via the
2119 nc\_sync(), nf\_sync(), and ncsync() functions.
2120 
2121 * Fixed a number of bugs related to attempts to support shrinking the
2122 header in netCDF files when attributes are rewritten or deleted. Also
2123 fixed the problem that nc\_\_endef() did not work as intended in
2124 reserving extra space in the file header, since the extra space would be
2125 compacted again on calling nc\_close().
2126 
2127 * Fixed the "redef bug" that occurred when nc\_enddef() or nf\_enddef() is
2128 called after nc\_redef() or nf\_redef(), the file is growing such that
2129 the new beginning of a record variable is in the next "chunk", and the
2130 size of at least one record variable exceeds the chunk size (see
2131 netcdf.3 man page for a description of this tuning parameter and how to
2132 set it). This bug resulted in corruption of some values in other
2133 variables than the one being added.
2134 
2135 * The "\*\*" tuning functions for the Fortran interface, nf\*\*create,
2136 nf\*\*open, and nf\*\*enddef, are now documented in the Fortran interface
2137 man pages.
2138 
2139 * Add an 'uninstall' target to all the Makefiles. Dave Glowacki
2140 <dglo@SSEC.WISC.EDU> 199810011851.MAA27335
2141 
2142 * Added support for multiprocessing on Cray T3E. Hooks added by Glenn, but
2143 the majority of the work was done at NERSC. Also includes changes to
2144 ffio option specification. Patch rollup provided by R. K. Owen
2145 <rkowen@Nersc.GOV>. The following functions are added to the public
2146 interface. nc**create\_mp() nc**open\_mp() nc\_set\_base\_pe()
2147 nc\_inq\_base\_pe()
2148 
2149 * Fixed makefile URL for Win32 systems in INSTALL file.
2150 
2151 * Made test for UNICOS system in the configure script case independent.
2152 
2153 * Ported to the following systems: AIX 4.3 (both /bin/xlc and
2154 /usr/vac/bin/xlc compilers) IRIX 6.5 IRIX64 6.5
2155 
2156 * Changed the extension of C++ files from ".cc" to ".cpp". Renamed the C++
2157 interface header file "netcdfcpp.h" instead of "netcdf.hh", changing
2158 "netcdf.hh" to include "netcdfcpp.h" for backward compatibility.
2159 
2160 * Treat "FreeBSD" systems the same as "BSD/OS" system w.r.t. Fortran and
2161 "whatis" database.
2162 
2163 * Corrected manual pages: corrected spelling of "enddef" (was "endef") and
2164 ensured that the words "index" and "format" will be correctly printed.
2165 
2166 * Updated support for Fortran-calling-C interface by updating
2167 "fortran/cfortran.h" from version 3.9 to version 4.1. This new version
2168 supports the Portland Group Fortran compiler (C macro "pgiFortran") and
2169 the Absoft Pro Fortran compiler (C macro "AbsoftProFortran").
2170 
2171 * Corrected use of non-integral-constant-expression in specifying size of
2172 temporary arrays in file "libsrc/ncx\_cray.c".
2173 
2174 * Added Compaq Alpha Linux workstation example to INSTALL file.
2175 
2176 * Ported cfortran.h to Cygnus GNU Win32 C compiler (gcc for Windows).
2177 
2178 * Fixed bug in ncdump using same CDL header name when called with multiple
2179 files.
2180 
2181 * Added new NULL data type NC\_NAT (Not A Type) to facilitate checking
2182 whether a variable object has had its type defined yet, for example when
2183 working with packed values.
2184 
2185 * Fixed use of compile-time macro NO\_NETCDF\_2 so it really doesn't
2186 include old netCDF-2 interfaces, as intended.
2187 
2188 * Ported to MacOS X Public Beta (Darwin 1.2/PowerPC).
2189 
2190 * Fixed C++ friend declarations to conform to C++ standard.
2191 
2192 * Changed INSTALL file to INSTALL.html instead.
2193 
2194 ## 3.4 1998-03-09
2195 
2196 * Fixed ncx\_cray.c to work on all CRAY systems, not just CRAY1. Reworked
2197 USE\_IEG, which was incorrect. Reworked short support. Now USE\_IEG and
2198 otherwise both pass t\_ncx.
2199 
2200 * To better support parallel systems, static and malloc'ed scratch areas
2201 which were shared in the library were eliminated. These were made
2202 private and on the stack where possible. To support this, the macros
2203 ALLOC\_ONSTACK and FREE\_ONSTACK are defined in onstack.h.
2204 
2205 * The buffered i/o system implementation in posixio.c was reimplemented to
2206 limit the number and size of read() or write() system calls and use
2207 greater reliance on memory to memory copy. This saves a great deal of
2208 wall clock time on slow (NFS) filesystems, especially during
2209 nc\_endef().
2210 
2211 * Added performance tuning "underbar underbar" interfaces nc**open(),
2212 nc**create(), and nc\_\_enddef().
2213 
2214 * The 'sizehint' contract between the higher layers and the ncio layer is
2215 consistently enforced.
2216 
2217 * The C++ interface has been updated so that the deprecated "nclong"
2218 typedef should no longer be required, and casts to nclong no longer
2219 necessary. Just use int or long as appropriate. nclong is still
2220 supported for backwards compatibility.
2221 
2222 * The ncdump utility now displays byte values as signed, even on platforms
2223 where the type corresponding to a C char is unsigned (SGI, for example).
2224 Also the ncdump and ncgen utilities have been updated to display and
2225 accept byte attributes as signed numeric values (with a "b" suffix)
2226 instead of using character constants.
2227 
2228 * In libsrc/error.c:nc\_strerror(int), explain that NC\_EBADTYPE applies
2229 to "\_FillValue type mismatch".
2230 
2231 * Some changes to configure scripts (aclocal.m4), macros.make.in and
2232 ncgen/Makefile to support NEC SUPER-UX 7.2.
2233 
2234 * The "usage" messages of ncgen and ncdump include the string returned
2235 from nc\_inq\_libvers().
2236 
2237 * Corrected some casts in the library so that all phases of the arithmetic
2238 computing file offsets occurs with "off\_t" type. This allows certain
2239 larger netcdf files to be created and read on systems with larger
2240 (64bit) off\_t.
2241 
2242 * In ncgen, multidimensional character variables are now padded to the
2243 length of last dimension, instead of just concatenating them. This
2244 restores an undocumented but convenient feature of ncgen under netCDF-2.
2245 Also, a syntax error is now reliably reported if the netcdf name is
2246 omitted in CDL input.
2247 
2248 * Fortran and C code generated by ncgen for netCDF components whose names
2249 contain "-" characters will now compile and run correctly instead of
2250 causing syntax errors.
2251 
2252 * The library allows "." characters in names as well as "\_" and "-"
2253 characters. A zero length name "" is explicitly not allowed. The ncgen
2254 utility will now permit "." characters in CDL names as well.
2255 
2256 * Memory leaks in the C++ interface NcVar::as\_\*() member functions and
2257 NcFile::add\_var() member function are fixed. The documentation was
2258 fixed where it indicated incorrectly that the library managed value
2259 blocks that the user is actually responsible for deleting.
2260 
2261 * he values of the version 2 Fortran error codes have been modified to
2262 make the version 2 Fortran interface more backward compatible at the
2263 source level.
2264 
2265 * Added support for systems whose Fortran INTEGER*1 and INTEGER*2 types
2266 are equivalent to the C "long" type but whose C "int" and "long" types
2267 differ. An example of such a system is the NEC SX-4 with the "-ew"
2268 option to the f90 compiler (sheesh, what a system!).
2269 
2270 * Fixed Version 2 Fortran compatibility bug: NCVGTG, NCVGGC, NCVPTG, and
2271 NCVPGC didn't work according to the Version 2 documentation if the
2272 innermost mapping value (i.e. IMAP[1]) was zero (indicating that the
2273 netCDF structure of the variable should be used).
2274 
2275 ## 3.3.1 1997-06-16
2276 
2277 * One can now inquire about the number of attributes that a variable has
2278 using the global variable ID.
2279 
2280 * The FORTRAN interface should now work on more systems. In particular:
2281 
2282 * It should now work with FORTRAN compilers whose "integer*1" datatype is
2283 either a C "signed char", "short", or "int" and whose "integer*2"
2284 datatype is either a C "short" or "int".
2285 
2286 * It should now work with FORTRAN compilers that are extremely picky about
2287 source code formatting (e.g. the NAG f90 compiler).
2288 
2289 * The dependency on the non-POSIX utility m4(1) for generating the C and
2290 FORTRAN manual pages has been eliminated.
2291 
2292 * EXTERNAL statements have been added to the FORTRAN include-file
2293 "netcdf.inc" to eliminate excessive warnings about "unused" variables
2294 (which were actually functions) by some compilers (e.g. SunOS 4.1.3's
2295 f77(1) version 1.x).
2296 
2297 * Building the netCDF-3 package no longer requires the existence of the
2298 Standard C macro RAND\_MAX.
2299 
2300 * Fixed an ncdump bug resulting in ncdump reporting Attempt to convert
2301 between text & numbers when \_FillValue attribute of a character
2302 variable set to the empty string "".
2303 
2304 * Made ncgen tests more stringent and fixed various bugs this uncovered.
2305 These included bugs in handling byte attributes on platforms on which
2306 char is unsigned, initializing scalar character variables in generated C
2307 code under "-c" option, interspersing DATA statements with declaration
2308 statements in generated Fortran code under "-f" option, handling empty
2309 string as a value correctly in generated C and Fortran, and handling
2310 escape characters in strings. The Fortran output under the "-f" option
2311 was also made less obscure and more portable, using automatic conversion
2312 with netCDF-3 interfaces instead of "BYTE", "INTEGER*1", or "INTEGER*2"
2313 declarations.
2314 
2315 * Fixed a C++ interface problem that prevented compiling the C++ library
2316 with Digital's cxx compiler.
2317 
2318 * Made ncgen "make test" report failure and stop if test resulted in a
2319 failure of generated C or Fortran code.
2320 
2321 * The file that you are now reading was created to contain a high-level
2322 description of the evolution of the netCDF-3 package.
2323 
2324 ## 3.3 1997-05-15
2325 
2326 * The production version of the netCDF-3 package was released.
2327 
2328 * A comparison of the netCDF-2 and netCDF-3 releases can be found in the
2329 file COMPATIBILITY.
2330 
2331 */