From: Matthias Maier <tamiko@43-1.org>
Date: Mon, 28 Oct 2019 17:56:05 +0000 (-0500)
Subject: fix doxygen documentation generation for tutorial steps
X-Git-Tag: v9.2.0-rc1~936^2
X-Git-Url: https://gitweb.dealii.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=bc149ada670925fd5d9f791879670a2d65ba2d2d;p=dealii.git

fix doxygen documentation generation for tutorial steps

Newer versions seem to be a bit more picky in what they consider a valid
documentation comment.

Thus, make sure to
 - start with "/**" and close with "*/" on the same line
 - remove the only "*" from the first line
---

diff --git a/doc/doxygen/scripts/make_step.pl b/doc/doxygen/scripts/make_step.pl
index 58abfb240b..e1ef0704ac 100644
--- a/doc/doxygen/scripts/make_step.pl
+++ b/doc/doxygen/scripts/make_step.pl
@@ -26,7 +26,7 @@ $cmake_source_dir=$ARGV[1];
 
 print
 "/**
-  * \@page $step_underscore The $step tutorial program
+\@page $step_underscore The $step tutorial program
 ";
 
 open BF, "$cmake_source_dir/examples/$step/doc/builds-on"
@@ -98,5 +98,5 @@ print
 "<a name=\"PlainProg\"></a>
 <h1> The plain program</h1>
 \@include \"$step.$file_extension\"
- */
+*/
 ";