diff options
Diffstat (limited to 'chapter06/gawk.xml')
| -rw-r--r-- | chapter06/gawk.xml | 262 |
1 files changed, 149 insertions, 113 deletions
diff --git a/chapter06/gawk.xml b/chapter06/gawk.xml index 710ef57ef..13e5bb818 100644 --- a/chapter06/gawk.xml +++ b/chapter06/gawk.xml @@ -1,145 +1,181 @@ <?xml version="1.0" encoding="ISO-8859-1"?> -<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ +<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" + "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ <!ENTITY % general-entities SYSTEM "../general.ent"> %general-entities; ]> + <sect1 id="ch-system-gawk" role="wrap"> -<title>Gawk-&gawk-version;</title> -<?dbhtml filename="gawk.html"?> + <?dbhtml filename="gawk.html"?> + + <title>Gawk-&gawk-version;</title> + + <indexterm zone="ch-system-gawk"> + <primary sortas="a-Gawk">Gawk</primary> + </indexterm> + + <sect2 role="package"> + <title/> -<indexterm zone="ch-system-gawk"><primary sortas="a-Gawk">Gawk</primary></indexterm> + <para>The Gawk package contains programs for manipulating text files.</para> -<sect2 role="package"><title/> -<para>The Gawk package contains programs for manipulating text files.</para> + <segmentedlist> + <segtitle>&buildtime;</segtitle> + <segtitle>&diskspace;</segtitle> -<segmentedlist> -<segtitle>&buildtime;</segtitle> -<segtitle>&diskspace;</segtitle> -<seglistitem><seg>0.2 SBU</seg><seg>16.4 MB</seg></seglistitem> -</segmentedlist> + <seglistitem> + <seg>0.2 SBU</seg> + <seg>16.4 MB</seg> + </seglistitem> + </segmentedlist> -<segmentedlist> -<segtitle>&dependencies;</segtitle> -<seglistitem><seg>Bash, Binutils, Coreutils, -Diffutils, GCC, Gettext, Glibc, Grep, Make, and Sed</seg></seglistitem> -</segmentedlist> -</sect2> + <segmentedlist> + <segtitle>&dependencies;</segtitle> -<sect2 role="installation"> -<title>Installation of Gawk</title> + <seglistitem> + <seg>Bash, Binutils, Coreutils, Diffutils, GCC, Gettext, Glibc, + Grep, Make, and Sed</seg> + </seglistitem> + </segmentedlist> -<para>Under some circumstances, Gawk-&gawk-version; attempts to free a chunk -of memory that was not allocated. This bug is fixed by the following patch:</para> + </sect2> + + <sect2 role="installation"> + <title>Installation of Gawk</title> + + <para>Under some circumstances, Gawk-&gawk-version; attempts to free a + chunk of memory that was not allocated. This bug is fixed by the following + patch:</para> <screen><userinput>patch -Np1 -i ../&gawk-segfault-patch;</userinput></screen> -<para>Prepare Gawk for compilation:</para> + <para>Prepare Gawk for compilation:</para> <screen><userinput>./configure --prefix=/usr --libexecdir=/usr/lib</userinput></screen> -<para>Due to a bug in the <command>configure</command> script, Gawk fails -to detect certain aspects of locale support in Glibc. This -bug leads to, e.g., Gettext testsuite failures. Work around this issue -by appending the missing macro definitions to <filename>config.h</filename>:</para> + <para>Due to a bug in the <command>configure</command> script, Gawk fails + to detect certain aspects of locale support in Glibc. This bug leads to, + e.g., Gettext testsuite failures. Work around this issue by appending the + missing macro definitions to <filename>config.h</filename>:</para> <screen><userinput>cat >>config.h <<"EOF" <literal>#define HAVE_LANGINFO_CODESET 1 #define HAVE_LC_MESSAGES 1</literal> EOF</userinput></screen> -<para>Compile the package:</para> + <para>Compile the package:</para> <screen><userinput>make</userinput></screen> -<para>To test the results, issue: -<userinput>make check</userinput>.</para> + <para>To test the results, issue: + <userinput>make check</userinput>.</para> -<para>Install the package:</para> + <para>Install the package:</para> <screen><userinput>make install</userinput></screen> -</sect2> - - -<sect2 id="contents-gawk" role="content"><title>Contents of Gawk</title> - -<segmentedlist> -<segtitle>Installed programs</segtitle> -<seglistitem><seg>awk (link to gawk), gawk, gawk-&gawk-version;, grcat, igawk, -pgawk, pgawk-&gawk-version;, and pwcat</seg></seglistitem> -</segmentedlist> - -<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead> -<?dbfo list-presentation="list"?> -<?dbhtml list-presentation="table"?> - -<varlistentry id="awk"> -<term><command>awk</command></term> -<listitem> -<para>A link to <command>gawk</command></para> -<indexterm zone="ch-system-gawk awk"><primary sortas="b-awk">awk</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="gawk"> -<term><command>gawk</command></term> -<listitem> -<para>A program for manipulating text files; it is the GNU -implementation of <command>awk</command></para> -<indexterm zone="ch-system-gawk gawk"><primary sortas="b-gawk">gawk</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="gawk-version"> -<term><command>gawk-&gawk-version;</command></term> -<listitem> -<para>A hard link to <command>gawk</command></para> -<indexterm zone="ch-system-gawk gawk-version"><primary sortas="b-gawk-&gawk-version;">gawk-&gawk-version;</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="grcat"> -<term><command>grcat</command></term> -<listitem> -<para>Dumps the group database <filename>/etc/group</filename></para> -<indexterm zone="ch-system-gawk grcat"><primary sortas="b-grcat">grcat</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="igawk"> -<term><command>igawk</command></term> -<listitem> -<para>Gives <command>gawk</command> the ability to include files</para> -<indexterm zone="ch-system-gawk igawk"><primary sortas="b-igawk">igawk</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="pgawk"> -<term><command>pgawk</command></term> -<listitem> -<para>The profiling version of <command>gawk</command></para> -<indexterm zone="ch-system-gawk pgawk"><primary sortas="b-pgawk">pgawk</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="pgawk-version"> -<term><command>pgawk-&gawk-version;</command></term> -<listitem> -<para>Hard link to <command>pgawk</command></para> -<indexterm zone="ch-system-gawk pgawk-version"><primary sortas="b-pgawk-&gawk-version;">pgawk-&gawk-version;</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="pwcat"> -<term><command>pwcat</command></term> -<listitem> -<para>Dumps the password database <filename>/etc/passwd</filename></para> -<indexterm zone="ch-system-gawk pwcat"><primary sortas="b-pwcat">pwcat</primary></indexterm> -</listitem> -</varlistentry> -</variablelist> - -</sect2> + </sect2> + + <sect2 id="contents-gawk" role="content"> + <title>Contents of Gawk</title> + + <segmentedlist> + <segtitle>Installed programs</segtitle> + + <seglistitem> + <seg>awk (link to gawk), gawk, gawk-&gawk-version;, grcat, igawk, pgawk, + pgawk-&gawk-version;, and pwcat</seg> + </seglistitem> + </segmentedlist> + + <variablelist> + <bridgehead renderas="sect3">Short Descriptions</bridgehead> + <?dbfo list-presentation="list"?> + <?dbhtml list-presentation="table"?> + + <varlistentry id="awk"> + <term><command>awk</command></term> + <listitem> + <para>A link to <command>gawk</command></para> + <indexterm zone="ch-system-gawk awk"> + <primary sortas="b-awk">awk</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="gawk"> + <term><command>gawk</command></term> + <listitem> + <para>A program for manipulating text files; it is the GNU + implementation of <command>awk</command></para> + <indexterm zone="ch-system-gawk gawk"> + <primary sortas="b-gawk">gawk</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="gawk-version"> + <term><command>gawk-&gawk-version;</command></term> + <listitem> + <para>A hard link to <command>gawk</command></para> + <indexterm zone="ch-system-gawk gawk-version"> + <primary sortas="b-gawk-&gawk-version;">gawk-&gawk-version;</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="grcat"> + <term><command>grcat</command></term> + <listitem> + <para>Dumps the group database <filename>/etc/group</filename></para> + <indexterm zone="ch-system-gawk grcat"> + <primary sortas="b-grcat">grcat</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="igawk"> + <term><command>igawk</command></term> + <listitem> + <para>Gives <command>gawk</command> the ability to include files</para> + <indexterm zone="ch-system-gawk igawk"> + <primary sortas="b-igawk">igawk</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="pgawk"> + <term><command>pgawk</command></term> + <listitem> + <para>The profiling version of <command>gawk</command></para> + <indexterm zone="ch-system-gawk pgawk"> + <primary sortas="b-pgawk">pgawk</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="pgawk-version"> + <term><command>pgawk-&gawk-version;</command></term> + <listitem> + <para>Hard link to <command>pgawk</command></para> + <indexterm zone="ch-system-gawk pgawk-version"> + <primary sortas="b-pgawk-&gawk-version;">pgawk-&gawk-version;</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="pwcat"> + <term><command>pwcat</command></term> + <listitem> + <para>Dumps the password database <filename>/etc/passwd</filename></para> + <indexterm zone="ch-system-gawk pwcat"> + <primary sortas="b-pwcat">pwcat</primary> + </indexterm> + </listitem> + </varlistentry> + + </variablelist> + + </sect2> </sect1> - |