* described by fe_function at the $q$th quadrature point.
*
* @note The actual data type of the input vector may be either a
- * Vector<T>, BlockVector<T>, or one of the sequential PETSc or
- * Trilinos vector wrapper classes. It represents a global vector of DoF
- * values associated with the DofHandler object with which this FEValues
- * object was last initialized. Alternatively, if the vector argument is of
- * type IndexSet, then the function is represented as one that is either
- * zero or one, depending on whether a DoF index is in the set or not.
+ * Vector<T>, BlockVector<T>, or one of the PETSc or Trilinos
+ * vector wrapper classes. It represents a global vector of DoF values
+ * associated with the DoFHandler object with which this FEValues object was
+ * last initialized. Alternatively, if the vector argument is of type
+ * IndexSet, then the function is represented as one that is either zero or
+ * one, depending on whether a DoF index is in the set or not.
*
* @dealiiRequiresUpdateFlags{update_values}
*/
* direction $d$ at quadrature point $q$.
*
* @note The actual data type of the input vector may be either a
- * Vector<T>, BlockVector<T>, or one of the sequential PETSc or
- * Trilinos vector wrapper classes. It represents a global vector of DoF
- * values associated with the DoFHandler object with which this FEValues
- * object was last initialized. Alternatively, if the vector argument is of
- * type IndexSet, then the function is represented as one that is either
- * zero or one, depending on whether a DoF index is in the set or not.
+ * Vector<T>, BlockVector<T>, or one of the PETSc or Trilinos
+ * vector wrapper classes. It represents a global vector of DoF values
+ * associated with the DoFHandler object with which this FEValues object was
+ * last initialized. Alternatively, if the vector argument is of type
+ * IndexSet, then the function is represented as one that is either zero or
+ * one, depending on whether a DoF index is in the set or not.
*
* @dealiiRequiresUpdateFlags{update_gradients}
*/
* matrix of second derivatives at quadrature point $q$.
*
* @note The actual data type of the input vector may be either a
- * Vector<T>, BlockVector<T>, or one of the sequential PETSc or
- * Trilinos vector wrapper classes. It represents a global vector of DoF
- * values associated with the DofHandler object with which this FEValues
- * object was last initialized. Alternatively, if the vector argument is of
- * type IndexSet, then the function is represented as one that is either
- * zero or one, depending on whether a DoF index is in the set or not.
+ * Vector<T>, BlockVector<T>, or one of the PETSc or Trilinos
+ * vector wrapper classes. It represents a global vector of DoF values
+ * associated with the DoFHandler object with which this FEValues object was
+ * last initialized. Alternatively, if the vector argument is of type
+ * IndexSet, then the function is represented as one that is either zero or
+ * one, depending on whether a DoF index is in the set or not.
*
* @dealiiRequiresUpdateFlags{update_hessians}
*/
* would be the output of the get_function_hessians() function.
*
* @note The actual data type of the input vector may be either a
- * Vector<T>, BlockVector<T>, or one of the sequential PETSc or
- * Trilinos vector wrapper classes. It represents a global vector of DoF
- * values associated with the DofHandler object with which this FEValues
- * object was last initialized. Alternatively, if the vector argument is of
- * type IndexSet, then the function is represented as one that is either
- * zero or one, depending on whether a DoF index is in the set or not.
+ * Vector<T>, BlockVector<T>, or one of the PETSc or Trilinos
+ * vector wrapper classes. It represents a global vector of DoF values
+ * associated with the DoFHandler object with which this FEValues object was
+ * last initialized. Alternatively, if the vector argument is of type
+ * IndexSet, then the function is represented as one that is either zero or
+ * one, depending on whether a DoF index is in the set or not.
*
* @dealiiRequiresUpdateFlags{update_hessians}
*/
* quadrature point $q$.
*
* @note The actual data type of the input vector may be either a
- * Vector<T>, BlockVector<T>, or one of the sequential PETSc or
- * Trilinos vector wrapper classes. It represents a global vector of DoF
- * values associated with the DofHandler object with which this FEValues
- * object was last initialized. Alternatively, if the vector argument is of
- * type IndexSet, then the function is represented as one that is either
- * zero or one, depending on whether a DoF index is in the set or not.
+ * Vector<T>, BlockVector<T>, or one of the PETSc or Trilinos
+ * vector wrapper classes. It represents a global vector of DoF values
+ * associated with the DoFHandler object with which this FEValues object was
+ * last initialized. Alternatively, if the vector argument is of type
+ * IndexSet, then the function is represented as one that is either zero or
+ * one, depending on whether a DoF index is in the set or not.
*
* @dealiiRequiresUpdateFlags{update_3rd_derivatives}
*/
/**
* A vector composed of several blocks each representing a vector of its own.
*
- * The BlockVector is a collection of Vectors (e.g. of either deal.II Vector
- * objects or PETScWrappers::Vector object). Each of the vectors inside can
- * have a different size.
+ * The BlockVector is a collection of vectors of a given type (e.g., deal.II
+ * Vector objects, PETScWrappers::MPI::Vector objects, etc.). Each of the
+ * vectors inside can have a different size.
*
* The functionality of BlockVector includes everything a Vector can do, plus
* the access to a single Vector inside the BlockVector by <tt>block(i)</tt>.
const value_type b, const BlockVectorBase &W);
/**
- * This function does nothing but is there for compatibility with the @p
- * PETScWrappers::Vector class.
- *
- * For the PETSc vector wrapper class, this function updates the ghost
- * values of the PETSc vector. This is necessary after any modification
- * before reading ghost values.
- *
- * However, for the implementation of this class, it is immaterial and thus
- * an empty function.
+ * Update the ghost values by calling <code>update_ghost_values</code> for
+ * each block.
*/
void update_ghost_values () const;