/usr/share/doc/bison-doc/html/Tuning-LR.html is in bison-doc 1:2.5-1.
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 | <html lang="en">
<head>
<title>Tuning LR - Bison 2.5</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="Bison 2.5">
<meta name="generator" content="makeinfo 4.13">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Algorithm.html#Algorithm" title="Algorithm">
<link rel="prev" href="Mysterious-Conflicts.html#Mysterious-Conflicts" title="Mysterious Conflicts">
<link rel="next" href="Generalized-LR-Parsing.html#Generalized-LR-Parsing" title="Generalized LR Parsing">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<!--
This manual (14 May 2011) is for GNU Bison (version
2.5), the GNU parser generator.
Copyright (C) 1988-1993, 1995, 1998-2011 Free Software
Foundation, Inc.
Permission is granted to copy, distribute and/or modify this
document under the terms of the GNU Free Documentation License,
Version 1.3 or any later version published by the Free Software
Foundation; with no Invariant Sections, with the Front-Cover texts
being ``A GNU Manual,'' and with the Back-Cover Texts as in (a)
below. A copy of the license is included in the section entitled
``GNU Free Documentation License.''
(a) The FSF's Back-Cover Text is: ``You have the freedom to copy
and modify this GNU manual. Buying copies from the FSF supports
it in developing GNU and promoting software freedom.''
-->
<meta http-equiv="Content-Style-Type" content="text/css">
<style type="text/css"><!--
pre.display { font-family:inherit }
pre.format { font-family:inherit }
pre.smalldisplay { font-family:inherit; font-size:smaller }
pre.smallformat { font-family:inherit; font-size:smaller }
pre.smallexample { font-size:smaller }
pre.smalllisp { font-size:smaller }
span.sc { font-variant:small-caps }
span.roman { font-family:serif; font-weight:normal; }
span.sansserif { font-family:sans-serif; font-weight:normal; }
--></style>
</head>
<body>
<div class="node">
<a name="Tuning-LR"></a>
<p>
Next: <a rel="next" accesskey="n" href="Generalized-LR-Parsing.html#Generalized-LR-Parsing">Generalized LR Parsing</a>,
Previous: <a rel="previous" accesskey="p" href="Mysterious-Conflicts.html#Mysterious-Conflicts">Mysterious Conflicts</a>,
Up: <a rel="up" accesskey="u" href="Algorithm.html#Algorithm">Algorithm</a>
<hr>
</div>
<h3 class="section">5.8 Tuning LR</h3>
<p>The default behavior of Bison's LR-based parsers is chosen mostly for
historical reasons, but that behavior is often not robust. For example, in
the previous section, we discussed the mysterious conflicts that can be
produced by LALR(1), Bison's default parser table construction algorithm.
Another example is Bison's <code>%error-verbose</code> directive, which instructs
the generated parser to produce verbose syntax error messages, which can
sometimes contain incorrect information.
<p>In this section, we explore several modern features of Bison that allow you
to tune fundamental aspects of the generated LR-based parsers. Some of
these features easily eliminate shortcomings like those mentioned above.
Others can be helpful purely for understanding your parser.
<p>Most of the features discussed in this section are still experimental. More
user feedback will help to stabilize them.
<ul class="menu">
<li><a accesskey="1" href="LR-Table-Construction.html#LR-Table-Construction">LR Table Construction</a>: Choose a different construction algorithm.
<li><a accesskey="2" href="Default-Reductions.html#Default-Reductions">Default Reductions</a>: Disable default reductions.
<li><a accesskey="3" href="LAC.html#LAC">LAC</a>: Correct lookahead sets in the parser states.
<li><a accesskey="4" href="Unreachable-States.html#Unreachable-States">Unreachable States</a>: Keep unreachable parser states for debugging.
</ul>
</body></html>
|