Skip to content

Commit

Permalink
Added information to RELEASE_NOTES to reflect the 'release candidate'…
Browse files Browse the repository at this point in the history 
… status of the current release.

Added information about needing to generate configure scripts with 'autoreconf'.
Updated Building with CMake documentation, moved 4.3.0 errata to a place of less prominence.
  • Loading branch information
Ward Fisher committed Aug 9, 2013
1 parent 5a5f4c7 commit f9e1374
Show file tree
Hide file tree
Showing 2 changed files with 37 additions and 27 deletions.
36 changes: 21 additions & 15 deletions RELEASE_NOTES.md
View file
Original file line number Diff line number Diff line change
@@ -1,39 +1,45 @@
\page release_notes Release Notes

This file contains a high-level description of this package's evolution.
Releases are in reverse chronological order (most recent first). Recent
releases include references to Jira issue identifiers for more
Releases are in reverse chronological order (most recent first).

Recent releases include references to Jira issue identifiers for more
information, where '[NCF-XXX]' refers to https://www.unidata.ucar.edu/jira/browse/NCF-XXX .

### 4.3.1 Released TBD
### 4.3.1-rc1 Released 2013-08-09

* Migrated from the netCDF-C `subversion` repository to a publically available GitHub repository available at https://github.com/Unidata/netCDF-C. This repository may be checked out (cloned) with the following command:

> $ git clone https://github.com/Unidata/netCDF-C.git
> $ git clone https://github.com/Unidata/netCDF-C.git

* Note: in this release, it is necessary to generate the `configure` script and makefile templates using `autoreconf` in the root netCDF-C directory.:

> $ autoreconf -i -f

* Added `nc_rename_grp` to allow for group renaming in netCDF-4 files. [NCF-204]
* Added `nc_rename_grp` to allow for group renaming in netCDF-4 files.
https://bugtracking.unidata.ucar.edu/browse/NCF-204

[NCF-204]: https://bugtracking.unidata.ucar.edu/browse/NCF-204

* 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.
* Added a `NC_HAVE_RENAME_GRP` macro to netcdf.h, as per a request by Charlie Zender. This will allow software compiling against netcdf to easily query whether or not `nc_rename_grp()` is available.

[cz1]: https://www.unidata.ucar.edu/esupport/staff/index.php?_m=tickets&_a=viewticket&ticketid=22442
* https://www.unidata.ucar.edu/esupport/staff/index.php?_m=tickets&_a=viewticket&ticketid=22442

* 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.

* 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]
* 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:

* autotools-based builds: --enable-dynamic-loading
* cmake-based builds: -DENABLE\_DYNAMIC\_LOADING=ON

[NCF-258]: https://www.unidata.ucar.edu/jira/browse/NCF-258
https://www.unidata.ucar.edu/jira/browse/NCF-258


* 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]
* 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]: https://bugtracking.unidata.ucar.edu/browse/NCF-250
https://bugtracking.unidata.ucar.edu/browse/NCF-250

* 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]
* 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]: https://bugtracking.unidata.ucar.edu/browse/NCF-56
https://bugtracking.unidata.ucar.edu/browse/NCF-56

* Parallel-build portability fixes, particularly for OpenMPI and gcc/gfortran-4.8.x on OSX.

Expand Down
28 changes: 16 additions & 12 deletions man4/Building-with-CMake.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -2,21 +2,10 @@

# Overview

Starting with netCDF-C 4.3, we are happy to announce the inclusion of CMake support. CMake will allow for building netCDF on a wider range of platforms, include Microsoft Windows with Visual Studio. CMake support also provides robust unit and regression testing tools. We will also maintain the standard autotools-based build system in parallel.
Starting with netCDF-C 4.3.0, we are happy to announce the inclusion of CMake support. CMake will allow for building netCDF on a wider range of platforms, include Microsoft Windows with Visual Studio. CMake support also provides robust unit and regression testing tools. We will also maintain the standard autotools-based build system in parallel.

In addition to providing new build options for netCDF-C, we will also provide pre-built binary downloads for the shared versions of netCDF for use with Visual Studio.

# Errata

## netCDF 4.3.0

* When netCDF 4.3.0 was originally released, the file `nc-config.in.cmake` was accidentally excluded. This file can be downloaded [here]. The file should be placed in the root of the netcdf source directory.

[here]: https://www.unidata.ucar.edu/software/netcdf/win_netcdf/nc-config.in.cmake "nc-config.in.cmake"

* When building shared libraries via CMake on Unix/Linux, the resulting files have the soversion 4.3.0. This is a mistake, the soversion should be 7.2.0. This can be rectified post-install by creating a symbolic link from libnetcdf.4.3.0.so to libnetcdf.7.2.0.so. This would be accomplished thusly:

> sudo ln -s /usr/local/lib/libnetcdf.4.3.0.so /usr/local/lib/libnetcdf.7.2.0.so
# Requirements
The following packages are required to build netCDF-C using CMake.
Expand Down Expand Up @@ -152,3 +141,18 @@ or

> cmake [path to source tree] -L - This will show the basic options.
> cmake [path to source tree] -LA - This will show the basic and advanced options.


# Errata

## netCDF 4.3.1-rc1

## netCDF 4.3.0

* When netCDF 4.3.0 was originally released, the file `nc-config.in.cmake` was accidentally excluded. This file can be downloaded [here]. The file should be placed in the root of the netcdf source directory.

[here]: https://www.unidata.ucar.edu/software/netcdf/win_netcdf/nc-config.in.cmake "nc-config.in.cmake"

* When building shared libraries via CMake on Unix/Linux, the resulting files have the soversion 4.3.0. This is a mistake, the soversion should be 7.2.0. This can be rectified post-install by creating a symbolic link from libnetcdf.4.3.0.so to libnetcdf.7.2.0.so. This would be accomplished thusly:

> $ sudo ln -s /usr/local/lib/libnetcdf.4.3.0.so /usr/local/lib/libnetcdf.7.2.0.so

0 comments on commit f9e1374

Please sign in to comment.