From 611bd5817244e26d97e060af288118d2be0273de Mon Sep 17 00:00:00 2001
From: bangerth
Date: Sun, 6 Jan 2013 02:13:43 +0000
Subject: [PATCH] Discuss deprecation notices.
git-svn-id: https://svn.dealii.org/trunk@27945 0785d39b-7218-0410-832d-ea1e28bc413d
---
deal.II/doc/news/changes.h | 22 ++++++++++++++++++++++
1 file changed, 22 insertions(+)
diff --git a/deal.II/doc/news/changes.h b/deal.II/doc/news/changes.h
index ce6fd96e03..0c14593263 100644
--- a/deal.II/doc/news/changes.h
+++ b/deal.II/doc/news/changes.h
@@ -24,6 +24,28 @@ inconvenience this causes.
+- Changed: Over the past few years, deal.II has accumulated a
+number of things that we would like to change but that would introduce
+incompatibility. Examples are inconsistent naming of functions or types,
+or things put into the wrong namespace. In reality, while there are
+about 100 examples of things we'd like to get rid of, most of them are
+rather obscure to begin with and will not affect most user code.
+Nevertheless, as a developer community, we are
+very careful in making such incompatible changes.
+
+All this said, it is sometimes necessary. We plan to create an incompatible
+release 8.0 at a later time. To give users a chance to already see which
+functions need to be changed, we have introduced markers into the deal.II
+header files that identify which functions, classes or symbols are now
+deprecated. If your compiler supports this, it will then warn if you are
+using any of these. The documentation for each of these symbols discusses
+the recommended alternative, which are in all cases already in place. In
+other words, you can already change your code in such a way that it compiles
+both with the current 7.3 release as well as with the future 8.0 release
+in which these symbols will have been removed.
+
+(Matthias Maier, Timo Heister, Wolfgang Bangerth, 2013/1/5)
+
- Changed: deal.II previously had two separate classes, DoFHandler
and MGDoFHandler, for standard and multilevel discretizations, respectively.
There were also corresponding accessor hierarchies for the cell and
--
2.39.5