Changeset fcc02767 for chapter06/bison.xml

Timestamp:

06/07/2020 08:16:00 PM (4 years ago)

Author:

Bruce Dubbs <bdubbs@…>

Branches:

10.0, 10.0-rc1, 10.1, 10.1-rc1, 11.0, 11.0-rc1, 11.0-rc2, 11.0-rc3, 11.1, 11.1-rc1, 11.2, 11.2-rc1, 11.3, 11.3-rc1, 12.0, 12.0-rc1, 12.1, 12.1-rc1, arm, bdubbs/gcc13, ml-11.0, multilib, renodr/libudev-from-systemd, s6-init, trunk, xry111/arm64, xry111/arm64-12.0, xry111/clfs-ng, xry111/lfs-next, xry111/loongarch, xry111/loongarch-12.0, xry111/loongarch-12.1, xry111/mips64el, xry111/pip3, xry111/rust-wip-20221008, xry111/update-glibc

Children:

595ff03

Parents:

d53fefa

Message:

Initial commit of alternative cross LFS

git-svn-id: ​http://svn.linuxfromscratch.org/LFS/branches/cross2@11897 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689

File:

• chapter06/bison.xml (modified) (6 diffs)

chapter06/bison.xml

@@ -6 +6 @@
 ]>
 
-<sect1 id="ch-system-bison" role="wrap">
+<sect1 id="ch-tools-bison" role="wrap">
   <?dbhtml filename="bison.html"?>
 
@@ -17 +17 @@
   <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>
 
@@ -24 +25 @@
     <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>
@@ -31 +34 @@
 
       <seglistitem>
-        <seg>&bison-ch6-sbu;</seg>
-        <seg>&bison-ch6-du;</seg>
+        <seg>&bison-ch5-sbu;</seg>
+        <seg>&bison-ch5-du;</seg>
       </seglistitem>
     </segmentedlist>
@@ -40 +43 @@
   <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>
 
-<screen><userinput remap="make">make -j1</userinput></screen>-->
+      <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>
+
+    </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>
@@ -79 +72 @@
   </sect2>
 
-  <sect2 id="contents-bison" role="content">
-    <title>Contents of Bison</title>
+  <sect2 role="content">
+    <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>
-
-    </variablelist>
+    <para>Details on this package are located in
+    <xref linkend="contents-bison" role="."/></para>
 
   </sect2>