From: Wolfgang Bangerth <bangerth@math.tamu.edu>
Date: Thu, 13 Aug 2015 14:14:44 +0000 (-0500)
Subject: Deprecate more vector functions.
X-Git-Tag: v8.4.0-rc2~611^2
X-Git-Url: https://gitweb.dealii.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=a45f633f0fc797a499559887d2b5d6be6bf1a508;p=dealii.git

Deprecate more vector functions.

These are a bit obscure and of questionable value. In particular,
these are functions that can't quite decide whether they would
belong into the VectorWithElementAccess category, or into the
VectorSpaceVector category. Thus, nuke them.
---

diff --git a/doc/news/changes.h b/doc/news/changes.h
index 2253787358..aff1977f50 100644
--- a/doc/news/changes.h
+++ b/doc/news/changes.h
@@ -95,6 +95,14 @@ inconvenience this causes.
 
 
 <ol>
+  <li> Changed: The function Vector::add() that adds a scalar number to all
+  elements of a vector has been deprecated. The same is true for the
+  Vector::ratio() function, and for the corresponding functions in other
+  vector classes.
+  <br>
+  (Wolfgang Bangerth, Bruno Turcksin, 2015/08/13)
+  </li>
+
   <li> Improved: Some finite elements compute hessians analytically rather than
   by finite differencing. Namely, these are finite elements that are subclasses
   of FEPoly as well as FESystem with those as base elements.
diff --git a/include/deal.II/lac/parallel_vector.h b/include/deal.II/lac/parallel_vector.h
index eb863216d2..5398967de3 100644
--- a/include/deal.II/lac/parallel_vector.h
+++ b/include/deal.II/lac/parallel_vector.h
@@ -821,7 +821,7 @@ namespace parallel
        * Addition of @p s to all components. Note that @p s is a scalar and
        * not a vector.
        */
-      void add (const Number s);
+      void add (const Number s) DEAL_II_DEPRECATED;
 
       /**
        * Simple vector addition, equal to the <tt>operator +=</tt>.
@@ -945,7 +945,7 @@ namespace parallel
        * attempt is made to catch such situations.
        */
       void ratio (const Vector<Number> &a,
-                  const Vector<Number> &b);
+                  const Vector<Number> &b) DEAL_II_DEPRECATED;
       //@}
 
 
diff --git a/include/deal.II/lac/petsc_vector_base.h b/include/deal.II/lac/petsc_vector_base.h
index ee952979c9..508fb50ee5 100644
--- a/include/deal.II/lac/petsc_vector_base.h
+++ b/include/deal.II/lac/petsc_vector_base.h
@@ -609,7 +609,7 @@ namespace PETScWrappers
      * Addition of @p s to all components. Note that @p s is a scalar and not
      * a vector.
      */
-    void add (const PetscScalar s);
+    void add (const PetscScalar s) DEAL_II_DEPRECATED;
 
     /**
      * Simple vector addition, equal to the <tt>operator +=</tt>.
@@ -698,7 +698,7 @@ namespace PETScWrappers
      * attempt is made to catch such situations.
      */
     void ratio (const VectorBase &a,
-                const VectorBase &b);
+                const VectorBase &b) DEAL_II_DEPRECATED;
 
     /**
      * Prints the PETSc vector object values using PETSc internal vector
diff --git a/include/deal.II/lac/trilinos_vector_base.h b/include/deal.II/lac/trilinos_vector_base.h
index d31c1b4c3e..3d24b1ddb7 100644
--- a/include/deal.II/lac/trilinos_vector_base.h
+++ b/include/deal.II/lac/trilinos_vector_base.h
@@ -690,7 +690,7 @@ namespace TrilinosWrappers
      * Addition of @p s to all components. Note that @p s is a scalar and not
      * a vector.
      */
-    void add (const TrilinosScalar s);
+    void add (const TrilinosScalar s) DEAL_II_DEPRECATED;
 
     /**
      * Simple vector addition, equal to the <tt>operator +=</tt>.
@@ -794,7 +794,7 @@ namespace TrilinosWrappers
      * attempt is made to catch such situations.
      */
     void ratio (const VectorBase &a,
-                const VectorBase &b);
+                const VectorBase &b) DEAL_II_DEPRECATED;
     //@}
 
 
diff --git a/include/deal.II/lac/vector.h b/include/deal.II/lac/vector.h
index 9d02cc4a1c..b40b2d733f 100644
--- a/include/deal.II/lac/vector.h
+++ b/include/deal.II/lac/vector.h
@@ -660,7 +660,7 @@ public:
    *
    * @dealiiOperationIsMultithreaded
    */
-  void add (const Number s);
+  void add (const Number s) DEAL_II_DEPRECATED;
 
   /**
    * Simple vector addition, equal to the <tt>operator +=</tt>.
@@ -811,7 +811,7 @@ public:
    * @dealiiOperationIsMultithreaded
    */
   void ratio (const Vector<Number> &a,
-              const Vector<Number> &b);
+              const Vector<Number> &b) DEAL_II_DEPRECATED;
 
   /**
    * This function does nothing but is there for compatibility with the @p