lfs-book/chapter05/grep.xml

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../general.ent">
  %general-entities;
]>
<sect1 id="ch-tools-grep" role="wrap">
<title>Grep-&grep-version;</title>
<?dbhtml filename="grep.html"?>

<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>0.1 SBU</seg><seg>5.8 MB</seg></seglistitem>
</segmentedlist>

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

</sect2>

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

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

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

<para>The meaning of the configure options:</para>

<variablelist>
<varlistentry>
<term><parameter>--disable-perl-regexp</parameter></term>
<listitem><para>This makes sure that <command>grep</command> does not 
get linked against a PCRE library that may be present on the host and would not be 
available once we enter the chroot environment.</para></listitem>
</varlistentry>

<varlistentry>
<term><parameter>--with-included-regex</parameter></term>
<listitem><para>This ensures that
Grep uses its internal regular expression code. Without this switch, Grep will
use the code from Glibc, which is known to be slightly buggy.</para></listitem>
</varlistentry>
</variablelist>

<para>Compile the programs:</para>

<screen><userinput>make</userinput></screen>

<para>(If you insist on testing the results, then issue:
<userinput>make check</userinput>.)</para>

<para>Then install them and their documentation:</para>

<screen><userinput>make install</userinput></screen>

</sect2>

<sect2 role="content"><title/>
<para>The details on this package are found in <xref linkend="contents-grep"/>.</para>
</sect2>

</sect1>