glfs/general/genutils/bc.xml
Dan Nichilson ed24600623 Fixed Bc testsuite and note
git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@5753 af4574ff-66df-0310-9fd7-8a98e5e911e0
2006-03-27 04:22:08 +00:00

155 lines
4.8 KiB
XML

<?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" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!ENTITY bc-download-http "http://ftp.gnu.org/gnu/bc/bc-&bc-version;.tar.gz">
<!ENTITY bc-download-ftp "ftp://ftp.gnu.org/gnu/bc/bc-&bc-version;.tar.gz">
<!ENTITY bc-md5sum "d44b5dddebd8a7a7309aea6c36fda117">
<!ENTITY bc-size "273 KB">
<!ENTITY bc-buildsize "2.36 MB">
<!ENTITY bc-time "less than 0.1 SBU (0.2 SBU if running the testsuite)">
]>
<sect1 id="bc" xreflabel="bc-&bc-version;">
<?dbhtml filename="bc.html"?>
<sect1info>
<othername>$LastChangedBy$</othername>
<date>$Date$</date>
<keywordset>
<keyword role="package">bc-&bc-version;.tar</keyword>
<keyword role="ftpdir">bc</keyword>
</keywordset>
</sect1info>
<title>Bc-&bc-version;</title>
<indexterm zone="bc">
<primary sortas="a-Bc">Bc</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to Bc</title>
<para>The <application>bc</application> package contains
an arbitrary precision numeric processing language.</para>
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&bc-download-http;"/></para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&bc-download-ftp;"/></para>
</listitem>
<listitem>
<para>Download MD5 sum: &bc-md5sum;</para>
</listitem>
<listitem>
<para>Download size: &bc-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &bc-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &bc-time;</para>
</listitem>
</itemizedlist>
</sect2>
<sect2 role="installation">
<title>Installation of Bc</title>
<para>Install <application>bc</application> by running the following commands:</para>
<screen><userinput>sed -i '/PROTO.*readline/d' bc/scan.l &amp;&amp;
sed -i '/flex -I8/s/8//' configure &amp;&amp;
sed -i '/stdlib/a #include &lt;string.h&gt;' lib/number.c &amp;&amp;
sed -i 's/program.*save/static &amp;/' bc/load.c &amp;&amp;
./configure --prefix=/usr --with-readline &amp;&amp;
make</userinput></screen>
<para>To test <application>bc</application>, run the commands below.
There is quite a bit of output, so you may want to redirect it to a file.
There are a very small percentage of tests (10 of 12,144) that will
indicate a roundoff error at the last digit.</para>
<screen><userinput>echo "quit" | ./bc/bc -l Test/checklib.b</userinput></screen>
<para>Now, as the <systemitem class="username">root</systemitem> user:</para>
<screen role="root"><userinput>make install</userinput></screen>
</sect2>
<sect2 role="commands">
<title>Command Explanations</title>
<para><command>sed -i '/PROTO.*readline/d' bc/scan.l</command>: This
command fixes the <application>Readline</application> library call.</para>
<para><command>sed -i '/flex -I8/s/8//' configure</command>: This
command fixes the <application>Flex</application> invocation.</para>
<para><command>sed -i '/stdlib/a #include &lt;string.h&gt;' lib/number.c</command>:
This command inserts a missing header.</para>
<para><command>sed -i 's/program.*save/static &amp;/' bc/load.c</command>:
This command fixes a segfault when running <application>bc</application>
with <command>bc -l</command>.</para>
<para><parameter>--with-readline</parameter>: This option enables
<application>Readline</application> support in interactive mode.</para>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>bc and dc</seg>
<seg>None</seg>
<seg>None</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="bc-prog">
<term><command>bc</command></term>
<listitem>
<para>is a calculator.</para>
<indexterm zone="bc bc-prog">
<primary sortas="b-bc">bc</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="dc">
<term><command>dc</command></term>
<listitem>
<para>is a reverse-polish calculator.</para>
<indexterm zone="bc dc">
<primary sortas="b-dc">dc</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>