lfs/chapter08/libtool.xml
Xi Ruoyao 9ac6ff55fc
libtool: Add "or newer" after "grep-3.8"
We have grep-3.11 now.
2024-01-25 05:13:47 +08:00

133 lines
4.0 KiB
XML

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities;
]>
<sect1 id="ch-system-libtool" role="wrap">
<?dbhtml filename="libtool.html"?>
<sect1info condition="script">
<productname>libtool</productname>
<productnumber>&libtool-version;</productnumber>
<address>&libtool-url;</address>
</sect1info>
<title>Libtool-&libtool-version;</title>
<indexterm zone="ch-system-libtool">
<primary sortas="a-Libtool">Libtool</primary>
</indexterm>
<sect2 role="package">
<title/>
<para>The Libtool package contains the GNU generic library support script.
It makes the use of shared libraries simpler with a consistent, portable
interface.</para>
<segmentedlist>
<segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle>
<seglistitem>
<seg>&libtool-fin-sbu;</seg>
<seg>&libtool-fin-du;</seg>
</seglistitem>
</segmentedlist>
</sect2>
<sect2 role="installation">
<title>Installation of Libtool</title>
<para>Prepare Libtool for compilation:</para>
<screen><userinput remap="configure">./configure --prefix=/usr</userinput></screen>
<para>Compile the package:</para>
<screen><userinput remap="make">make</userinput></screen>
<para>To test the results<!--(about 11.0 SBU)-->, issue:</para>
<screen><userinput remap="test">make -k check</userinput></screen>
<para>Five tests are known to fail in the LFS build environment due
to a circular dependency, but these tests pass if rechecked after
automake has been installed. Additionally, with grep-3.8 or newer,
two tests will trigger a warning for non-POSIX regular expressions and
fail.</para>
<para>Install the package:</para>
<screen><userinput remap="install">make install</userinput></screen>
<!-- dev: - -disable-static works but causes additional test failures
so we manually remove the static library -->
<para>Remove a useless static library:</para>
<screen><userinput remap="install">rm -fv /usr/lib/libltdl.a</userinput></screen>
</sect2>
<sect2 id="contents-libtool" role="content">
<title>Contents of Libtool</title>
<segmentedlist>
<segtitle>Installed programs</segtitle>
<segtitle>Installed libraries</segtitle>
<segtitle>Installed directories</segtitle>
<seglistitem>
<seg>libtool and libtoolize</seg>
<seg>libltdl.so</seg>
<seg>/usr/include/libltdl and /usr/share/libtool</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="libtool">
<term><command>libtool</command></term>
<listitem>
<para>Provides generalized library-building support services</para>
<indexterm zone="ch-system-libtool libtool">
<primary sortas="b-libtool">libtool</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libtoolize">
<term><command>libtoolize</command></term>
<listitem>
<para>Provides a standard way to add <command>libtool</command>
support to a package</para>
<indexterm zone="ch-system-libtool libtoolize">
<primary sortas="b-libtoolize">libtoolize</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libltdl">
<term><filename class="libraryfile">libltdl</filename></term>
<listitem>
<para>Hides the various difficulties of opening dynamically loaded libraries</para>
<indexterm zone="ch-system-libtool libltdl">
<primary sortas="c-libltdl">libltdl</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>