From 6ef0d7287200565230db393e45ef35182286271c Mon Sep 17 00:00:00 2001
From: wolf <wolf@0785d39b-7218-0410-832d-ea1e28bc413d>
Date: Mon, 3 Jun 2002 09:21:47 +0000
Subject: [PATCH] Add deprecation notice, and fix some style issues.

git-svn-id: https://svn.dealii.org/trunk@5959 0785d39b-7218-0410-832d-ea1e28bc413d
---
 deal.II/doc/RELEASE/announce-3.4 |  2 ++
 deal.II/doc/news/2002/c-3-3.html | 26 +++++++++++++++++++++++---
 2 files changed, 25 insertions(+), 3 deletions(-)

diff --git a/deal.II/doc/RELEASE/announce-3.4 b/deal.II/doc/RELEASE/announce-3.4
index 7a03f77c81..f20f1c976d 100644
--- a/deal.II/doc/RELEASE/announce-3.4
+++ b/deal.II/doc/RELEASE/announce-3.4
@@ -11,6 +11,8 @@ The most important improvements compared to the previous version are:
 - Improved multi-threading supports using POSIX
 - Improved ISO C++ Standard conformance
 - Support for TECPLOT binary format and grid output in DX format
+- Three functions have been deprecated, and will be removed in the
+  next version.
 
 A complete list of changes with respect to the previous version can be
 found at
diff --git a/deal.II/doc/news/2002/c-3-3.html b/deal.II/doc/news/2002/c-3-3.html
index f8a560e693..af7f74d4e4 100644
--- a/deal.II/doc/news/2002/c-3-3.html
+++ b/deal.II/doc/news/2002/c-3-3.html
@@ -33,6 +33,24 @@ contributor's names are abbreviated by WB (Wolfgang Bangerth), GK
 <h3>General</h3>
 
 <ol>
+  <li> <p>
+       <strong>
+       Deprecated: The functions <code
+       class="member">FEValuesBase::get_shape_values</code>, <code
+       class="member">FEValuesBase::get_shape_grads</code>, and <code
+       class="member">FEValuesBase::get_shape_2nd_derivatives</code> are
+       now deprecated as they expose too much of the internal data
+       structure of their class, and interfere with plans for the
+       extension of this and related classes. The functions still
+       exist in this release of the library, but will be removed in
+       the next version. Use the <code
+       class="member">FEValuesBase::shape_value</code> and alike
+       functions as a replacement.
+       </strong>
+       <br>
+       (WB 2002/06/03)
+       </p>
+
   <li> <p>
        Added: The <code>configure</code> script now recognizes Intel's ECC
        compiler when run on Itanium systems with this compiler present.
@@ -153,7 +171,7 @@ contributor's names are abbreviated by WB (Wolfgang Bangerth), GK
   <li> <p> 
        New: The <code class="class">vector2d</code> row accessor
        classes now have member functions <code
-       class="member">begin<code> and <code class="member">end<code>
+       class="member">begin</code> and <code class="member">end</code>
        which allow iterating over the elements of a row of such an
        object. 
        <br>
@@ -164,7 +182,7 @@ contributor's names are abbreviated by WB (Wolfgang Bangerth), GK
        New: The <code class="class">Legendre</code> and
        <code class="class">LagrangeEquidistant</code> classes now have
        static member functions <code
-       class="member">generate_complete_basis<code> which returns an
+       class="member">generate_complete_basis</code> which returns an
        array of polynomial objects spanning the complete space up to a
        specified order in 1d. This may be used to generate the
        respective polynomial spaces in higher space dimensions.
@@ -205,7 +223,9 @@ contributor's names are abbreviated by WB (Wolfgang Bangerth), GK
        uses <code class="member">__builtin_expect</code> if the
        compiler supports this. This indicates to the compiler that we
        expect the condition to be true and that throwing an exception
-       is a rare case.
+       is a rare case. By this information, the compiler can help the
+       branch prediction unit of modern processors to better predict
+       which direction a branch will take.
        <br>
        (WB 2002/03/13)
        </p>
-- 
2.39.5