From: Timo Heister Date: Mon, 14 Sep 2020 13:53:31 +0000 (-0400) Subject: SparsityPattern: improve documentation X-Git-Tag: v9.3.0-rc1~1120^2 X-Git-Url: https://gitweb.dealii.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=refs%2Fpull%2F10913%2Fhead;p=dealii.git SparsityPattern: improve documentation My students rightfully complained, that it is very difficult to find begin() (hidden in the base class) and the accessor functions (hidden behind using). --- diff --git a/include/deal.II/lac/sparsity_pattern.h b/include/deal.II/lac/sparsity_pattern.h index ef22b9a266..f76681dd6c 100644 --- a/include/deal.II/lac/sparsity_pattern.h +++ b/include/deal.II/lac/sparsity_pattern.h @@ -847,13 +847,20 @@ protected: * is square (the first item will be the diagonal, followed by the other * entries sorted by column index). * - * @note While this class forms the basis upon which SparseMatrix objects base + * While this class forms the basis upon which SparseMatrix objects base * their storage format, and thus plays a central role in setting up linear * systems, it is rarely set up directly due to the way it stores its * information. Rather, one typically goes through an intermediate format * first, see for example the step-2 tutorial program as well as the * documentation module * @ref Sparsity. + * + * You can iterate over entries in the pattern using begin(), end(), + * begin(row), and end(row). These functions return an iterator of type + * SparsityPatternIterators::Iterator. When dereferencing an iterator @p it, + * you have access to the member functions in + * SparsityPatternIterators::Accessor, like it->column() and + * it->row(). */ class SparsityPattern : public SparsityPatternBase {