From fc1bf059f48f927e772df2b17d1fe81b5b4829a4 Mon Sep 17 00:00:00 2001 From: David Wells Date: Sat, 27 Oct 2018 15:43:22 -0400 Subject: [PATCH] Deprecate the NetCDF bindings. --- doc/news/changes/incompatibilities/20181027DavidWells | 7 +++++++ doc/readme.html | 2 ++ include/deal.II/base/exceptions.h | 2 ++ include/deal.II/grid/grid_in.h | 4 +++- 4 files changed, 14 insertions(+), 1 deletion(-) create mode 100644 doc/news/changes/incompatibilities/20181027DavidWells diff --git a/doc/news/changes/incompatibilities/20181027DavidWells b/doc/news/changes/incompatibilities/20181027DavidWells new file mode 100644 index 0000000000..d0e909b2e0 --- /dev/null +++ b/doc/news/changes/incompatibilities/20181027DavidWells @@ -0,0 +1,7 @@ +Deprecated: deal.II's NetCDF bindings have been deprecated. The present set of +bindings are incompatible with recent releases of NetCDF and, at the present +time, no one has volunteered to either maintain or upgrade our interface. The +bindings will be removed in a future version if no one steps forward to update +the bindings. +
+(David Wells, 2018/10/27) diff --git a/doc/readme.html b/doc/readme.html index de4c9b9747..2294bfbfa6 100644 --- a/doc/readme.html +++ b/doc/readme.html @@ -498,10 +498,12 @@
NetCDF
+

NetCDF is a library that provides services for reading and writing mesh data (and many other things). deal.II can use it to read meshes via one of the functions of the GridIn class. NetCDF should be readily packaged by most Linux distributions. To use a self compiled version, pass -DNETCDF_DIR=/path/to/netcdf to cmake. + The deal.II NetCDF bindings are only compatible with an obsolete version of NetCDF and will be removed in a future release of the library unless newer bindings are contributed.

diff --git a/include/deal.II/base/exceptions.h b/include/deal.II/base/exceptions.h index 7c0369f33f..3a9be34422 100644 --- a/include/deal.II/base/exceptions.h +++ b/include/deal.II/base/exceptions.h @@ -930,6 +930,8 @@ namespace StandardExceptions /** * This function requires support for the NetCDF library. + * + * @deprecated Support for NetCDF in deal.II is deprecated. */ DeclExceptionMsg( ExcNeedsNetCDF, diff --git a/include/deal.II/grid/grid_in.h b/include/deal.II/grid/grid_in.h index 984dd09a94..58c3dab83f 100644 --- a/include/deal.II/grid/grid_in.h +++ b/include/deal.II/grid/grid_in.h @@ -462,8 +462,10 @@ public: * supported is the TAU grid format. * * This function requires the library to be linked with the NetCDF library. + * + * @deprecated Support for NetCDF in deal.II is deprecated. */ - void + DEAL_II_DEPRECATED void read_netcdf(const std::string &filename); /** -- 2.39.5