1 /*****************************************************************************
5 * Copyright (C) 1997-2015 by Dimitri van Heesch.
7 * Permission to use, copy, modify, and distribute this software and its
8 * documentation under the terms of the GNU General Public License is hereby
9 * granted. No representations are made about the suitability of this software
10 * for any purpose. It is provided "as is" without express or implied warranty.
11 * See the GNU General Public License for more details.
13 * Documents produced by Doxygen are derivative works derived from the
14 * input used in their production; they are not affected by this license.
17 %option never-interactive
18 %option prefix="commentcnvYY"
28 #include <qtextstream.h>
37 #include "condparser.h"
42 #define YY_NO_UNISTD_H 1
44 #define ADDCHAR(c) g_outBuf->addChar(c)
45 #define ADDARRAY(a,s) g_outBuf->addArray(a,s)
49 CondCtx(int line,QCString id,bool b)
50 : lineNr(line),sectionId(id), skip(b) {}
63 static BufStr * g_inBuf;
64 static BufStr * g_outBuf;
65 static int g_inBufPos;
67 static int g_blockHeadCol;
68 static bool g_mlBrief;
69 static int g_readLineCtx;
71 static QCString g_fileName;
74 static QStack<CondCtx> g_condStack;
75 static QStack<CommentCtx> g_commentStack;
76 static QCString g_blockName;
77 static int g_lastCommentContext;
78 static bool g_inSpecialComment;
79 static bool g_inRoseComment;
80 static int g_stringContext;
81 static int g_charContext;
82 static int g_javaBlock;
83 static bool g_specialComment;
85 static QCString g_aliasString;
86 static int g_blockCount;
87 static bool g_lastEscaped;
88 static int g_lastBlockContext;
89 static bool g_pythonDocString;
90 static int g_nestingCount;
92 static bool g_vhdl; // for VHDL old style --! comment
94 static SrcLangExt g_lang;
95 static bool isFixedForm; // For Fortran
97 static void replaceCommentMarker(const char *s,int len)
101 // copy leading blanks
102 while ((c=*p) && (c==' ' || c=='\t' || c=='\n'))
108 // replace start of comment marker by blanks and the last character by a *
110 while ((c=*p) && (c=='/' || c=='!' || c=='#'))
114 if (*p=='<') // comment-after-item marker
119 if (c=='!') // end after first !
131 if (blanks>1) ADDCHAR('*');
134 // copy comment line to output
135 ADDARRAY(p,len-(int)(p-s));
138 static inline int computeIndent(const char *s)
141 static int tabSize=Config_getInt(TAB_SIZE);
147 else if (c=='\t') col+=tabSize-(col%tabSize);
153 static inline void copyToOutput(const char *s,int len)
156 if (g_skip) // only add newlines.
163 //fprintf(stderr,"---> skip %d\n",g_lineNr);
171 static int tabSize=Config_getInt(TAB_SIZE);
177 //fprintf(stderr,"---> copy %d\n",g_lineNr);
179 case '\t': g_col+=tabSize-(g_col%tabSize); break;
180 default: g_col++; break;
186 static void startCondSection(const char *sectId)
188 //printf("startCondSection: skip=%d stack=%d\n",g_skip,g_condStack.count());
190 bool expResult = prs.parse(g_fileName,g_lineNr,sectId);
191 g_condStack.push(new CondCtx(g_lineNr,sectId,g_skip));
192 if (!expResult) // not enabled
198 static void endCondSection()
200 if (g_condStack.isEmpty())
202 warn(g_fileName,g_lineNr,"Found \\endcond command without matching \\cond");
207 CondCtx *ctx = g_condStack.pop();
210 //printf("endCondSection: skip=%d stack=%d\n",g_skip,g_condStack.count());
213 /** copies string \a s with length \a len to the output, while
214 * replacing any alias commands found in the string.
216 static void replaceAliases(const char *s)
218 QCString result = resolveAliasCmd(s);
219 //printf("replaceAliases(%s)->'%s'\n",s,result.data());
220 copyToOutput(result,result.length());
225 #define YY_INPUT(buf,result,max_size) result=yyread(buf,max_size);
227 static int yyread(char *buf,int max_size)
229 int bytesInBuf = g_inBuf->curPos()-g_inBufPos;
230 int bytesToCopy = QMIN(max_size,bytesInBuf);
231 memcpy(buf,g_inBuf->data()+g_inBufPos,bytesToCopy);
232 g_inBufPos+=bytesToCopy;
236 void replaceComment(int offset);
255 <Scan>[^"'!\/\n\\#,\-]* { /* eat anything that is not " / , or \n */
256 copyToOutput(yytext,(int)yyleng);
258 <Scan>[,] { /* eat , so we have a nice separator in long initialization lines */
259 copyToOutput(yytext,(int)yyleng);
261 <Scan>"\"\"\""! { /* start of python long comment */
262 if (g_lang!=SrcLangExt_Python)
268 g_pythonDocString = TRUE;
270 g_commentStack.clear(); /* to be on the save side */
271 copyToOutput(yytext,(int)yyleng);
273 g_commentStack.push(new CommentCtx(g_lineNr));
277 if (g_lang!=SrcLangExt_Fortran)
283 copyToOutput(yytext,(int)yyleng);
285 g_commentStack.clear(); /* to be on the save side */
287 g_commentStack.push(new CommentCtx(g_lineNr));
290 <Scan>[Cc\*][><!]/.*\n {
291 if (g_lang!=SrcLangExt_Fortran)
297 /* check for fixed format; we might have some conditional as part of multiline if like C<5 .and. & */
298 if (isFixedForm && (g_col == 0))
300 copyToOutput(yytext,(int)yyleng);
302 g_commentStack.clear(); /* to be on the safe side */
304 g_commentStack.push(new CommentCtx(g_lineNr));
313 if (g_lang!=SrcLangExt_Fortran)
319 copyToOutput(yytext,(int)yyleng);
323 if (g_lang!=SrcLangExt_Fortran)
331 copyToOutput(yytext,(int)yyleng);
339 <Scan>"\"" { /* start of a string */
340 copyToOutput(yytext,(int)yyleng);
341 g_stringContext = YY_START;
345 copyToOutput(yytext,(int)yyleng);
346 g_charContext = YY_START;
347 if (g_lang!=SrcLangExt_VHDL)
352 <Scan>\n { /* new line */
353 copyToOutput(yytext,(int)yyleng);
355 <Scan>"//!"/.*\n[ \t]*"//"[\/!][^\/] | /* start C++ style special comment block */
356 <Scan>("///"[/]*)/[^/].*\n[ \t]*"//"[\/!][^\/] { /* start C++ style special comment block */
359 REJECT; // bail out if we do not need to convert
366 while (i<(int)yyleng && yytext[i]=='/') i++;
368 g_blockHeadCol=g_col;
369 copyToOutput("/**",3);
370 replaceAliases(yytext+i);
371 g_inSpecialComment=TRUE;
373 g_readLineCtx=SComment;
377 <Scan>"//##Documentation".*/\n { /* Start of Rational Rose ANSI C++ comment block */
378 if (g_mlBrief) REJECT;
379 int i=17; //=strlen("//##Documentation");
380 g_blockHeadCol=g_col;
381 copyToOutput("/**",3);
382 replaceAliases(yytext+i);
383 g_inRoseComment=TRUE;
386 <Scan>"//"[!\/]/.*\n[ \t]*"//"[|\/][ \t]*[@\\]"}" { // next line contains an end marker, see bug 752712
387 g_inSpecialComment=yytext[2]=='/' || yytext[2]=='!';
388 copyToOutput(yytext,(int)yyleng);
389 g_readLineCtx=YY_START;
392 <Scan>"//"/.*\n { /* one line C++ comment */
393 g_inSpecialComment=yytext[2]=='/' || yytext[2]=='!';
394 copyToOutput(yytext,(int)yyleng);
395 g_readLineCtx=YY_START;
398 <Scan>"/**/" { /* avoid matching next rule for empty C comment, see bug 711723 */
399 copyToOutput(yytext,(int)yyleng);
401 <Scan>"/*"[*!]? { /* start of a C comment */
402 g_specialComment=(int)yyleng==3;
404 g_commentStack.clear(); /* to be on the save side */
405 copyToOutput(yytext,(int)yyleng);
407 g_commentStack.push(new CommentCtx(g_lineNr));
410 if (g_lang!=SrcLangExt_Python)
416 copyToOutput(yytext,(int)yyleng);
418 g_commentStack.clear(); /* to be on the save side */
420 g_commentStack.push(new CommentCtx(g_lineNr));
424 if (g_lang!=SrcLangExt_VHDL)
431 copyToOutput(yytext,(int)yyleng);
433 g_commentStack.clear(); /* to be on the save side */
435 g_commentStack.push(new CommentCtx(g_lineNr));
439 if (g_lang!=SrcLangExt_Fortran)
445 copyToOutput(yytext,(int)yyleng);
447 g_commentStack.clear(); /* to be on the save side */
449 g_commentStack.push(new CommentCtx(g_lineNr));
452 <CComment>"{@code"/[ \t\n] {
453 copyToOutput("@code",5);
454 g_lastCommentContext = YY_START;
456 g_blockName=&yytext[1];
459 <CComment,ReadLine>[\\@]("dot"|"code"|"msc"|"startuml")/[^a-z_A-Z0-9] { /* start of a verbatim block */
460 copyToOutput(yytext,(int)yyleng);
461 g_lastCommentContext = YY_START;
463 if (qstrcmp(&yytext[1],"startuml")==0)
469 g_blockName=&yytext[1];
473 <CComment,ReadLine>[\\@]("f$"|"f["|"f{") {
474 copyToOutput(yytext,(int)yyleng);
475 g_blockName=&yytext[1];
476 if (g_blockName.at(1)=='[')
478 g_blockName.at(1)=']';
480 else if (g_blockName.at(1)=='{')
482 g_blockName.at(1)='}';
484 g_lastCommentContext = YY_START;
487 <CComment,ReadLine>[\\@]("verbatim"|"latexonly"|"htmlonly"|"xmlonly"|"docbookonly"|"rtfonly"|"manonly")/[^a-z_A-Z0-9] { /* start of a verbatim block */
488 copyToOutput(yytext,(int)yyleng);
489 g_blockName=&yytext[1];
490 g_lastCommentContext = YY_START;
493 <Scan>. { /* any ather character */
494 copyToOutput(yytext,(int)yyleng);
496 <Verbatim>[\\@]("endverbatim"|"endlatexonly"|"endhtmlonly"|"endxmlonly"|"enddocbookonly"|"endrtfonly"|"endmanonly"|"f$"|"f]"|"f}") { /* end of verbatim block */
497 copyToOutput(yytext,(int)yyleng);
498 if (&yytext[1]==g_blockName) // end of formula
500 BEGIN(g_lastCommentContext);
502 else if (&yytext[4]==g_blockName)
504 BEGIN(g_lastCommentContext);
515 copyToOutput(yytext,(int)yyleng);
528 copyToOutput(" @endcode ",10);
529 BEGIN(g_lastCommentContext);
533 copyToOutput(yytext,(int)yyleng);
537 <VerbatimCode>[\\@]("enddot"|"endcode"|"endmsc"|"enduml") { /* end of verbatim block */
538 copyToOutput(yytext,(int)yyleng);
539 if (&yytext[4]==g_blockName)
541 BEGIN(g_lastCommentContext);
544 <VerbatimCode>^[ \t]*"//"[\!\/]? { /* skip leading comments */
545 if (!g_inSpecialComment)
547 copyToOutput(yytext,(int)yyleng);
552 while (yytext[l]==' ' || yytext[l]=='\t')
556 copyToOutput(yytext,l);
557 if (yyleng-l==3) // ends with //! or ///
559 copyToOutput(" * ",3);
563 copyToOutput("//",2);
567 <Verbatim,VerbatimCode>[^@\/\\\n{}]* { /* any character not a backslash or new line or } */
568 copyToOutput(yytext,(int)yyleng);
570 <Verbatim,VerbatimCode>\n { /* new line in verbatim block */
571 copyToOutput(yytext,(int)yyleng);
573 <Verbatim>^[ \t]*"///" {
574 if (g_blockName=="dot" || g_blockName=="msc" || g_blockName=="uml" || g_blockName.at(0)=='f')
576 // see bug 487871, strip /// from dot images and formulas.
578 while (yytext[l]==' ' || yytext[l]=='\t')
582 copyToOutput(yytext,l);
585 else // even slashes are verbatim (e.g. \verbatim, \code)
590 <Verbatim,VerbatimCode>. { /* any other character */
591 copyToOutput(yytext,(int)yyleng);
593 <SkipString>\\. { /* escaped character in string */
594 if (g_lang==SrcLangExt_Fortran)
597 copyToOutput(yytext,1);
601 copyToOutput(yytext,(int)yyleng);
604 <SkipString>"\"" { /* end of string */
605 copyToOutput(yytext,(int)yyleng);
606 BEGIN(g_stringContext);
608 <SkipString>. { /* any other string character */
609 copyToOutput(yytext,(int)yyleng);
611 <SkipString>\n { /* new line inside string (illegal for some compilers) */
612 copyToOutput(yytext,(int)yyleng);
614 <SkipChar>\\. { /* escaped character */
615 if (g_lang==SrcLangExt_Fortran)
618 copyToOutput(yytext,1);
622 copyToOutput(yytext,(int)yyleng);
625 <SkipChar>' { /* end of character literal */
626 copyToOutput(yytext,(int)yyleng);
627 BEGIN(g_charContext);
629 <SkipChar>. { /* any other string character */
630 copyToOutput(yytext,(int)yyleng);
632 <SkipChar>\n { /* new line character */
633 copyToOutput(yytext,(int)yyleng);
636 <CComment>[^\\!@*\n{\"\/]* { /* anything that is not a '*' or command */
637 copyToOutput(yytext,(int)yyleng);
639 <CComment>"*"+[^*/\\@\n{\"]* { /* stars without slashes */
640 copyToOutput(yytext,(int)yyleng);
642 <CComment>"\"\"\"" { /* end of Python docstring */
643 if (g_lang!=SrcLangExt_Python)
649 g_pythonDocString = FALSE;
650 copyToOutput(yytext,(int)yyleng);
654 <CComment>\n { /* new line in comment */
655 copyToOutput(yytext,(int)yyleng);
656 /* in case of Fortran always end of comment */
657 if (g_lang==SrcLangExt_Fortran)
662 <CComment>"/"+"*" { /* nested C comment */
664 g_commentStack.push(new CommentCtx(g_lineNr));
665 copyToOutput(yytext,(int)yyleng);
667 <CComment>"*"+"/" { /* end of C comment */
668 if (g_lang==SrcLangExt_Python)
674 copyToOutput(yytext,(int)yyleng);
675 if (g_nestingCount<=0)
682 delete g_commentStack.pop();
686 /* Python an VHDL share CComment, so special attention for ending comments is required */
687 <CComment>"\n"/[ \t]*"#" {
688 if (g_lang!=SrcLangExt_VHDL)
694 if (g_vhdl) // inside --! comment
697 copyToOutput(yytext,(int)yyleng);
700 else // C-type comment
706 <CComment>"\n"/[ \t]*"-" {
707 if (g_lang!=SrcLangExt_Python || g_pythonDocString)
713 copyToOutput(yytext,(int)yyleng);
717 <CComment>"\n"/[ \t]*[^ \t#\-] {
718 if (g_lang==SrcLangExt_Python)
720 if (g_pythonDocString)
726 copyToOutput(yytext,(int)yyleng);
730 else if (g_lang==SrcLangExt_VHDL)
732 if (g_vhdl) // inside --! comment
735 copyToOutput(yytext,(int)yyleng);
738 else // C-type comment
748 /* removed for bug 674842 (bug was introduced in rev 768)
750 g_charContext = YY_START;
751 copyToOutput(yytext,(int)yyleng);
755 g_stringContext = YY_START;
756 copyToOutput(yytext,(int)yyleng);
761 copyToOutput(yytext,(int)yyleng);
763 <SComment>^[ \t]*"///"[\/]*/\n {
766 <SComment>\n[ \t]*"///"[\/]*/\n {
769 <SComment>^[ \t]*"///"[^\/\n]/.*\n {
771 g_readLineCtx=YY_START;
774 <SComment>\n[ \t]*"//"[\/!]("<")?[ \t]*[\\@]"}".*\n {
775 /* See Bug 752712: end the multiline comment when finding a @} or \} command */
776 copyToOutput(" */",3);
777 copyToOutput(yytext,(int)yyleng);
778 g_inSpecialComment=FALSE;
779 g_inRoseComment=FALSE;
782 <SComment>\n[ \t]*"///"[^\/\n]/.*\n {
784 g_readLineCtx=YY_START;
787 <SComment>^[ \t]*"//!" | // just //!
788 <SComment>^[ \t]*"//!<"/.*\n | // or //!< something
789 <SComment>^[ \t]*"//!"[^<]/.*\n { // or //!something
791 g_readLineCtx=YY_START;
794 <SComment>\n[ \t]*"//!" |
795 <SComment>\n[ \t]*"//!<"/.*\n |
796 <SComment>\n[ \t]*"//!"[^<\n]/.*\n {
798 g_readLineCtx=YY_START;
801 <SComment>^[ \t]*"//##"/.*\n {
802 if (!g_inRoseComment)
809 g_readLineCtx=YY_START;
813 <SComment>\n[ \t]*"//##"/.*\n {
814 if (!g_inRoseComment)
821 g_readLineCtx=YY_START;
825 <SComment>\n { /* end of special comment */
826 copyToOutput(" */",3);
827 copyToOutput(yytext,(int)yyleng);
828 g_inSpecialComment=FALSE;
829 g_inRoseComment=FALSE;
832 <ReadLine>[^\\@\n]*/\n {
833 copyToOutput(yytext,(int)yyleng);
834 BEGIN(g_readLineCtx);
836 <CComment,ReadLine>[\\@][\\@][~a-z_A-Z][a-z_A-Z0-9]*[ \t]* { // escaped command
837 copyToOutput(yytext,(int)yyleng);
839 <CComment,ReadLine>[\\@]"cond"/[^a-z_A-Z0-9] { // conditional section
840 g_condCtx = YY_START;
843 <CComment,ReadLine>[\\@]"endcond"/[^a-z_A-Z0-9] { // end of conditional section
846 if (YY_START==CComment && oldSkip && !g_skip)
848 //printf("** Adding start of comment!\n");
849 if (g_lang!=SrcLangExt_Python &&
850 g_lang!=SrcLangExt_VHDL &&
851 g_lang!=SrcLangExt_Markdown &&
852 g_lang!=SrcLangExt_Fortran)
856 if (g_specialComment)
863 <CondLine>[!()&| \ta-z_A-Z0-9.\-]+ {
865 startCondSection(yytext);
866 if ((g_condCtx==CComment || g_readLineCtx==SComment) &&
869 if (g_lang!=SrcLangExt_Python &&
870 g_lang!=SrcLangExt_VHDL &&
871 g_lang!=SrcLangExt_Markdown &&
872 g_lang!=SrcLangExt_Fortran)
878 if (g_readLineCtx==SComment)
888 <CComment,ReadLine>[\\@]"cond"[ \t\r]*/\n |
889 <CondLine>. { // forgot section id?
890 if (YY_START!=CondLine) g_condCtx=YY_START;
892 startCondSection(" "); // fake section id causing the section to be hidden unconditionally
893 if ((g_condCtx==CComment || g_readLineCtx==SComment) &&
896 //printf("** Adding terminator for comment!\n");
897 if (g_lang!=SrcLangExt_Python &&
898 g_lang!=SrcLangExt_VHDL)
904 if (*yytext=='\n') g_lineNr++;
905 if (g_readLineCtx==SComment)
914 <CComment,ReadLine>[\\@][a-z_A-Z][a-z_A-Z0-9]* { // expand alias without arguments
915 replaceAliases(yytext);
917 <CComment,ReadLine>[\\@][a-z_A-Z][a-z_A-Z0-9]*"{" { // expand alias with arguments
918 g_lastBlockContext=YY_START;
920 g_aliasString=yytext;
922 BEGIN( ReadAliasArgs );
924 <ReadAliasArgs>^[ \t]*"//"[/!]/[^\n]+ { // skip leading special comments (see bug 618079)
926 <ReadAliasArgs>"*/" { // oops, end of comment in the middle of an alias?
927 if (g_lang==SrcLangExt_Python)
931 else // abort the alias, restart scanning
933 copyToOutput(g_aliasString,g_aliasString.length());
934 copyToOutput(yytext,(int)yyleng);
938 <ReadAliasArgs>[^{}\n\\\*]+ {
939 g_aliasString+=yytext;
942 <ReadAliasArgs>"\\" {
943 if (g_lastEscaped) g_lastEscaped=FALSE;
944 else g_lastEscaped=TRUE;
945 g_aliasString+=yytext;
948 g_aliasString+=yytext;
953 g_aliasString+=yytext;
954 if (!g_lastEscaped) g_blockCount++;
958 g_aliasString+=yytext;
959 if (!g_lastEscaped) g_blockCount--;
962 replaceAliases(g_aliasString);
963 BEGIN( g_lastBlockContext );
968 g_aliasString+=yytext;
972 copyToOutput(yytext,(int)yyleng);
977 void replaceComment(int offset)
979 if (g_mlBrief || g_skip)
981 copyToOutput(yytext,(int)yyleng);
985 //printf("replaceComment(%s)\n",yytext);
986 int i=computeIndent(&yytext[offset]);
987 if (i==g_blockHeadCol)
989 replaceCommentMarker(yytext,(int)yyleng);
993 copyToOutput(" */",3);
994 int i;for (i=(int)yyleng-1;i>=0;i--) unput(yytext[i]);
995 g_inSpecialComment=FALSE;
1001 // simplified way to know if this is fixed form
1002 // duplicate in fortrancode.l
1003 static bool recognizeFixedForm(const char* contents)
1006 bool skipLine=FALSE;
1011 switch(contents[i]) {
1023 if(column==1) return TRUE;
1027 if(column>1 && column<7) return FALSE;
1032 if(column==7) return TRUE;
1040 /*! This function does three things:
1041 * -# It converts multi-line C++ style comment blocks (that are aligned)
1042 * to C style comment blocks (if MULTILINE_CPP_IS_BRIEF is set to NO).
1043 * -# It replaces aliases with their definition (see ALIASES)
1044 * -# It handles conditional sections (cond...endcond blocks)
1046 void convertCppComments(BufStr *inBuf,BufStr *outBuf,const char *fileName)
1048 //printf("convertCppComments(%s)\n",fileName);
1053 g_mlBrief = Config_getBool(MULTILINE_CPP_IS_BRIEF);
1055 g_fileName = fileName;
1056 g_lang = getLanguageFromFileName(fileName);
1057 g_pythonDocString = FALSE;
1059 g_condStack.clear();
1060 g_condStack.setAutoDelete(TRUE);
1061 g_commentStack.clear();
1062 g_commentStack.setAutoDelete(TRUE);
1065 printlex(yy_flex_debug, TRUE, __FILE__, fileName);
1066 isFixedForm = FALSE;
1067 if (g_lang==SrcLangExt_Fortran)
1069 isFixedForm = recognizeFixedForm(inBuf->data());
1072 if (g_lang==SrcLangExt_Markdown)
1076 g_commentStack.push(new CommentCtx(g_lineNr));
1083 while (!g_condStack.isEmpty())
1085 CondCtx *ctx = g_condStack.pop();
1086 QCString sectionInfo = " ";
1087 if (ctx->sectionId!=" ") sectionInfo.sprintf(" with label '%s' ",ctx->sectionId.stripWhiteSpace().data());
1088 warn(g_fileName,ctx->lineNr,"Conditional section%sdoes not have "
1089 "a corresponding \\endcond command within this file.",sectionInfo.data());
1091 if (g_nestingCount>0 && g_lang!=SrcLangExt_Markdown)
1093 QCString tmp= "(probable line reference: ";
1095 while (!g_commentStack.isEmpty())
1097 CommentCtx *ctx = g_commentStack.pop();
1098 if (!first) tmp += ", ";
1099 tmp += QCString().setNum(ctx->lineNr);
1104 warn(g_fileName,g_lineNr,"Reached end of file while still inside a (nested) comment. "
1105 "Nesting level %d %s",g_nestingCount+1,tmp.data()); // add one for "normal" expected end of comment
1107 g_commentStack.clear();
1109 if (Debug::isFlagSet(Debug::CommentCnv))
1111 g_outBuf->at(g_outBuf->curPos())='\0';
1112 Debug::print(Debug::CommentCnv,0,"-----------\nCommentCnv: %s\n"
1113 "output=[\n%s]\n-----------\n",fileName,g_outBuf->data()
1116 printlex(yy_flex_debug, FALSE, __FILE__, fileName);
1120 //----------------------------------------------------------------------------
1121 #if !defined(YY_FLEX_SUBMINOR_VERSION)
1122 extern "C" { // some bogus code to keep the compiler happy
1123 void commentcnvYYdummy() { yy_flex_realloc(0,0); }