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 58abfb240bd0b587a576af2f0e0e166836ec271c..e1ef0704acce367144d5678b340894a59a9e08f1 100644 (file)
--- 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\"
- */
+*/
 ";