lfs-book/chapter05/grep.xml

<?xml version="1.0" encoding="ISO-8859-1"?>
<!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-tools-grep" role="wrap">
  <?dbhtml filename="grep.html"?>

  <sect1info condition="script">
    <productname>grep</productname>
    <productnumber>&grep-version;</productnumber>
    <address>&grep-url;</address>
  </sect1info>

  <title>Grep-&grep-version;</title>

  <indexterm zone="ch-tools-grep">
    <primary sortas="a-Grep">Grep</primary>
    <secondary>tools</secondary>
  </indexterm>

  <sect2 role="package">
    <title/>

    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
    href="../chapter06/grep.xml"
    xpointer="xpointer(/sect1/sect2[1]/para[1])"/>

    <segmentedlist>
      <segtitle>&buildtime;</segtitle>
      <segtitle>&diskspace;</segtitle>

      <seglistitem>
        <seg>&grep-ch5-sbu;</seg>
        <seg>&grep-ch5-du;</seg>
      </seglistitem>
    </segmentedlist>

  </sect2>

  <sect2 role="installation">
    <title>Installation of Grep</title>

    <para>Prepare Grep for compilation:</para>

<screen><userinput remap="configure">./configure --prefix=/tools \
    --disable-perl-regexp \
    --without-included-regex</userinput></screen>

    <variablelist>
      <title>The meaning of the configure switches:</title>

      <varlistentry>
        <term><parameter>--disable-perl-regexp</parameter></term>
        <listitem>
          <para>This ensures that the <command>grep</command> program does
          not get linked against a Perl Compatible Regular Expression (PCRE)
          library that may be present on the host but will not be available
          once we enter the <command>chroot</command> environment.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><parameter>--without-included-regex</parameter></term>
        <listitem>
          <para>The configure check for glibc's regex library is broken when
          building against glibc-2.8.  This switch forces the use of glibc's
          regex library.</para>
        </listitem>
      </varlistentry>
    </variablelist>

    <para>Compile the package:</para>

<screen><userinput remap="make">make</userinput></screen>

    <para>Compilation is now complete. As discussed earlier, running the test
    suite is not mandatory for the temporary tools here in this chapter. To run
    the Grep test suite anyway, issue the following command:</para>

<screen><userinput remap="test">make check</userinput></screen>

    <para>Install the package:</para>

<screen><userinput remap="install">make install</userinput></screen>

  </sect2>

  <sect2 role="content">
    <title/>

    <para>Details on this package are located in
    <xref linkend="contents-grep" role="."/></para>

  </sect2>

</sect1>