Bug 164073 - There should be a dummy tag that Doxygen ignores

Introduced the `\noop` command to ignore text till end of the line.

1 files changed, 17 insertions, 0 deletions

diff --git a/src/commentscan.l b/src/commentscan.l
index a495c5e..024c99b 100644
--- a/src/commentscan.l
+++ b/src/commentscan.l
@@ -78,6 +78,7 @@ static bool handleFile(const QCString &, const QCStringList &);
 static bool handleDir(const QCString &, const QCStringList &);
 static bool handleExample(const QCString &, const QCStringList &);
 static bool handleDetails(const QCString &, const QCStringList &);
+static bool handleNoop(const QCString &, const QCStringList &);
 static bool handleName(const QCString &, const QCStringList &);
 static bool handleTodo(const QCString &, const QCStringList &);
 static bool handleTest(const QCString &, const QCStringList &);
@@ -279,6 +280,7 @@ static DocCmdMap docCmdMap[] =
   { "warning",         0,                       TRUE  },
   { "snippet",         0,                       TRUE  },
   { "snippetlineno",   0,                       TRUE  },
+  { "noop",            &handleNoop,             TRUE },
   { 0, 0, FALSE }
 };
 
@@ -998,6 +1000,7 @@ RCSTAG    "$"{ID}":"[^\n$]+"$"
 %x	CopyDoc
 %x      GuardExpr
 %x      CdataSection
+%x      Noop
 
 %%
 
@@ -2129,6 +2132,14 @@ RCSTAG    "$"{ID}":"[^\n$]+"$"
 					  current->name+=*yytext;
   					}
 
+  /* ----- handle argument of noop command ------- */
+<Noop>{DOCNL}				{ // end of argument
+					  if (*yytext=='\n') yyLineNr++;
+					  addOutput('\n');
+					  BEGIN( Comment );
+					}
+<Noop>.					{ // ignore other stuff
+					}
   /* ----- handle argument of ingroup command ------- */
 
 <InGroupParam>{LABELID}			{ // group id
@@ -2540,6 +2551,12 @@ static bool handleDetails(const QCString &, const QCStringList &)
   return FALSE;
 }
 
+static bool handleNoop(const QCString &, const QCStringList &)
+{
+  BEGIN( Noop );
+  return FALSE;
+}
+
 static bool handleName(const QCString &, const QCStringList &)
 {
   bool stop=makeStructuralIndicator(Entry::MEMBERGRP_SEC);