diff options
Diffstat (limited to 'chapter06/bison.xml')
| -rw-r--r-- | chapter06/bison.xml | 110 |
1 files changed, 25 insertions, 85 deletions
diff --git a/chapter06/bison.xml b/chapter06/bison.xml index 23b6f0a95..afe84a403 100644 --- a/chapter06/bison.xml +++ b/chapter06/bison.xml @@ -5,7 +5,7 @@ %general-entities; ]> -<sect1 id="ch-system-bison" role="wrap"> +<sect1 id="ch-tools-bison" role="wrap"> <?dbhtml filename="bison.html"?> <sect1info condition="script"> @@ -16,22 +16,25 @@ <title>Bison-&bison-version;</title> - <indexterm zone="ch-system-bison"> + <indexterm zone="ch-tools-bison"> <primary sortas="a-Bison">Bison</primary> + <secondary>tools</secondary> </indexterm> <sect2 role="package"> <title/> - <para>The Bison package contains a parser generator.</para> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" + href="../chapter08/bison.xml" + xpointer="xpointer(/sect1/sect2[1]/para[1])"/> <segmentedlist> <segtitle>&buildtime;</segtitle> <segtitle>&diskspace;</segtitle> <seglistitem> - <seg>&bison-ch6-sbu;</seg> - <seg>&bison-ch6-du;</seg> + <seg>&bison-ch5-sbu;</seg> + <seg>&bison-ch5-du;</seg> </seglistitem> </segmentedlist> @@ -39,103 +42,40 @@ <sect2 role="installation"> <title>Installation of Bison</title> -<!-- - <para>First, fix a build problem with the current version:</para> -<screen><userinput remap="pre">sed -i '9327 s/mv/cp/' Makefile.in</userinput></screen> ---> <para>Prepare Bison for compilation:</para> -<screen><userinput remap="configure">./configure --prefix=/usr --docdir=/usr/share/doc/bison-&bison-version;</userinput></screen> +<screen><userinput remap="configure">./configure --prefix=/usr \ + --docdir=/usr/share/doc/bison-&bison-version;</userinput></screen> -<!-- I could not find a race condidtion in the current version. - <para>Compile the package, but work around a race condition in the - current version:</para> + <variablelist> + <title>The meaning of the new configure option:</title> + + <varlistentry> + <term><parameter>--docdir=/usr/share/doc/bison-&bison-version;</parameter></term> + <listitem> + <para>This tells the build system to install bison documentation + into a versioned directory.</para> + </listitem> + </varlistentry> -<screen><userinput remap="make">make -j1</userinput></screen>--> + </variablelist> <para>Compile the package:</para> <screen><userinput remap="make">make</userinput></screen> - <para>To test the results (about 5.5 SBU), issue:</para> - -<screen><userinput remap="test">make check</userinput></screen> - - <para>Fourteen tests fail in the "Diagnostics" section, probably because of - missing locales.</para> - -<!-- - <para>There is a circular dependency between bison and flex with regard to - the checks. If desired, after installing flex in the next section, the - bison package can be rebuilt and the bison checks can be run with - <command>make check</command>.</para> ---> - <para>Install the package:</para> <screen><userinput remap="install">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> - <segtitle>Installed directory</segtitle> - - <seglistitem> - <seg>bison and yacc</seg> - <seg>liby.a</seg> - <seg>/usr/share/bison</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"> - <term><filename class="libraryfile">liby</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"> - <primary sortas="c-liby">liby</primary> - </indexterm> - </listitem> - </varlistentry> + <sect2 role="content"> + <title/> - </variablelist> + <para>Details on this package are located in + <xref linkend="contents-bison" role="."/></para> </sect2> |