doxygen: remove trailing // in tutorials

We introduced "//" markers (see for example "shape_grad" lines in
step-8) to force a specific formatting for clang-format. Make sure we
don't output these markers to the tutorial pages.

diff --git a/doc/doxygen/scripts/program2doxygen b/doc/doxygen/scripts/program2doxygen
index 23c360f521c7701e02acf991b6ec277d2b5bcbe9..ffb36df9b8b5fd59695c90cd4314d29df9adac79 100644 (file)
--- a/doc/doxygen/scripts/program2doxygen
+++ b/doc/doxygen/scripts/program2doxygen
@@ -37,13 +37,19 @@ $state =  $comment_mode;
 print " * \n";
 
 do {
-    # substitute tabs. also make sure that we don't output comment end
-    # markers that might confuse doxygen
+
+    # Make sure that we don't output comment end markers that might confuse
+    # doxygen.
     s!/\*!/ \*!g;
     s!\*/!\* /!g;
 
+    # substitute tabs
     s/\t/        /g;
 
+    # Remove "//" if it is present at the end of a line. These comments exist
+    # to force a specific formatting of the line for clang-format.
+    s!//$!!g;
+
     # We are entering code fragments
     if (($state != $code_fragment_mode) && m!^\s*//\s*\@code!)
     {

diff --git a/doc/doxygen/scripts/program2plain b/doc/doxygen/scripts/program2plain
index d267fa241c42da9a7e6834f84a0ad571cf43a20b..a1912dbdcc8e79b7aa5bcc68ef5b97740b8ccdb3 100644 (file)
--- a/doc/doxygen/scripts/program2plain
+++ b/doc/doxygen/scripts/program2plain
@@ -15,13 +15,17 @@
 
 # Remove all comments from the source file
 
-# The variable tracing whether we are inside a block comment
+# The output of this script is used as the source for the "The plain program"
+# block at the end of each tutorial.
 
-my $block_comment = 0;
 while (<>) {
-    # Eliminate //-comment lines
+    # Eliminate comment lines starting with "//"
     next if (m!^\s*//!);
 
+    # Remove "//" if it is present at the end of a line. These comments exist
+    # to force a specific formatting of the line for clang-format
+    s!//$!!g;
+
     # Otherwise print the line
     print;
 }