diff options
Diffstat (limited to 'chapter06/bison.xml')
| -rw-r--r-- | chapter06/bison.xml | 181 |
1 files changed, 104 insertions, 77 deletions
diff --git a/chapter06/bison.xml b/chapter06/bison.xml index d5fb0ae82..3e208fe02 100644 --- a/chapter06/bison.xml +++ b/chapter06/bison.xml @@ -1,102 +1,129 @@ <?xml version="1.0" encoding="ISO-8859-1"?> -<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ +<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" + "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ <!ENTITY % general-entities SYSTEM "../general.ent"> %general-entities; ]> + <sect1 id="ch-system-bison" role="wrap"> -<title>Bison-&bison-version;</title> -<?dbhtml filename="bison.html"?> + <?dbhtml filename="bison.html"?> + + <title>Bison-&bison-version;</title> + + <indexterm zone="ch-system-bison"> + <primary sortas="a-Bison">Bison</primary> + </indexterm> + + <sect2 role="package"> + <title/> -<indexterm zone="ch-system-bison"><primary sortas="a-Bison">Bison</primary></indexterm> + <para>The Bison package contains a parser generator.</para> -<sect2 role="package"><title/> -<para>The Bison package contains a parser generator.</para> + <segmentedlist> + <segtitle>&buildtime;</segtitle> + <segtitle>&diskspace;</segtitle> -<segmentedlist> -<segtitle>&buildtime;</segtitle> -<segtitle>&diskspace;</segtitle> -<seglistitem><seg>0.6 SBU</seg><seg>9.9 MB</seg></seglistitem> -</segmentedlist> + <seglistitem> + <seg>0.6 SBU</seg> + <seg>9.9 MB</seg> + </seglistitem> + </segmentedlist> -<segmentedlist> -<segtitle>&dependencies;</segtitle> -<seglistitem><seg>Bash, Binutils, Coreutils, Diffutils, -GCC, Gettext, Glibc, Grep, M4, Make, and Sed</seg></seglistitem> -</segmentedlist> -</sect2> + <segmentedlist> + <segtitle>&dependencies;</segtitle> -<sect2 role="installation"> -<title>Installation of Bison</title> + <seglistitem> + <seg>Bash, Binutils, Coreutils, Diffutils, GCC, Gettext, Glibc, + Grep, M4, Make, and Sed</seg> + </seglistitem> + </segmentedlist> -<para>Prepare Bison for compilation:</para> + </sect2> + + <sect2 role="installation"> + <title>Installation of Bison</title> + + <para>Prepare Bison for compilation:</para> <screen><userinput>./configure --prefix=/usr</userinput></screen> -<para>The configure system causes bison to be built without support for -internationalization of error messages if a <command>bison</command> -program is not already in $PATH. The following addition will correct -this.</para> + <para>The configure system causes bison to be built without support for + internationalization of error messages if a <command>bison</command> + program is not already in $PATH. The following addition will correct + this.</para> -<screen>echo '#define YYENABLE_NLS 1' >> config.h</screen> +<screen>echo '#define YYENABLE_NLS 1' >> config.h</screen> -<para>Compile the package:</para> + <para>Compile the package:</para> <screen><userinput>make</userinput></screen> -<para>To test the results, issue: -<userinput>make check</userinput>.</para> + <para>To test the results, issue: + <userinput>make check</userinput>.</para> -<para>Install the package:</para> + <para>Install the package:</para> <screen><userinput>make install</userinput></screen> -</sect2> - -<sect2 id="contents-bison" role="content"><title>Contents of Bison</title> - -<segmentedlist> -<segtitle>Installed programs</segtitle> -<segtitle>Installed library</segtitle> -<seglistitem><seg>bison and yacc</seg><seg>liby.a</seg></seglistitem> -</segmentedlist> - -<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead> -<?dbfo list-presentation="list"?> -<?dbhtml list-presentation="table"?> - -<varlistentry id="bison"> -<term><command>bison</command></term> -<listitem> -<para>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 bison"><primary sortas="b-bison">bison</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="yacc"> -<term><command>yacc</command></term> -<listitem> -<para>A wrapper for <command>bison</command>, meant for programs -that still call <command>yacc</command> instead of <command>bison</command>; -it calls <command>bison</command> with the <parameter>-y</parameter> option</para> -<indexterm zone="ch-system-bison yacc"><primary sortas="b-yacc">yacc</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="liby.a"> -<term><filename class="libraryfile">liby.a</filename></term> -<listitem> -<para>The Yacc library containing implementations of Yacc-compatible -<emphasis>yyerror</emphasis> and <emphasis>main</emphasis> functions; -this library is normally not very useful, but POSIX requires -it</para> -<indexterm zone="ch-system-bison liby.a"><primary sortas="c-liby.a">liby.a</primary></indexterm> -</listitem> -</varlistentry> -</variablelist> - -</sect2> + </sect2> + + <sect2 id="contents-bison" role="content"> + <title>Contents of Bison</title> + + <segmentedlist> + <segtitle>Installed programs</segtitle> + <segtitle>Installed library</segtitle> + + <seglistitem> + <seg>bison and yacc</seg> + <seg>liby.a</seg> + </seglistitem> + </segmentedlist> + + <variablelist> + <bridgehead renderas="sect3">Short Descriptions</bridgehead> + <?dbfo list-presentation="list"?> + <?dbhtml list-presentation="table"?> + + <varlistentry id="bison"> + <term><command>bison</command></term> + <listitem> + <para>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 bison"> + <primary sortas="b-bison">bison</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="yacc"> + <term><command>yacc</command></term> + <listitem> + <para>A wrapper for <command>bison</command>, meant for programs that + still call <command>yacc</command> instead of <command>bison</command>; + it calls <command>bison</command> with the <parameter>-y</parameter> + option</para> + <indexterm zone="ch-system-bison yacc"> + <primary sortas="b-yacc">yacc</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="liby.a"> + <term><filename class="libraryfile">liby.a</filename></term> + <listitem> + <para>The Yacc library containing implementations of Yacc-compatible + <function>yyerror</function> and <function>main</function> functions; + this library is normally not very useful, but POSIX requires it</para> + <indexterm zone="ch-system-bison liby.a"> + <primary sortas="c-liby.a">liby.a</primary> + </indexterm> + </listitem> + </varlistentry> + + </variablelist> + + </sect2> </sect1> - |