From: Wolfgang Bangerth Date: Sun, 6 Jan 2013 02:13:43 +0000 (+0000) Subject: Discuss deprecation notices. X-Git-Tag: v8.0.0~1653 X-Git-Url: https://gitweb.dealii.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=eda545b31f198365edbd0fc3f9c6f190566423a1;p=dealii.git Discuss deprecation notices. git-svn-id: https://svn.dealii.org/trunk@27945 0785d39b-7218-0410-832d-ea1e28bc413d --- 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.

    +
  1. 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) +
  2. 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