source: clfs-sysroot/BOOK/final-system/common/gawk.xml @ 3411c18

Last change on this file since 3411c18 was 3411c18, checked in by Joe Ciccone <jciccone@…>, 18 years ago

Added a command to gawk that adds HAVE_LANGINFO_CODESET and HAVE_LC_MESSAGES to config.h

  • Property mode set to 100644
File size: 4.9 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
3  "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
4  <!ENTITY % general-entities SYSTEM "../../general.ent">
5  %general-entities;
6]>
7
8<sect1 id="ch-system-gawk" role="wrap">
9  <?dbhtml filename="gawk.html"?>
10
11  <title>Gawk-&gawk-version;</title>
12
13  <indexterm zone="ch-system-gawk">
14    <primary sortas="a-Gawk">Gawk</primary>
15  </indexterm>
16
17  <sect2 role="package">
18    <title/>
19
20    <para>The Gawk package contains programs for manipulating text
21    files.</para>
22
23  </sect2>
24
25  <sect2 role="installation">
26    <title>Installation of Gawk</title>
27
28    <para os="a">Patch Gawk to fix a bug which causes it to
29    segfault when invoked on a non-existent file:</para>
30
31<screen os="b"><userinput>patch -Np1 -i ../&gawk-segfault-patch;</userinput></screen>
32
33    <para os="c">Prepare Gawk for compilation:</para>
34
35<screen os="d"><userinput>./configure --build=${CLFS_HOST} --host=${CLFS_TARGET} \
36    --prefix=/usr --libexecdir=/usr/lib</userinput></screen>
37
38    <para os="e">The <command>configure</command> script does not detect the
39    following properly:</para>
40
41<screen os="f"><userinput>cat &gt;&gt; config.h &lt;&lt; "EOF"
42#define HAVE_LANGINFO_CODESET 1
43#define HAVE_LC_MESSAGES 1
44EOF</userinput></screen>
45
46    <para os="g">Compile the package:</para>
47
48<screen os="h"><userinput>make</userinput></screen>
49
50    <para os="i">Install the package:</para>
51
52<screen os="j"><userinput>make DESTDIR=${CLFS} install</userinput></screen>
53
54  </sect2>
55
56  <sect2 id="contents-gawk" role="content">
57    <title>Contents of Gawk</title>
58
59    <segmentedlist>
60      <segtitle>Installed programs</segtitle>
61
62      <seglistitem>
63        <seg>awk (link to gawk), gawk, gawk-&gawk-version;, grcat, igawk,
64        pgawk, pgawk-&gawk-version;, and pwcat</seg>
65      </seglistitem>
66    </segmentedlist>
67
68    <variablelist>
69      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
70      <?dbfo list-presentation="list"?>
71      <?dbhtml list-presentation="table"?>
72
73      <varlistentry id="awk">
74        <term><command>awk</command></term>
75        <listitem>
76          <para>A link to <command>gawk</command></para>
77          <indexterm zone="ch-system-gawk awk">
78            <primary sortas="b-awk">awk</primary>
79          </indexterm>
80        </listitem>
81      </varlistentry>
82
83      <varlistentry id="gawk">
84        <term><command>gawk</command></term>
85        <listitem>
86          <para>A program for manipulating text files; it is the GNU
87          implementation of <command>awk</command></para>
88          <indexterm zone="ch-system-gawk gawk">
89            <primary sortas="b-gawk">gawk</primary>
90          </indexterm>
91        </listitem>
92      </varlistentry>
93
94      <varlistentry id="gawk-version">
95        <term><command>gawk-&gawk-version;</command></term>
96          <listitem>
97          <para>A hard link to <command>gawk</command></para>
98          <indexterm zone="ch-system-gawk gawk-version">
99            <primary sortas="b-gawk-&gawk-version;">gawk-&gawk-version;</primary>
100          </indexterm>
101        </listitem>
102      </varlistentry>
103
104      <varlistentry id="grcat">
105        <term><command>grcat</command></term>
106        <listitem>
107          <para>Dumps the group database <filename>/etc/group</filename></para>
108          <indexterm zone="ch-system-gawk grcat">
109            <primary sortas="b-grcat">grcat</primary>
110          </indexterm>
111        </listitem>
112      </varlistentry>
113
114      <varlistentry id="igawk">
115        <term><command>igawk</command></term>
116        <listitem>
117          <para>Gives <command>gawk</command> the ability to include files</para>
118          <indexterm zone="ch-system-gawk igawk">
119            <primary sortas="b-igawk">igawk</primary>
120          </indexterm>
121        </listitem>
122      </varlistentry>
123
124      <varlistentry id="pgawk">
125        <term><command>pgawk</command></term>
126        <listitem>
127          <para>The profiling version of <command>gawk</command></para>
128          <indexterm zone="ch-system-gawk pgawk">
129            <primary sortas="b-pgawk">pgawk</primary>
130          </indexterm>
131        </listitem>
132      </varlistentry>
133
134      <varlistentry id="pgawk-version">
135        <term><command>pgawk-&gawk-version;</command></term>
136        <listitem>
137          <para>Hard link to <command>pgawk</command></para>
138          <indexterm zone="ch-system-gawk pgawk-version">
139            <primary sortas="b-pgawk-&gawk-version;">pgawk-&gawk-version;</primary>
140          </indexterm>
141        </listitem>
142      </varlistentry>
143
144      <varlistentry id="pwcat">
145        <term><command>pwcat</command></term>
146        <listitem>
147          <para>Dumps the password database <filename>/etc/passwd</filename></para>
148          <indexterm zone="ch-system-gawk pwcat">
149            <primary sortas="b-pwcat">pwcat</primary>
150          </indexterm>
151        </listitem>
152      </varlistentry>
153
154    </variablelist>
155
156  </sect2>
157
158</sect1>
Note: See TracBrowser for help on using the repository browser.