/usr/share/doc/flex-old-doc/flex_21.html is in flex-old-doc 2.5.4a-10ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 | html2
<html>
<!-- Created on February 6, 2012 by texi2html 1.82
texi2html was written by:
Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
Olaf Bachmann <obachman@mathematik.uni-kl.de>
and many others.
Maintained by: Many creative people.
Send bugs and suggestions to <texi2html-bug@nongnu.org>
-->
<head>
<title>Flex - a scanner generator: 21. Diagnostics</title>
<meta name="description" content="Flex - a scanner generator: 21. Diagnostics">
<meta name="keywords" content="Flex - a scanner generator: 21. Diagnostics">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="texi2html 1.82">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.smallquotation {font-size: smaller}
pre.display {font-family: serif}
pre.format {font-family: serif}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
pre.smalldisplay {font-family: serif; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: serif; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.roman {font-family:serif; font-weight:normal;}
span.sansserif {font-family:sans-serif; font-weight:normal;}
ul.toc {list-style: none}
-->
</style>
</head>
<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
<a name="Diagnostics"></a>
<table cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="flex_20.html#Incompatibilities" title="Previous section in reading order"> < </a>]</td>
<td valign="middle" align="left">[<a href="flex_22.html#Files" title="Next section in reading order"> > </a>]</td>
<td valign="middle" align="left"> </td>
<td valign="middle" align="left">[<a href="flex_20.html#Incompatibilities" title="Beginning of this chapter or previous chapter"> << </a>]</td>
<td valign="middle" align="left">[<a href="flex.html#Top" title="Up section"> Up </a>]</td>
<td valign="middle" align="left">[<a href="flex_22.html#Files" title="Next chapter"> >> </a>]</td>
<td valign="middle" align="left"> </td>
<td valign="middle" align="left"> </td>
<td valign="middle" align="left"> </td>
<td valign="middle" align="left"> </td>
<td valign="middle" align="left">[<a href="flex.html#Top" title="Cover (top) of document">Top</a>]</td>
<td valign="middle" align="left">[<a href="flex_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
<td valign="middle" align="left">[Index]</td>
<td valign="middle" align="left">[<a href="flex_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
<a name="Diagnostics-1"></a>
<h1 class="chapter">21. Diagnostics</h1>
<dl compact="compact">
<dt> ‘<samp>warning, rule cannot be matched</samp>’</dt>
<dd><p>indicates that the given
rule cannot be matched because it follows other rules that
will always match the same text as it. For example, in
the following "foo" cannot be matched because it comes
after an identifier "catch-all" rule:
</p>
<table><tr><td> </td><td><pre class="example">[a-z]+ got_identifier();
foo got_foo();
</pre></td></tr></table>
<p>Using <code>REJECT</code> in a scanner suppresses this warning.
</p>
</dd>
<dt> ‘<samp>warning, -s option given but default rule can be matched</samp>’</dt>
<dd><p>means that it is possible (perhaps only in a particular
start condition) that the default rule (match any single
character) is the only one that will match a particular
input. Since ‘<samp>-s</samp>’ was given, presumably this is not
intended.
</p>
</dd>
<dt> ‘<samp>reject_used_but_not_detected undefined</samp>’</dt>
<dt> ‘<samp>yymore_used_but_not_detected undefined</samp>’</dt>
<dd><p>These errors can
occur at compile time. They indicate that the scanner
uses <code>REJECT</code> or ‘<samp>yymore()</samp>’ but that <code>flex</code> failed to notice the
fact, meaning that <code>flex</code> scanned the first two sections
looking for occurrences of these actions and failed to
find any, but somehow you snuck some in (via a #include
file, for example). Use ‘<samp>%option reject</samp>’ or ‘<samp>%option yymore</samp>’
to indicate to flex that you really do use these features.
</p>
</dd>
<dt> ‘<samp>flex scanner jammed</samp>’</dt>
<dd><p>a scanner compiled with ‘<samp>-s</samp>’ has
encountered an input string which wasn’t matched by any of
its rules. This error can also occur due to internal
problems.
</p>
</dd>
<dt> ‘<samp>token too large, exceeds YYLMAX</samp>’</dt>
<dd><p>your scanner uses ‘<samp>%array</samp>’
and one of its rules matched a string longer than the ‘<samp>YYL-</samp>’
<code>MAX</code> constant (8K bytes by default). You can increase the
value by #define’ing <code>YYLMAX</code> in the definitions section of
your <code>flex</code> input.
</p>
</dd>
<dt> ‘<samp>scanner requires -8 flag to use the character '<var>x</var>'</samp>’</dt>
<dd><p>Your
scanner specification includes recognizing the 8-bit
character <var>x</var> and you did not specify the -8 flag, and your
scanner defaulted to 7-bit because you used the ‘<samp>-Cf</samp>’ or ‘<samp>-CF</samp>’
table compression options. See section <a href="flex_17.html#Options">‘<samp>-7</samp>’flag</a>.
</p>
</dd>
<dt> ‘<samp>flex scanner push-back overflow</samp>’</dt>
<dd><p>you used ‘<samp>unput()</samp>’ to push
back so much text that the scanner’s buffer could not hold
both the pushed-back text and the current token in <code>yytext</code>.
Ideally the scanner should dynamically resize the buffer
in this case, but at present it does not.
</p>
</dd>
<dt> ‘<samp>input buffer overflow, can't enlarge buffer because scanner uses REJECT</samp>’</dt>
<dd><p>the scanner was working on matching an
extremely large token and needed to expand the input
buffer. This doesn’t work with scanners that use <code>REJECT</code>.
</p>
</dd>
<dt> ‘<samp>fatal flex scanner internal error--end of buffer missed</samp>’</dt>
<dd><p>This can occur in an scanner which is reentered after a
long-jump has jumped out (or over) the scanner’s
activation frame. Before reentering the scanner, use:
</p>
<table><tr><td> </td><td><pre class="example">yyrestart( yyin );
</pre></td></tr></table>
<p>or, as noted above, switch to using the C++ scanner class.
</p>
</dd>
<dt> ‘<samp>too many start conditions in <> construct!</samp>’</dt>
<dd><p>you listed
more start conditions in a <> construct than exist (so you
must have listed at least one of them twice).
</p></dd>
</dl>
<hr size="6">
<table cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="flex_20.html#Incompatibilities" title="Beginning of this chapter or previous chapter"> << </a>]</td>
<td valign="middle" align="left">[<a href="flex_22.html#Files" title="Next chapter"> >> </a>]</td>
<td valign="middle" align="left"> </td>
<td valign="middle" align="left"> </td>
<td valign="middle" align="left"> </td>
<td valign="middle" align="left"> </td>
<td valign="middle" align="left"> </td>
<td valign="middle" align="left">[<a href="flex.html#Top" title="Cover (top) of document">Top</a>]</td>
<td valign="middle" align="left">[<a href="flex_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
<td valign="middle" align="left">[Index]</td>
<td valign="middle" align="left">[<a href="flex_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
<p>
<font size="-1">
This document was generated by <em>Build Daemon user</em> on <em>February 6, 2012</em> using <a href="http://www.nongnu.org/texi2html/"><em>texi2html 1.82</em></a>.
</font>
<br>
</p>
</body>
</html>
|