[673b0d8] | 1 | <?xml version="1.0" encoding="ISO-8859-1"?>
|
---|
| 2 | <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
|
---|
| 3 | <!ENTITY % general-entities SYSTEM "../general.ent">
|
---|
| 4 | %general-entities;
|
---|
| 5 | ]>
|
---|
[a001133] | 6 | <sect1 id="ch-system-bison" xreflabel="Bison" role="wrap">
|
---|
[673b0d8] | 7 | <title>Bison-&bison-version;</title>
|
---|
| 8 | <?dbhtml filename="bison.html"?>
|
---|
| 9 |
|
---|
| 10 | <indexterm zone="ch-system-bison"><primary sortas="a-Bison">Bison</primary></indexterm>
|
---|
[6370fa6] | 11 |
|
---|
[a001133] | 12 | <sect2 role="package"><title/>
|
---|
[5888299] | 13 | <para>The Bison package contains a parser generator.</para>
|
---|
| 14 |
|
---|
[a001133] | 15 | <segmentedlist>
|
---|
| 16 | <segtitle>&buildtime;</segtitle>
|
---|
| 17 | <segtitle>&diskspace;</segtitle>
|
---|
| 18 | <seglistitem><seg>0.6 SBU</seg><seg>10.6 MB</seg></seglistitem>
|
---|
| 19 | </segmentedlist>
|
---|
| 20 |
|
---|
| 21 | <segmentedlist>
|
---|
| 22 | <segtitle>Bison installation depends on</segtitle>
|
---|
| 23 | <seglistitem><seg>Bash, Binutils, Coreutils, Diffutils,
|
---|
[69993f4] | 24 | GCC, Gettext, Glibc, Grep, M4, Make, and Sed</seg></seglistitem>
|
---|
[a001133] | 25 | </segmentedlist>
|
---|
| 26 | </sect2>
|
---|
[73aedd1d] | 27 |
|
---|
[a001133] | 28 | <sect2 role="installation">
|
---|
[73aedd1d] | 29 | <title>Installation of Bison</title>
|
---|
| 30 |
|
---|
[9dfc02f] | 31 | <para>Prepare Bison for compilation:</para>
|
---|
[73aedd1d] | 32 |
|
---|
| 33 | <screen><userinput>./configure --prefix=/usr</userinput></screen>
|
---|
| 34 |
|
---|
| 35 | <para>Compile the package:</para>
|
---|
| 36 |
|
---|
| 37 | <screen><userinput>make</userinput></screen>
|
---|
| 38 |
|
---|
[673b0d8] | 39 | <para>To test the results, issue:
|
---|
[8a5f906] | 40 | <userinput>make check</userinput>.</para>
|
---|
[73aedd1d] | 41 |
|
---|
[ef13657] | 42 | <para>Install the package:</para>
|
---|
[73aedd1d] | 43 |
|
---|
| 44 | <screen><userinput>make install</userinput></screen>
|
---|
| 45 |
|
---|
| 46 | </sect2>
|
---|
[6370fa6] | 47 |
|
---|
[5888299] | 48 |
|
---|
[c6cb3aa] | 49 | <sect2 id="contents-bison" role="content"><title>Contents of Bison</title>
|
---|
[673b0d8] | 50 |
|
---|
[c6cb3aa] | 51 | <segmentedlist>
|
---|
| 52 | <segtitle>Installed programs</segtitle>
|
---|
| 53 | <segtitle>Installed library</segtitle>
|
---|
| 54 | <seglistitem><seg>bison and yacc</seg><seg>liby.a</seg></seglistitem>
|
---|
| 55 | </segmentedlist>
|
---|
[673b0d8] | 56 |
|
---|
[3ed279f] | 57 | <variablelist><bridgehead renderas="sect3">Short descriptions</bridgehead>
|
---|
| 58 | <?dbfo list-presentation="list"?>
|
---|
[6370fa6] | 59 |
|
---|
[b8a819f] | 60 | <varlistentry id="bison">
|
---|
| 61 | <term><command>bison</command></term>
|
---|
[c6cb3aa] | 62 | <listitem>
|
---|
[ef13657] | 63 | <para>generates, from a series of rules, a program for analyzing the
|
---|
| 64 | structure of text files. <application>Bison</application> is a
|
---|
| 65 | replacement for <application>Yacc</application> (Yet Another Compiler
|
---|
| 66 | Compiler).</para>
|
---|
[3ed279f] | 67 | <indexterm zone="ch-system-bison bison"><primary sortas="b-bison">bison</primary></indexterm>
|
---|
[c6cb3aa] | 68 | </listitem>
|
---|
| 69 | </varlistentry>
|
---|
[673b0d8] | 70 |
|
---|
[b8a819f] | 71 | <varlistentry id="yacc">
|
---|
| 72 | <term><command>yacc</command></term>
|
---|
[c6cb3aa] | 73 | <listitem>
|
---|
[ef13657] | 74 | <para>a wrapper for <command>bison</command>, meant for programs
|
---|
[3c928f1] | 75 | that still call <command>yacc</command> instead of <command>bison</command>.
|
---|
| 76 | It calls <command>bison</command> with the <parameter>-y</parameter> option.</para>
|
---|
[3ed279f] | 77 | <indexterm zone="ch-system-bison yacc"><primary sortas="b-yacc">yacc</primary></indexterm>
|
---|
[c6cb3aa] | 78 | </listitem>
|
---|
| 79 | </varlistentry>
|
---|
[673b0d8] | 80 |
|
---|
[b8a819f] | 81 | <varlistentry id="liby.a">
|
---|
[e63529b] | 82 | <term><filename class="libraryfile">liby.a</filename></term>
|
---|
[c6cb3aa] | 83 | <listitem>
|
---|
[ef13657] | 84 | <para>the Yacc library containing implementations of Yacc-compatible
|
---|
| 85 | <emphasis>yyerror</emphasis> and <emphasis>main</emphasis> functions.
|
---|
| 86 | This library is normally not very useful, but POSIX requires
|
---|
| 87 | it.</para>
|
---|
[3ed279f] | 88 | <indexterm zone="ch-system-bison liby.a"><primary sortas="c-liby.a">liby.a</primary></indexterm>
|
---|
[c6cb3aa] | 89 | </listitem>
|
---|
| 90 | </varlistentry>
|
---|
| 91 | </variablelist>
|
---|
[673b0d8] | 92 |
|
---|
| 93 | </sect2>
|
---|
| 94 |
|
---|
| 95 | </sect1>
|
---|
[ef13657] | 96 |
|
---|