From 16ff9d01339a7ecd859ee619a8496ca878a3eb70 Mon Sep 17 00:00:00 2001 From: ggujjula <43194746+ggujjula@users.noreply.github.com> Date: Tue, 31 May 2022 00:59:52 -0500 Subject: Add documentation for option '--yymore' --- doc/flex.texi | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/doc/flex.texi b/doc/flex.texi index a4b5897..9224d98 100755 --- a/doc/flex.texi +++ b/doc/flex.texi @@ -3172,6 +3172,17 @@ also generates a @code{yyFlexLexer::yylex()} member function that emits a run-time error (by invoking @code{yyFlexLexer::LexerError())} if called. @xref{Cxx}. +@anchor{option-yymore} +@opindex ---yymore +@opindex yymore +@item --yymore, @code{%option yymore} +tells flex to generate a scanner with logic to append the next token to the +currently matched text. This option is enabled automatically if flex detects +the use of @code{yymore()} in the scanner rules. However, this option must be +set explicitly if @code{yymore()} is used more indirectly to avoid a compile +time error. +@xref{Actions}. @xref{Diagnostics}. + @end table @node Options for Scanner Speed and Size, Debugging Options, Code-Level And API Options, Scanner Options -- cgit v1.2.1 From e0e7091dc76d67a5b60647e4e0ddb45f8d7fa8bb Mon Sep 17 00:00:00 2001 From: ggujjula <43194746+ggujjula@users.noreply.github.com> Date: Tue, 31 May 2022 01:18:53 -0500 Subject: Add anchors and refs to areas relevant to '--yymore' --- doc/flex.texi | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/doc/flex.texi b/doc/flex.texi index 9224d98..5ccd0a9 100755 --- a/doc/flex.texi +++ b/doc/flex.texi @@ -1345,6 +1345,7 @@ Note also that unlike the other special actions, @code{yyreject()} is a @emph{branch}. Code immediately following it in the action will @emph{not} be executed. +@anchor{action-yymore} @item yymore() @cindex yymore() tells the scanner that the next time it matches a rule, the @@ -3181,7 +3182,7 @@ currently matched text. This option is enabled automatically if flex detects the use of @code{yymore()} in the scanner rules. However, this option must be set explicitly if @code{yymore()} is used more indirectly to avoid a compile time error. -@xref{Actions}. @xref{Diagnostics}. +@xref{action-yymore}. @xref{yymore_used_but_not_detected-undefined}. @end table @@ -5453,6 +5454,7 @@ not intended. @item @code{reject_used_but_not_detected undefined} or +@anchor{yymore_used_but_not_detected-undefined} @code{yymore_used_but_not_detected undefined}. These errors can occur at compile time. They indicate that the scanner uses @code{yyreject()} or @code{yymore()} but that @code{flex} failed to notice the fact, meaning -- cgit v1.2.1