]> https://gitweb.dealii.org/ - dealii.git/commitdiff
Deprecate the NetCDF bindings. 7392/head
authorDavid Wells <drwells@email.unc.edu>
Sat, 27 Oct 2018 19:43:22 +0000 (15:43 -0400)
committerDavid Wells <drwells@email.unc.edu>
Sat, 27 Oct 2018 21:59:57 +0000 (17:59 -0400)
doc/news/changes/incompatibilities/20181027DavidWells [new file with mode: 0644]
doc/readme.html
include/deal.II/base/exceptions.h
include/deal.II/grid/grid_in.h

diff --git a/doc/news/changes/incompatibilities/20181027DavidWells b/doc/news/changes/incompatibilities/20181027DavidWells
new file mode 100644 (file)
index 0000000..d0e909b
--- /dev/null
@@ -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.
+<br>
+(David Wells, 2018/10/27)
index de4c9b9747f37784080b72807191612759dbbcdb..2294bfbfa659f4bfbe66377e01cd1d04049553c5 100644 (file)
 
             <dt><a name="netcdf"></a><a href="http://www.unidata.ucar.edu/software/netcdf/" target="_top">NetCDF</a></dt>
             <dd>
+                <p>
                 <a href="http://www.unidata.ucar.edu/software/netcdf/" target="_top">NetCDF</a> is a library that provides services for reading and writing mesh data (and many other things). <acronym>deal.II</acronym> can use it to read meshes via one
                 of the functions of the <code>GridIn</code> class.
                 <a href="http://www.unidata.ucar.edu/software/netcdf/" target="_top">NetCDF</a> should be readily packaged by most Linux distributions. To use a self compiled version, pass
                 <code>-DNETCDF_DIR=/path/to/netcdf</code> to <code>cmake</code>.
+                <em>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.</em>
                 </p>
             </dd>
 
index 7c0369f33f1b0638541f6e681f4b77736b8ef8fc..3a9be34422dfbae2f7937ca7024da591bdeb950c 100644 (file)
@@ -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,
index 984dd09a94a75c8820f4942897f0955e33d645de..58c3dab83f361ee297d9a76a522cecb686001061 100644 (file)
@@ -462,8 +462,10 @@ public:
    * supported is the <tt>TAU grid format</tt>.
    *
    * 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);
 
   /**

In the beginning the Universe was created. This has made a lot of people very angry and has been widely regarded as a bad move.

Douglas Adams


Typeset in Trocchi and Trocchi Bold Sans Serif.