Clarify and correct documentation.

git-svn-id: https://svn.dealii.org/trunk@32849 0785d39b-7218-0410-832d-ea1e28bc413d

diff --git a/deal.II/include/deal.II/base/timer.h b/deal.II/include/deal.II/base/timer.h
index 8a79dc56a79e370bd7fb4150317940c907aa701e..c64013c6391819d475140918ac5efd4b31bd9ef3 100644 (file)
--- a/deal.II/include/deal.II/base/timer.h
+++ b/deal.II/include/deal.II/base/timer.h
@@ -414,27 +414,42 @@ public:
    * time we exit a section, just in the
    * end, both, or never.
    */
-  enum OutputFrequency {every_call, summary, every_call_and_summary, never}
+  enum OutputFrequency
+  {
+    every_call,
+    summary,
+    every_call_and_summary,
+    never
+  }
   output_frequency;
 
   /**
    * Sets whether to show CPU times, wall
    * times, or both CPU and wall times.
    */
-  enum OutputType      {cpu_times, wall_times, cpu_and_wall_times}
+  enum OutputType
+  {
+    cpu_times,
+    wall_times,
+    cpu_and_wall_times
+  }
   output_type;
 
   /**
-   * Constructor that takes std::cout as
-   * output stream.
+   * Constructor. Output is written to the stream (of type std::ostream)
+   * given as first argument. The second and third arguments denote how
+   * often output is to be generated and what kind of timing the output
+   * should represent (CPU or wall time).
    */
   TimerOutput (std::ostream              &stream,
                const enum OutputFrequency output_frequency,
                const enum OutputType      output_type);
 
   /**
-   * Constructor that takes a
-   * ConditionalOStream to write output to.
+   * Constructor. Output is written to the stream (of type ConditionalOstream)
+   * given as first argument. The second and third arguments denote how
+   * often output is to be generated and what kind of timing the output
+   * should represent (CPU or wall time).
    */
   TimerOutput (ConditionalOStream        &stream,
                const enum OutputFrequency output_frequency,