source: BOOK/temp-system/common/grep.xml@ c152568

<?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-temp-system-grep" role="wrap">
  <?dbhtml filename="grep.html"?>

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

  <indexterm zone="ch-temp-system-grep">
    <primary sortas="a-Grep">Grep</primary>
    <secondary>temporary system</secondary>
  </indexterm>

  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
  href="../../final-system/common/grep.xml"
  xpointer="xpointer(//*[@role='package'])"/>

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

    <para os="t1">When cross compiling, the <command>configure</command> script
    does not determine the correct values for the following. Set the values
    manually:</para>

<screen os="t2"><userinput>cat &gt; config.cache &lt;&lt; EOF
ac_cv_func_malloc_0_nonnull=yes
ac_cv_func_realloc_0_nonnull=yes
EOF</userinput></screen>

    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    href="../../final-system/common/grep.xml"
    xpointer="xpointer(//*[@os='a'])"/>

<screen os="ca"><userinput>./configure --prefix=/tools \
    --build=${CLFS_HOST} --host=${CLFS_TARGET} \
    --disable-perl-regexp --without-included-regex \
    --cache-file=config.cache</userinput></screen>

    <variablelist os="cb">
      <title>The meaning of the configure options:</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 when building the final system.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><parameter>--without-included-regex</parameter></term>
        <listitem>
          <para>When cross-compiling, Grep's <command>configure</command>
          assumes there is no usable <filename>regex.h</filename> installed and
          instead uses the one included with Grep. This switch forces the use of
          the regex functions from EGLIBC.</para>
        </listitem>
      </varlistentry>

    </variablelist>

    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    href="../../final-system/common/grep.xml"
    xpointer="xpointer(//*[@os='c'])"/>

    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    href="../../final-system/common/grep.xml"
    xpointer="xpointer(//*[@os='d'])"/>

    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    href="../../final-system/common/grep.xml"
    xpointer="xpointer(//*[@os='f'])"/>

    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    href="../../final-system/common/grep.xml"
    xpointer="xpointer(//*[@os='g'])"/>

  </sect2>

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

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

  </sect2>

</sect1>