source: chapter05/gawk.xml@ f1994dc

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

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

  <title>Gawk-&gawk-version;</title>

  <indexterm zone="ch-tools-gawk">
    <primary sortas="a-Gawk">Gawk</primary>
    <secondary>tools</secondary>
  </indexterm>

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

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

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

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

  </sect2>

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

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

<screen><userinput remap="configure">./configure --prefix=/tools ac_cv_func_working_mktime=yes</userinput></screen>

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

      <varlistentry>
        <term><parameter>ac_cv_func_working_mktime=yes</parameter></term>
        <listitem>
          <para>This parameter bypasses the search for mktime in
          <command>configure</command> and uses the version in Glibc. This is
          necessary due to a change in GCC that has not been incorporated into
          this package yet.</para>
        </listitem>
      </varlistentry>

    </variablelist>

<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 Gawk test suite anyway, issue the following command:</para>

    <para>To test the results, issue:</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-gawk" role="."/></para>

  </sect2>

</sect1>