From 0bd1f08284fc066c2e9fa5280b5771315ac16048 Mon Sep 17 00:00:00 2001 From: Wolfgang Bangerth Date: Fri, 30 Sep 2016 13:08:37 -0600 Subject: [PATCH] Update the description of ConstraintMatrix::print(). --- include/deal.II/lac/constraint_matrix.h | 24 ++++++++++++++++++------ 1 file changed, 18 insertions(+), 6 deletions(-) diff --git a/include/deal.II/lac/constraint_matrix.h b/include/deal.II/lac/constraint_matrix.h index 75bcce9398..cb00bd2d1a 100644 --- a/include/deal.II/lac/constraint_matrix.h +++ b/include/deal.II/lac/constraint_matrix.h @@ -475,14 +475,26 @@ public: double get_inhomogeneity (const size_type line) const; /** - * Print the constraint lines. Mainly for debugging purposes. + * Print the constraints represented by the current object to the + * given stream. + * + * For each constraint of the form + * @f[ + * x_{42} = 0.5 x_2 + 0.25 x_{14} + 2.75 + * @f] + * this function will write a sequence of lines that look like this: + * @code + * 42 2 : 0.5 + * 42 14 : 0.25 + * 42 : 2.75 + * @endcode + * The last line is only shown if the inhomogeneity (here: 2.75) is + * nonzero. * - * This function writes out all entries in the constraint matrix lines with - * their value in the form row col : value. Unconstrained lines - * containing only one identity entry are not stored in this object and are - * not printed. + * A block of lines such as the one above is repeated for each + * constrained degree of freedom. */ - void print (std::ostream &) const; + void print (std::ostream &out) const; /** * Write the graph of constraints in 'dot' format. 'dot' is a program that -- 2.39.5