From d7d307c932c5317f7703e11ca9a6a7d48c0b0354 Mon Sep 17 00:00:00 2001
From: Daniel Arndt <daniel.arndt@iwr.uni-heidelberg.de>
Date: Wed, 4 Jul 2018 15:17:30 +0200
Subject: [PATCH] Fix comments in @code blocks in dofs headers

---
 include/deal.II/dofs/dof_handler.h | 15 ++++++++------
 include/deal.II/dofs/dof_tools.h   | 33 ++++++++++++++++--------------
 2 files changed, 27 insertions(+), 21 deletions(-)

diff --git a/include/deal.II/dofs/dof_handler.h b/include/deal.II/dofs/dof_handler.h
index 9b08cd587b..f4a3744c12 100644
--- a/include/deal.II/dofs/dof_handler.h
+++ b/include/deal.II/dofs/dof_handler.h
@@ -614,11 +614,14 @@ public:
    * does not contain any active cells (i.e., all cells on this level are
    * further refined, then this function returns
    * <code>end_active(level)</code> so that loops of the kind
-   *  @code
-   *    for (cell=dof_handler.begin_active(level);
-   * cell!=dof_handler.end_active(level); ++cell)
-   *      ...
-   *  @endcode
+   * @code
+   *   for (cell=dof_handler.begin_active(level);
+   *        cell!=dof_handler.end_active(level);
+   *        ++cell)
+   *     {
+   *       ...
+   *     }
+   * @endcode
    * have zero iterations, as may be expected if there are no active cells on
    * this level.
    */
@@ -714,7 +717,7 @@ public:
    * @code
    *   DoFHandler<dim> dof_handler;
    *   ...
-   *   for (auto cell : dof_handler.active_cell_iterators())
+   *   for (const auto &cell : dof_handler.active_cell_iterators())
    *     {
    *       fe_values.reinit (cell);
    *       ...do the local integration on 'cell'...;
diff --git a/include/deal.II/dofs/dof_tools.h b/include/deal.II/dofs/dof_tools.h
index 42cc1bc098..74cd5edcfa 100644
--- a/include/deal.II/dofs/dof_tools.h
+++ b/include/deal.II/dofs/dof_tools.h
@@ -2460,9 +2460,11 @@ namespace DoFTools
    * single gnuplot file, use code similar to
    * @code
    * std::ofstream out("gnuplot.gpl");
-   * out << "plot '-' using 1:2 with lines, '-' with labels point pt 2 offset
-   * 1,1" << std::endl; GridOut().write_gnuplot (triangulation, out); out << "e"
-   * << std::endl;
+   * out << "plot '-' using 1:2 with lines, "
+   *     << "'-' with labels point pt 2 offset 1,1"
+   *     << std::endl;
+   * GridOut().write_gnuplot (triangulation, out);
+   * out << "e" << std::endl;
    *
    * std::map<types::global_dof_index, Point<dim> > support_points;
    * DoFTools::map_dofs_to_support_points (MappingQ1<dim>(),
@@ -2482,18 +2484,19 @@ namespace DoFTools
    * @code
    * std::ofstream out("gnuplot.gpl");
    *
-   * out << "set terminal png size 400,410 enhanced font \"Helvetica,8\"" <<
-   * std::endl
-   *     << "set output \"output.png\"" << std::endl
-   *     << "set size square" << std::endl
-   *     << "set view equal xy" << std::endl
-   *     << "unset xtics" << std::endl
-   *     << "unset ytics" << std::endl
-   *     << "unset grid" << std::endl
-   *     << "unset border" << std::endl
-   *     << "plot '-' using 1:2 with lines notitle, '-' with labels point pt 2
-   * offset 1,1 notitle" << std::endl; GridOut().write_gnuplot (triangulation,
-   * out); out << "e" << std::endl;
+   * out << "set terminal png size 400,410 enhanced font \"Helvetica,8\"\n"
+   *     << "set output \"output.png\"\n"
+   *     << "set size square\n"
+   *     << "set view equal xy\n"
+   *     << "unset xtics\n"
+   *     << "unset ytics\n"
+   *     << "unset grid\n"
+   *     << "unset border\n"
+   *     << "plot '-' using 1:2 with lines notitle, "
+   *     << "'-' with labels point pt 2 offset 1,1 notitle"
+   *     << std::endl;
+   * GridOut().write_gnuplot (triangulation, out);
+   * out << "e" << std::endl;
    *
    * std::map<types::global_dof_index, Point<dim> > support_points;
    * DoFTools::map_dofs_to_support_points (MappingQ1<dim>(),
-- 
2.39.5