lfs-book/chapter06/bison.xml

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../general.ent">
  %general-entities;
]>
<sect1 id="ch-system-bison" xreflabel="Bison">
<title>Bison-&bison-version;</title>
<?dbhtml filename="bison.html"?>

<indexterm zone="ch-system-bison"><primary sortas="a-Bison">Bison</primary></indexterm>

<para>The Bison package contains a parser generator.</para>

<screen>&buildtime; 0.6 SBU
&diskspace; 10.6 MB</screen>

<para>Bison installation depends on: Bash, Binutils, Coreutils, Diffutils,
GCC, Gettext, Glibc, Grep, M4, Make, Sed.</para>



<sect2>
<title>Installation of Bison</title>

<para>First fix a minor compilation problem that Bison has with some packages,
the patch is back-ported from CVS:</para>

<screen><userinput>patch -Np1 -i ../bison-&bison-version;-attribute.patch</userinput></screen>

<para>Now prepare Bison for compilation:</para>

<screen><userinput>./configure --prefix=/usr</userinput></screen>

<para>Compile the package:</para>

<screen><userinput>make</userinput></screen>

<para>To test the results, issue:
<userinput>make check</userinput>.</para>

<para>Now install the package:</para>

<screen><userinput>make install</userinput></screen>

</sect2>


<sect2 id="contents-bison"><title>Contents of Bison</title>

<para><emphasis>Installed programs</emphasis>: bison and yacc</para>

<para><emphasis>Installed library</emphasis>: liby.a</para>

</sect2>


<sect2><title>Short descriptions</title>

<indexterm zone="ch-system-bison bison"><primary sortas="b-bison">bison</primary></indexterm>
<para id="bison"><command>bison</command> generates, from a series of rules, a program
for analyzing the structure of text files. Bison is a replacement for yacc
(Yet Another Compiler Compiler).</para>

<indexterm zone="ch-system-bison yacc"><primary sortas="b-yacc">yacc</primary></indexterm>
<para id="yacc"><command>yacc</command> is a wrapper for bison, meant for programs
that still call yacc instead of bison. It calls bison with the -y option.</para>

<indexterm zone="ch-system-bison liby.a"><primary sortas="c-liby.a">liby.a</primary></indexterm>
<para id="liby.a"><command>liby.a</command> is the Yacc library containing
implementations of Yacc-compatible yyerror and main functions. This library
is normally not very useful, but POSIX requires it.</para>

</sect2>



</sect1>