/usr/share/doc/bison-doc/html/Interface.html is in bison-doc 1:3.0.2-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 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 | <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!--
This manual (23 October 2013) is for GNU Bison (version
3.0.2), the GNU parser generator.
Copyright (C) 1988-1993, 1995, 1998-2013 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." -->
<!-- Created by GNU Texinfo 5.2, http://www.gnu.org/software/texinfo/ -->
<head>
<title>Bison 3.0.2: Interface</title>
<meta name="description" content="Bison 3.0.2: Interface">
<meta name="keywords" content="Bison 3.0.2: Interface">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link href="index.html#Top" rel="start" title="Top">
<link href="Index-of-Terms.html#Index-of-Terms" rel="index" title="Index of Terms">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="index.html#Top" rel="up" title="Top">
<link href="Parser-Function.html#Parser-Function" rel="next" title="Parser Function">
<link href="Multiple-Parsers.html#Multiple-Parsers" rel="prev" title="Multiple Parsers">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.indentedblock {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
div.smalllisp {margin-left: 3.2em}
kbd {font-style:oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
pre.smalldisplay {font-family: inherit; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: inherit; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.nocodebreak {white-space:nowrap}
span.nolinebreak {white-space:nowrap}
span.roman {font-family:serif; font-weight:normal}
span.sansserif {font-family:sans-serif; font-weight:normal}
ul.no-bullet {list-style: none}
-->
</style>
</head>
<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
<a name="Interface"></a>
<div class="header">
<p>
Next: <a href="Algorithm.html#Algorithm" accesskey="n" rel="next">Algorithm</a>, Previous: <a href="Grammar-File.html#Grammar-File" accesskey="p" rel="prev">Grammar File</a>, Up: <a href="index.html#Top" accesskey="u" rel="up">Top</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index-of-Terms.html#Index-of-Terms" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="Parser-C_002dLanguage-Interface"></a>
<h2 class="chapter">4 Parser C-Language Interface</h2>
<a name="index-C_002dlanguage-interface"></a>
<a name="index-interface"></a>
<p>The Bison parser is actually a C function named <code>yyparse</code>. Here we
describe the interface conventions of <code>yyparse</code> and the other
functions that it needs to use.
</p>
<p>Keep in mind that the parser uses many C identifiers starting with
‘<samp>yy</samp>’ and ‘<samp>YY</samp>’ for internal purposes. If you use such an
identifier (aside from those in this manual) in an action or in epilogue
in the grammar file, you are likely to run into trouble.
</p>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">• <a href="Parser-Function.html#Parser-Function" accesskey="1">Parser Function</a>:</td><td> </td><td align="left" valign="top">How to call <code>yyparse</code> and what it returns.
</td></tr>
<tr><td align="left" valign="top">• <a href="Push-Parser-Function.html#Push-Parser-Function" accesskey="2">Push Parser Function</a>:</td><td> </td><td align="left" valign="top">How to call <code>yypush_parse</code> and what it returns.
</td></tr>
<tr><td align="left" valign="top">• <a href="Pull-Parser-Function.html#Pull-Parser-Function" accesskey="3">Pull Parser Function</a>:</td><td> </td><td align="left" valign="top">How to call <code>yypull_parse</code> and what it returns.
</td></tr>
<tr><td align="left" valign="top">• <a href="Parser-Create-Function.html#Parser-Create-Function" accesskey="4">Parser Create Function</a>:</td><td> </td><td align="left" valign="top">How to call <code>yypstate_new</code> and what it returns.
</td></tr>
<tr><td align="left" valign="top">• <a href="Parser-Delete-Function.html#Parser-Delete-Function" accesskey="5">Parser Delete Function</a>:</td><td> </td><td align="left" valign="top">How to call <code>yypstate_delete</code> and what it returns.
</td></tr>
<tr><td align="left" valign="top">• <a href="Lexical.html#Lexical" accesskey="6">Lexical</a>:</td><td> </td><td align="left" valign="top">You must supply a function <code>yylex</code>
which reads tokens.
</td></tr>
<tr><td align="left" valign="top">• <a href="Error-Reporting.html#Error-Reporting" accesskey="7">Error Reporting</a>:</td><td> </td><td align="left" valign="top">You must supply a function <code>yyerror</code>.
</td></tr>
<tr><td align="left" valign="top">• <a href="Action-Features.html#Action-Features" accesskey="8">Action Features</a>:</td><td> </td><td align="left" valign="top">Special features for use in actions.
</td></tr>
<tr><td align="left" valign="top">• <a href="Internationalization.html#Internationalization" accesskey="9">Internationalization</a>:</td><td> </td><td align="left" valign="top">How to let the parser speak in the user’s
native language.
</td></tr>
</table>
</body>
</html>
|