Merge pull request doxygen#12014 from albert-github/feature/issue_12009

issue doxygen#12009 Doctest/Catch2, requirements links and layout

Author: doxygen

src/pre.l

@@ -325,6 +325,7 @@ static inline void outputSpaces(yyscan_t yyscanner,char *s);
 static inline void  outputSpace(yyscan_t yyscanner,char c);
 static inline void extraSpacing(yyscan_t yyscanner);
 static QCString     expandMacro(yyscan_t yyscanner,const QCString &name);
+static QCString expandStandardMacro(yyscan_t yyscanner,const QCString &name);
 static void     readIncludeFile(yyscan_t yyscanner,const QCString &inc);
 static void           incrLevel(yyscan_t yyscanner);
 static void           decrLevel(yyscan_t yyscanner);
@@ -702,6 +703,7 @@ NUMBER {INTEGER_NUMBER}|{FLOAT_NUMBER}
                                             //printf("Found it! #args=%d\n",def->nargs);
                                             yyextra->roundCount=0;
                                             yyextra->defArgsStr=yytext;
+                                            QCString resultExpr;
                                             if (def->nargs==-1) // no function macro
                                             {
                                               QCString result = def->isPredefined && !def->expandAsDefined ?
@@ -849,18 +851,23 @@ NUMBER {INTEGER_NUMBER}|{FLOAT_NUMBER}
   /* end lex rule handling */
 <CopyLine,LexCopyLine>{ID}              {
                                           Define *def=nullptr;
+                                          QCString result;
                                           if ((yyextra->includeStack.empty() || yyextra->curlyCount>0) &&
                                               yyextra->macroExpansion &&
                                               (def=isDefined(yyscanner,yytext)) &&
                                               def->nargs==-1 &&
                                               (!yyextra->expandOnlyPredef || def->isPredefined)
                                              )
                                           {
-                                            QCString result=def->isPredefined && !def->expandAsDefined ?
+                                            result=def->isPredefined && !def->expandAsDefined ?
                                               def->definition :
                                               expandMacro(yyscanner,yytext);
                                             outputString(yyscanner,result);
                                           }
+                                          else if (!(result = expandStandardMacro(yyscanner,yytext)).isEmpty())
+                                          {
+                                             outputString(yyscanner,result);
+                                          }
                                           else
                                           {
                                             outputArray(yyscanner,yytext,yyleng);
@@ -3074,9 +3081,15 @@ static bool expandExpression(yyscan_t yyscanner,QCString &expr,QCString *rest,in
   while ((p=getNextId(expr,i,&l))!=-1) // search for an macro name
   {
     bool replaced=FALSE;
+    QCString resultExpr;
     macroName=expr.mid(p,l);
     //printf(" p=%d macroName=%s\n",p,qPrint(macroName));
-    if (p<2 || !(expr.at(p-2)=='@' && expr.at(p-1)=='-')) // no-rescan marker?
+    if (!(resultExpr = expandStandardMacro(yyscanner,macroName)).isEmpty())
+    {
+      QCString restExpr=expr.right(expr.length()-8-p);
+      expr=expr.left(p)+resultExpr+restExpr;
+    }
+    else if (p<2 || !(expr.at(p-2)=='@' && expr.at(p-1)=='-')) // no-rescan marker?
     {
       if (state->expandedDict.find(macroName.str())==state->expandedDict.end()) // expand macro
       {
@@ -3117,7 +3130,7 @@ static bool expandExpression(yyscan_t yyscanner,QCString &expr,QCString *rest,in
         if (replaced) // expand the macro and rescan the expression
         {
           //printf(" replacing '%s'->'%s'\n",qPrint(expr.mid(p,len)),qPrint(expMacro));
-          QCString resultExpr=expMacro;
+          resultExpr=expMacro;
           QCString restExpr=expr.right(expr.length()-len-p);
           addSeparatorsIfNeeded(yyscanner,expr,resultExpr,restExpr,p);
           processConcatOperators(resultExpr);
@@ -3524,6 +3537,35 @@ static QCString expandMacro(yyscan_t yyscanner,const QCString &name)
   return n;
 }
 
+static QCString expandStandardMacro(yyscan_t yyscanner,const QCString &name)
+{
+  struct yyguts_t *yyg = (struct yyguts_t*)yyscanner;
+  QCString resultExpr;
+  if (name == "__LINE__")
+  {
+    return QCString().setNum(yyextra->yyLineNr);
+  }
+  else if (name == "__FILE__")
+  {
+    resultExpr = "\"";
+    resultExpr += yyextra->fileName;
+    resultExpr += "\"";
+  }
+  else if (name == "__DATE__")
+  {
+    resultExpr = "\"";
+    resultExpr += __DATE__;
+    resultExpr += "\"";
+  }
+  else if (name == "__TIME__")
+  {
+    resultExpr = "\"";
+    resultExpr += __TIME__;
+    resultExpr += "\"";
+  }
+  return resultExpr;
+}
+
 static void addDefine(yyscan_t yyscanner)
 {
   YY_EXTRA_TYPE state = preYYget_extra(yyscanner);