Indenting chapter 6, part 5

git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@7344 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689
This commit is contained in:
Manuel Canales Esparcia 2006-02-04 13:28:41 +00:00
parent 54e422c1d9
commit 6a82dd9a18
5 changed files with 1442 additions and 1112 deletions

View File

@ -1,145 +1,181 @@
<?xml version="1.0" encoding="ISO-8859-1"?> <?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"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-system-gawk" role="wrap"> <sect1 id="ch-system-gawk" role="wrap">
<title>Gawk-&gawk-version;</title> <?dbhtml filename="gawk.html"?>
<?dbhtml filename="gawk.html"?>
<indexterm zone="ch-system-gawk"><primary sortas="a-Gawk">Gawk</primary></indexterm> <title>Gawk-&gawk-version;</title>
<sect2 role="package"><title/> <indexterm zone="ch-system-gawk">
<para>The Gawk package contains programs for manipulating text files.</para> <primary sortas="a-Gawk">Gawk</primary>
</indexterm>
<segmentedlist> <sect2 role="package">
<segtitle>&buildtime;</segtitle> <title/>
<segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.2 SBU</seg><seg>16.4 MB</seg></seglistitem>
</segmentedlist>
<segmentedlist> <para>The Gawk package contains programs for manipulating text files.</para>
<segtitle>&dependencies;</segtitle>
<seglistitem><seg>Bash, Binutils, Coreutils,
Diffutils, GCC, Gettext, Glibc, Grep, Make, and Sed</seg></seglistitem>
</segmentedlist>
</sect2>
<sect2 role="installation"> <segmentedlist>
<title>Installation of Gawk</title> <segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle>
<para>Under some circumstances, Gawk-&gawk-version; attempts to free a chunk <seglistitem>
of memory that was not allocated. This bug is fixed by the following patch:</para> <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>
<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> <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> <screen><userinput>./configure --prefix=/usr --libexecdir=/usr/lib</userinput></screen>
<para>Due to a bug in the <command>configure</command> script, Gawk fails <para>Due to a bug in the <command>configure</command> script, Gawk fails
to detect certain aspects of locale support in Glibc. This to detect certain aspects of locale support in Glibc. This bug leads to,
bug leads to, e.g., Gettext testsuite failures. Work around this issue e.g., Gettext testsuite failures. Work around this issue by appending the
by appending the missing macro definitions to <filename>config.h</filename>:</para> missing macro definitions to <filename>config.h</filename>:</para>
<screen><userinput>cat &gt;&gt;config.h &lt;&lt;"EOF" <screen><userinput>cat &gt;&gt;config.h &lt;&lt;"EOF"
<literal>#define HAVE_LANGINFO_CODESET 1 <literal>#define HAVE_LANGINFO_CODESET 1
#define HAVE_LC_MESSAGES 1</literal> #define HAVE_LC_MESSAGES 1</literal>
EOF</userinput></screen> EOF</userinput></screen>
<para>Compile the package:</para> <para>Compile the package:</para>
<screen><userinput>make</userinput></screen> <screen><userinput>make</userinput></screen>
<para>To test the results, issue: <para>To test the results, issue:
<userinput>make check</userinput>.</para> <userinput>make check</userinput>.</para>
<para>Install the package:</para> <para>Install the package:</para>
<screen><userinput>make install</userinput></screen> <screen><userinput>make install</userinput></screen>
</sect2> </sect2>
<sect2 id="contents-gawk" role="content">
<title>Contents of Gawk</title>
<sect2 id="contents-gawk" role="content"><title>Contents of Gawk</title> <segmentedlist>
<segtitle>Installed programs</segtitle>
<segmentedlist> <seglistitem>
<segtitle>Installed programs</segtitle> <seg>awk (link to gawk), gawk, gawk-&gawk-version;, grcat, igawk, pgawk,
<seglistitem><seg>awk (link to gawk), gawk, gawk-&gawk-version;, grcat, igawk, pgawk-&gawk-version;, and pwcat</seg>
pgawk, pgawk-&gawk-version;, and pwcat</seg></seglistitem> </seglistitem>
</segmentedlist> </segmentedlist>
<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead> <variablelist>
<?dbfo list-presentation="list"?> <bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbhtml list-presentation="table"?> <?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="awk"> <varlistentry id="awk">
<term><command>awk</command></term> <term><command>awk</command></term>
<listitem> <listitem>
<para>A link to <command>gawk</command></para> <para>A link to <command>gawk</command></para>
<indexterm zone="ch-system-gawk awk"><primary sortas="b-awk">awk</primary></indexterm> <indexterm zone="ch-system-gawk awk">
</listitem> <primary sortas="b-awk">awk</primary>
</varlistentry> </indexterm>
</listitem>
</varlistentry>
<varlistentry id="gawk"> <varlistentry id="gawk">
<term><command>gawk</command></term> <term><command>gawk</command></term>
<listitem> <listitem>
<para>A program for manipulating text files; it is the GNU <para>A program for manipulating text files; it is the GNU
implementation of <command>awk</command></para> implementation of <command>awk</command></para>
<indexterm zone="ch-system-gawk gawk"><primary sortas="b-gawk">gawk</primary></indexterm> <indexterm zone="ch-system-gawk gawk">
</listitem> <primary sortas="b-gawk">gawk</primary>
</varlistentry> </indexterm>
</listitem>
</varlistentry>
<varlistentry id="gawk-version"> <varlistentry id="gawk-version">
<term><command>gawk-&gawk-version;</command></term> <term><command>gawk-&gawk-version;</command></term>
<listitem> <listitem>
<para>A hard link to <command>gawk</command></para> <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> <indexterm zone="ch-system-gawk gawk-version">
</listitem> <primary sortas="b-gawk-&gawk-version;">gawk-&gawk-version;</primary>
</varlistentry> </indexterm>
</listitem>
</varlistentry>
<varlistentry id="grcat"> <varlistentry id="grcat">
<term><command>grcat</command></term> <term><command>grcat</command></term>
<listitem> <listitem>
<para>Dumps the group database <filename>/etc/group</filename></para> <para>Dumps the group database <filename>/etc/group</filename></para>
<indexterm zone="ch-system-gawk grcat"><primary sortas="b-grcat">grcat</primary></indexterm> <indexterm zone="ch-system-gawk grcat">
</listitem> <primary sortas="b-grcat">grcat</primary>
</varlistentry> </indexterm>
</listitem>
</varlistentry>
<varlistentry id="igawk"> <varlistentry id="igawk">
<term><command>igawk</command></term> <term><command>igawk</command></term>
<listitem> <listitem>
<para>Gives <command>gawk</command> the ability to include files</para> <para>Gives <command>gawk</command> the ability to include files</para>
<indexterm zone="ch-system-gawk igawk"><primary sortas="b-igawk">igawk</primary></indexterm> <indexterm zone="ch-system-gawk igawk">
</listitem> <primary sortas="b-igawk">igawk</primary>
</varlistentry> </indexterm>
</listitem>
</varlistentry>
<varlistentry id="pgawk"> <varlistentry id="pgawk">
<term><command>pgawk</command></term> <term><command>pgawk</command></term>
<listitem> <listitem>
<para>The profiling version of <command>gawk</command></para> <para>The profiling version of <command>gawk</command></para>
<indexterm zone="ch-system-gawk pgawk"><primary sortas="b-pgawk">pgawk</primary></indexterm> <indexterm zone="ch-system-gawk pgawk">
</listitem> <primary sortas="b-pgawk">pgawk</primary>
</varlistentry> </indexterm>
</listitem>
</varlistentry>
<varlistentry id="pgawk-version"> <varlistentry id="pgawk-version">
<term><command>pgawk-&gawk-version;</command></term> <term><command>pgawk-&gawk-version;</command></term>
<listitem> <listitem>
<para>Hard link to <command>pgawk</command></para> <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> <indexterm zone="ch-system-gawk pgawk-version">
</listitem> <primary sortas="b-pgawk-&gawk-version;">pgawk-&gawk-version;</primary>
</varlistentry> </indexterm>
</listitem>
</varlistentry>
<varlistentry id="pwcat"> <varlistentry id="pwcat">
<term><command>pwcat</command></term> <term><command>pwcat</command></term>
<listitem> <listitem>
<para>Dumps the password database <filename>/etc/passwd</filename></para> <para>Dumps the password database <filename>/etc/passwd</filename></para>
<indexterm zone="ch-system-gawk pwcat"><primary sortas="b-pwcat">pwcat</primary></indexterm> <indexterm zone="ch-system-gawk pwcat">
</listitem> <primary sortas="b-pwcat">pwcat</primary>
</varlistentry> </indexterm>
</variablelist> </listitem>
</varlistentry>
</sect2> </variablelist>
</sect2>
</sect1> </sect1>

View File

@ -1,217 +1,261 @@
<?xml version="1.0" encoding="ISO-8859-1"?> <?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"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-system-gcc" role="wrap"> <sect1 id="ch-system-gcc" role="wrap">
<title>GCC-&gcc-version;</title> <?dbhtml filename="gcc.html"?>
<?dbhtml filename="gcc.html"?>
<indexterm zone="ch-system-gcc"><primary sortas="a-GCC">GCC</primary></indexterm> <title>GCC-&gcc-version;</title>
<sect2 role="package"><title/> <indexterm zone="ch-system-gcc">
<para>The GCC package contains the GNU compiler collection, which includes <primary sortas="a-GCC">GCC</primary>
the C and C++ compilers.</para> </indexterm>
<segmentedlist> <sect2 role="package">
<segtitle>&buildtime;</segtitle> <title/>
<segtitle>&diskspace;</segtitle>
<seglistitem><seg>11.7 SBU</seg><seg>451 MB</seg></seglistitem>
</segmentedlist>
<segmentedlist> <para>The GCC package contains the GNU compiler collection, which includes
<segtitle>&dependencies;</segtitle> the C and C++ compilers.</para>
<seglistitem><seg>Bash, Binutils, Coreutils, Diffutils, Findutils,
Gawk, Gettext, Glibc, Grep, Make, Perl, Sed, and Texinfo</seg></seglistitem>
</segmentedlist>
</sect2>
<sect2 role="installation"> <segmentedlist>
<title>Installation of GCC</title> <segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle>
<para>Apply a <command>sed</command> substitution that will suppress the <seglistitem>
installation of <filename class="libraryfile">libiberty.a</filename>. The <seg>11.7 SBU</seg>
version of <filename class="libraryfile">libiberty.a</filename> provided by <seg>451 MB</seg>
Binutils will be used instead:</para> </seglistitem>
</segmentedlist>
<segmentedlist>
<segtitle>&dependencies;</segtitle>
<seglistitem>
<seg>Bash, Binutils, Coreutils, Diffutils, Findutils, Gawk, Gettext,
Glibc, Grep, Make, Perl, Sed, and Texinfo</seg>
</seglistitem>
</segmentedlist>
</sect2>
<sect2 role="installation">
<title>Installation of GCC</title>
<para>Apply a <command>sed</command> substitution that will suppress the
installation of <filename class="libraryfile">libiberty.a</filename>. The
version of <filename class="libraryfile">libiberty.a</filename> provided by
Binutils will be used instead:</para>
<screen><userinput>sed -i 's/install_to_$(INSTALL_DEST) //' libiberty/Makefile.in</userinput></screen> <screen><userinput>sed -i 's/install_to_$(INSTALL_DEST) //' libiberty/Makefile.in</userinput></screen>
<para>The bootstrap build performed in <xref linkend="ch-tools-gcc-pass1"/> <para>The bootstrap build performed in <xref linkend="ch-tools-gcc-pass1"/>
built GCC with the <option>-fomit-frame-pointer</option> compiler flag. built GCC with the <option>-fomit-frame-pointer</option> compiler flag.
Non-bootstrap builds omit this flag by default, so apply the following Non-bootstrap builds omit this flag by default, so apply the following
<command>sed</command> to use it in order to ensure consistent compiler builds. <command>sed</command> to use it in order to ensure consistent compiler
</para> builds.</para>
<screen><userinput>sed -i 's/^XCFLAGS =$/&amp; -fomit-frame-pointer/' gcc/Makefile.in</userinput></screen> <screen><userinput>sed -i 's/^XCFLAGS =$/&amp; -fomit-frame-pointer/' gcc/Makefile.in</userinput></screen>
<para>The <command>fixincludes</command> script is known to occasionally <para>The <command>fixincludes</command> script is known to occasionally
erroneously attempt to &quot;fix&quot; the system headers installed so far. As erroneously attempt to &quot;fix&quot; the system headers installed so far. As
the headers installed by GCC-&gcc-version; and Glibc-&glibc-version; are known the headers installed by GCC-&gcc-version; and Glibc-&glibc-version; are known
to not require fixing, issue the following command to prevent the to not require fixing, issue the following command to prevent the
<command>fixincludes</command> script from running:</para> <command>fixincludes</command> script from running:</para>
<screen><userinput>sed -i 's@\./fixinc\.sh@-c true@' gcc/Makefile.in</userinput></screen> <screen><userinput>sed -i 's@\./fixinc\.sh@-c true@' gcc/Makefile.in</userinput></screen>
<para>GCC provides a <command>gccbug</command> script which detects at <para>GCC provides a <command>gccbug</command> script which detects at
compile time whether mktemp is present, and hardcodes the result in a test. compile time whether mktemp is present, and hardcodes the result in a test.
This will cause the script to fall back to using less random names for This will cause the script to fall back to using less random names for
temporary files. We will be installing mktemp later, so the following sed temporary files. We will be installing mktemp later, so the following sed
will simulate its presence.</para> will simulate its presence.</para>
<screen>sed -i 's/@have_mktemp_command@/yes/' gcc/gccbug.in</screen> <screen>sed -i 's/@have_mktemp_command@/yes/' gcc/gccbug.in</screen>
<para>The GCC documentation recommends building GCC outside of the source <para>The GCC documentation recommends building GCC outside of the source
directory in a dedicated build directory:</para> directory in a dedicated build directory:</para>
<screen><userinput>mkdir -v ../gcc-build <screen><userinput>mkdir -v ../gcc-build
cd ../gcc-build</userinput></screen> cd ../gcc-build</userinput></screen>
<para>Prepare GCC for compilation:</para> <para>Prepare GCC for compilation:</para>
<screen><userinput>../gcc-&gcc-version;/configure --prefix=/usr \ <screen><userinput>../gcc-&gcc-version;/configure --prefix=/usr \
--libexecdir=/usr/lib --enable-shared \ --libexecdir=/usr/lib --enable-shared \
--enable-threads=posix --enable-__cxa_atexit \ --enable-threads=posix --enable-__cxa_atexit \
--enable-clocale=gnu --enable-languages=c,c++</userinput></screen> --enable-clocale=gnu --enable-languages=c,c++</userinput></screen>
<para>Compile the package:</para> <para>Compile the package:</para>
<screen><userinput>make</userinput></screen> <screen><userinput>make</userinput></screen>
<important><para>In this section, the test suite for GCC is considered <important>
critical. Do not skip it under any circumstance.</para></important> <para>In this section, the test suite for GCC is considered
critical. Do not skip it under any circumstance.</para>
</important>
<para>Test the results, but do not stop at errors:</para> <para>Test the results, but do not stop at errors:</para>
<screen><userinput>make -k check</userinput></screen> <screen><userinput>make -k check</userinput></screen>
<para>Some of the errors are known issues and were noted in the <para>Some of the errors are known issues and were noted in the
previous chapter. The test suite notes from <xref previous chapter. The test suite notes from <xref
linkend="ch-tools-gcc-pass2" role=","/> are still relevant here. Be sure to linkend="ch-tools-gcc-pass2" role=","/> are still relevant here. Be sure to
refer back to them as necessary.</para> refer back to them as necessary.</para>
<para>Install the package:</para> <para>Install the package:</para>
<screen><userinput>make install</userinput></screen> <screen><userinput>make install</userinput></screen>
<para>Some packages expect the C preprocessor to be installed in the <para>Some packages expect the C preprocessor to be installed in the
<filename class="directory">/lib</filename> directory. <filename class="directory">/lib</filename> directory.
To support those packages, create this symlink:</para> To support those packages, create this symlink:</para>
<screen><userinput>ln -sv ../usr/bin/cpp /lib</userinput></screen> <screen><userinput>ln -sv ../usr/bin/cpp /lib</userinput></screen>
<para>Many packages use the name <command>cc</command> to call the C <para>Many packages use the name <command>cc</command> to call the C
compiler. To satisfy those packages, create a symlink:</para> compiler. To satisfy those packages, create a symlink:</para>
<screen><userinput>ln -sv gcc /usr/bin/cc</userinput></screen> <screen><userinput>ln -sv gcc /usr/bin/cc</userinput></screen>
<note><para>At this point, it is strongly recommended to repeat the <note>
sanity check performed earlier in this chapter. Refer back to <xref <para>At this point, it is strongly recommended to repeat the sanity
linkend="ch-system-readjusting" role=","/> and repeat the check. If the results check performed earlier in this chapter. Refer back to <xref
are in error, then the most likely reason is that the GCC Specs patch linkend="ch-system-readjusting" role=","/> and repeat the check. If
from <xref linkend="chapter-temporary-tools"/> was erroneously applied the results are in error, then the most likely reason is that the GCC
here.</para></note> Specs patch from <xref linkend="chapter-temporary-tools"/> was
erroneously applied here.</para>
</note>
</sect2> </sect2>
<sect2 id="contents-gcc" role="content">
<title>Contents of GCC</title>
<sect2 id="contents-gcc" role="content"><title>Contents of GCC</title> <segmentedlist>
<segtitle>Installed programs</segtitle>
<segtitle>Installed libraries</segtitle>
<segmentedlist> <seglistitem>
<segtitle>Installed programs</segtitle> <seg>c++, cc (link to gcc), cpp, g++, gcc, gccbug, and gcov</seg>
<segtitle>Installed libraries</segtitle> <seg>libgcc.a, libgcc_eh.a, libgcc_s.so, libstdc++.[a,so], and
<seglistitem><seg>c++, cc (link to gcc), cpp, g++, gcc, gccbug, and libsupc++.a</seg>
gcov</seg> </seglistitem>
<seg>libgcc.a, libgcc_eh.a, libgcc_s.so, libstdc++.[a,so], and libsupc++.a</seg></seglistitem> </segmentedlist>
</segmentedlist>
<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead> <variablelist>
<?dbfo list-presentation="list"?> <bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbhtml list-presentation="table"?> <?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="cc"> <varlistentry id="cc">
<term><command>cc</command></term> <term><command>cc</command></term>
<listitem> <listitem>
<para>The C compiler</para> <para>The C compiler</para>
<indexterm zone="ch-system-gcc cc"><primary sortas="b-cc">cc</primary></indexterm> <indexterm zone="ch-system-gcc cc">
</listitem> <primary sortas="b-cc">cc</primary>
</varlistentry> </indexterm>
</listitem>
</varlistentry>
<varlistentry id="cpp"> <varlistentry id="cpp">
<term><command>cpp</command></term> <term><command>cpp</command></term>
<listitem> <listitem>
<para>The C preprocessor; it is used by the compiler to expand the <para>The C preprocessor; it is used by the compiler to expand the
#include, #define, and similar statements in the source files</para> #include, #define, and similar statements in the source files</para>
<indexterm zone="ch-system-gcc cpp"><primary sortas="b-cpp">cpp</primary></indexterm> <indexterm zone="ch-system-gcc cpp">
</listitem> <primary sortas="b-cpp">cpp</primary>
</varlistentry> </indexterm>
</listitem>
</varlistentry>
<varlistentry id="c"> <varlistentry id="c">
<term><command>c++</command></term> <term><command>c++</command></term>
<listitem> <listitem>
<para>The C++ compiler</para> <para>The C++ compiler</para>
<indexterm zone="ch-system-gcc c"><primary sortas="b-c++">c++</primary></indexterm> <indexterm zone="ch-system-gcc c">
</listitem> <primary sortas="b-c++">c++</primary>
</varlistentry> </indexterm>
</listitem>
</varlistentry>
<varlistentry id="g"> <varlistentry id="g">
<term><command>g++</command></term> <term><command>g++</command></term>
<listitem> <listitem>
<para>The C++ compiler</para> <para>The C++ compiler</para>
<indexterm zone="ch-system-gcc g"><primary sortas="b-g++">g++</primary></indexterm> <indexterm zone="ch-system-gcc g">
</listitem> <primary sortas="b-g++">g++</primary>
</varlistentry> </indexterm>
</listitem>
</varlistentry>
<varlistentry id="gcc"> <varlistentry id="gcc">
<term><command>gcc</command></term> <term><command>gcc</command></term>
<listitem> <listitem>
<para>The C compiler</para> <para>The C compiler</para>
<indexterm zone="ch-system-gcc gcc"><primary sortas="b-gcc">gcc</primary></indexterm> <indexterm zone="ch-system-gcc gcc">
</listitem> <primary sortas="b-gcc">gcc</primary>
</varlistentry> </indexterm>
</listitem>
</varlistentry>
<varlistentry id="gccbug"> <varlistentry id="gccbug">
<term><command>gccbug</command></term> <term><command>gccbug</command></term>
<listitem> <listitem>
<para>A shell script used to help create useful bug reports</para> <para>A shell script used to help create useful bug reports</para>
<indexterm zone="ch-system-gcc gccbug"><primary sortas="b-gccbug">gccbug</primary></indexterm> <indexterm zone="ch-system-gcc gccbug">
</listitem> <primary sortas="b-gccbug">gccbug</primary>
</varlistentry> </indexterm>
</listitem>
</varlistentry>
<varlistentry id="gcov"> <varlistentry id="gcov">
<term><command>gcov</command></term> <term><command>gcov</command></term>
<listitem> <listitem>
<para>A coverage testing tool; it is used to analyze programs to <para>A coverage testing tool; it is used to analyze programs to
determine where optimizations will have the most effect</para> determine where optimizations will have the most effect</para>
<indexterm zone="ch-system-gcc gcov"><primary sortas="b-gcov">gcov</primary></indexterm> <indexterm zone="ch-system-gcc gcov">
</listitem> <primary sortas="b-gcov">gcov</primary>
</varlistentry> </indexterm>
</listitem>
</varlistentry>
<varlistentry id="libgcc"> <varlistentry id="libgcc">
<term><filename class="libraryfile">libgcc</filename></term> <term><filename class="libraryfile">libgcc</filename></term>
<listitem> <listitem>
<para>Contains run-time support for <command>gcc</command></para> <para>Contains run-time support for <command>gcc</command></para>
<indexterm zone="ch-system-gcc libgcc"><primary sortas="c-libgcc*">libgcc*</primary></indexterm> <indexterm zone="ch-system-gcc libgcc">
</listitem> <primary sortas="c-libgcc*">libgcc*</primary>
</varlistentry> </indexterm>
</listitem>
</varlistentry>
<varlistentry id="libstdc"> <varlistentry id="libstdc">
<term><filename class="libraryfile">libstdc++</filename></term> <term><filename class="libraryfile">libstdc++</filename></term>
<listitem> <listitem>
<para>The standard C++ library</para> <para>The standard C++ library</para>
<indexterm zone="ch-system-gcc libstdc"><primary sortas="c-libstdc++">libstdc++</primary></indexterm> <indexterm zone="ch-system-gcc libstdc">
</listitem> <primary sortas="c-libstdc++">libstdc++</primary>
</varlistentry> </indexterm>
</listitem>
</varlistentry>
<varlistentry id="libsupc"> <varlistentry id="libsupc">
<term><filename class="libraryfile">libsupc++</filename></term> <term><filename class="libraryfile">libsupc++</filename></term>
<listitem> <listitem>
<para>Provides supporting routines for the C++ programming language</para> <para>Provides supporting routines for the C++ programming
<indexterm zone="ch-system-gcc libsupc"><primary sortas="c-libsupc++">libsupc++</primary></indexterm> language</para>
</listitem> <indexterm zone="ch-system-gcc libsupc">
</varlistentry> <primary sortas="c-libsupc++">libsupc++</primary>
</variablelist> </indexterm>
</listitem>
</varlistentry>
</sect2> </variablelist>
</sect2>
</sect1> </sect1>

View File

@ -1,308 +1,393 @@
<?xml version="1.0" encoding="ISO-8859-1"?> <?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"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-system-gettext" role="wrap"> <sect1 id="ch-system-gettext" role="wrap">
<title>Gettext-&gettext-version;</title> <?dbhtml filename="gettext.html"?>
<?dbhtml filename="gettext.html"?>
<indexterm zone="ch-system-gettext"><primary sortas="a-Gettext">Gettext</primary></indexterm> <title>Gettext-&gettext-version;</title>
<sect2 role="package"><title/> <indexterm zone="ch-system-gettext">
<para>The Gettext package contains utilities for internationalization and <primary sortas="a-Gettext">Gettext</primary>
localization. These allow programs to be compiled with NLS (Native Language </indexterm>
Support), enabling them to output messages in the user's native language.</para>
<segmentedlist> <sect2 role="package">
<segtitle>&buildtime;</segtitle> <title/>
<segtitle>&diskspace;</segtitle>
<seglistitem><seg>1.2 SBU</seg><seg>65.1 MB</seg></seglistitem>
</segmentedlist>
<segmentedlist> <para>The Gettext package contains utilities for internationalization and
<segtitle>&dependencies;</segtitle> localization. These allow programs to be compiled with NLS (Native Language
<seglistitem><seg>Bash, Binutils, Bison, Coreutils, Support), enabling them to output messages in the user's native
Diffutils, Gawk, GCC, Glibc, Grep, Make, and Sed</seg></seglistitem> language.</para>
</segmentedlist>
</sect2>
<sect2 role="installation"> <segmentedlist>
<title>Installation of Gettext</title> <segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle>
<para>Prepare Gettext for compilation:</para> <seglistitem>
<seg>1.2 SBU</seg>
<seg>65.1 MB</seg>
</seglistitem>
</segmentedlist>
<segmentedlist>
<segtitle>&dependencies;</segtitle>
<seglistitem>
<seg>Bash, Binutils, Bison, Coreutils, Diffutils, Gawk, GCC, Glibc,
Grep, Make, and Sed</seg>
</seglistitem>
</segmentedlist>
</sect2>
<sect2 role="installation">
<title>Installation of Gettext</title>
<para>Prepare Gettext for compilation:</para>
<screen><userinput>./configure --prefix=/usr</userinput></screen> <screen><userinput>./configure --prefix=/usr</userinput></screen>
<para>Compile the package:</para> <para>Compile the package:</para>
<screen><userinput>make</userinput></screen> <screen><userinput>make</userinput></screen>
<para>To test the results, issue: <para>To test the results, issue:
<userinput>make check</userinput>. This takes a very long time, around <userinput>make check</userinput>.
7 SBUs.</para> This takes a very long time, around 7 SBUs.</para>
<para>Install the package:</para> <para>Install the package:</para>
<screen><userinput>make install</userinput></screen> <screen><userinput>make install</userinput></screen>
</sect2> </sect2>
<sect2 id="contents-gettext" role="content">
<title>Contents of Gettext</title>
<sect2 id="contents-gettext" role="content"><title>Contents of Gettext</title> <segmentedlist>
<segtitle>Installed programs</segtitle>
<segtitle>Installed libraries</segtitle>
<segmentedlist> <seglistitem>
<segtitle>Installed programs</segtitle> <seg>autopoint, config.charset, config.rpath, envsubst, gettext,
<segtitle>Installed libraries</segtitle> gettextize, hostname, msgattrib, msgcat, msgcmp, msgcomm, msgconv, msgen,
<seglistitem><seg>autopoint, config.charset, config.rpath, envsubst, gettext, msgexec, msgfilter, msgfmt, msggrep, msginit, msgmerge, msgunfmt, msguniq,
gettextize, hostname, msgattrib, msgcat, msgcmp, msgcomm, msgconv, msgen, ngettext, and xgettext</seg>
msgexec, msgfilter, msgfmt, msggrep, msginit, msgmerge, msgunfmt, msguniq, <seg>libasprintf.[a,so], libgettextlib.so, libgettextpo.[a,so], and
ngettext, and xgettext</seg> libgettextsrc.so</seg>
<seg>libasprintf.[a,so], libgettextlib.so, libgettextpo.[a,so], and libgettextsrc.so</seg></seglistitem> </seglistitem>
</segmentedlist> </segmentedlist>
<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead> <variablelist>
<?dbfo list-presentation="list"?> <bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbhtml list-presentation="table"?> <?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="autopoint"> <varlistentry id="autopoint">
<term><command>autopoint</command></term> <term><command>autopoint</command></term>
<listitem> <listitem>
<para>Copies standard Gettext infrastructure files into a source package</para> <para>Copies standard Gettext infrastructure files into a source
<indexterm zone="ch-system-gettext autopoint"><primary sortas="b-autopoint">autopoint</primary></indexterm> package</para>
</listitem> <indexterm zone="ch-system-gettext autopoint">
</varlistentry> <primary sortas="b-autopoint">autopoint</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="config.charset"> <varlistentry id="config.charset">
<term><command>config.charset</command></term> <term><command>config.charset</command></term>
<listitem> <listitem>
<para>Outputs a system-dependent table of character encoding aliases</para> <para>Outputs a system-dependent table of character encoding
<indexterm zone="ch-system-gettext config.charset"><primary sortas="b-config.charset">config.charset</primary></indexterm> aliases</para>
</listitem> <indexterm zone="ch-system-gettext config.charset">
</varlistentry> <primary sortas="b-config.charset">config.charset</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="config.rpath"> <varlistentry id="config.rpath">
<term><command>config.rpath</command></term> <term><command>config.rpath</command></term>
<listitem> <listitem>
<para>Outputs a system-dependent set of variables, describing how to set the <para>Outputs a system-dependent set of variables, describing how
runtime search path of shared libraries in an executable</para> to set the runtime search path of shared libraries in an
<indexterm zone="ch-system-gettext config.rpath"><primary sortas="b-config.rpath">config.rpath</primary></indexterm> executable</para>
</listitem> <indexterm zone="ch-system-gettext config.rpath">
</varlistentry> <primary sortas="b-config.rpath">config.rpath</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="envsubst"> <varlistentry id="envsubst">
<term><command>envsubst</command></term> <term><command>envsubst</command></term>
<listitem> <listitem>
<para>Substitutes environment variables in shell format strings</para> <para>Substitutes environment variables in shell format strings</para>
<indexterm zone="ch-system-gettext envsubst"><primary sortas="b-envsubst">envsubst</primary></indexterm> <indexterm zone="ch-system-gettext envsubst">
</listitem> <primary sortas="b-envsubst">envsubst</primary>
</varlistentry> </indexterm>
</listitem>
</varlistentry>
<varlistentry id="gettext"> <varlistentry id="gettext">
<term><command>gettext</command></term> <term><command>gettext</command></term>
<listitem> <listitem>
<para>Translates a natural language message into the user's language <para>Translates a natural language message into the user's language
by looking up the translation in a message catalog</para> by looking up the translation in a message catalog</para>
<indexterm zone="ch-system-gettext gettext"><primary sortas="b-gettext">gettext</primary></indexterm> <indexterm zone="ch-system-gettext gettext">
</listitem> <primary sortas="b-gettext">gettext</primary>
</varlistentry> </indexterm>
</listitem>
</varlistentry>
<varlistentry id="gettextize"> <varlistentry id="gettextize">
<term><command>gettextize</command></term> <term><command>gettextize</command></term>
<listitem> <listitem>
<para>Copies all standard Gettext files into the given top-level <para>Copies all standard Gettext files into the given top-level
directory of a package to begin internationalizing it</para> directory of a package to begin internationalizing it</para>
<indexterm zone="ch-system-gettext gettextize"><primary sortas="b-gettextize">gettextize</primary></indexterm> <indexterm zone="ch-system-gettext gettextize">
</listitem> <primary sortas="b-gettextize">gettextize</primary>
</varlistentry> </indexterm>
</listitem>
</varlistentry>
<varlistentry id="hostname-gettext"> <varlistentry id="hostname-gettext">
<term><command>hostname</command></term> <term><command>hostname</command></term>
<listitem> <listitem>
<para>Displays a network hostname in various forms</para> <para>Displays a network hostname in various forms</para>
<indexterm zone="ch-system-gettext hostname-gettext"><primary sortas="b-hostname-gettext">hostname</primary></indexterm> <indexterm zone="ch-system-gettext hostname-gettext">
</listitem> <primary sortas="b-hostname-gettext">hostname</primary>
</varlistentry> </indexterm>
</listitem>
</varlistentry>
<varlistentry id="msgattrib"> <varlistentry id="msgattrib">
<term><command>msgattrib</command></term> <term><command>msgattrib</command></term>
<listitem> <listitem>
<para>Filters the messages of a translation catalog according to their <para>Filters the messages of a translation catalog according to their
attributes and manipulates the attributes</para> attributes and manipulates the attributes</para>
<indexterm zone="ch-system-gettext msgattrib"><primary sortas="b-msgattrib">msgattrib</primary></indexterm> <indexterm zone="ch-system-gettext msgattrib">
</listitem> <primary sortas="b-msgattrib">msgattrib</primary>
</varlistentry> </indexterm>
</listitem>
</varlistentry>
<varlistentry id="msgcat"> <varlistentry id="msgcat">
<term><command>msgcat</command></term> <term><command>msgcat</command></term>
<listitem> <listitem>
<para>Concatenates and merges the given <filename class="extension">.po</filename> files</para> <para>Concatenates and merges the given
<indexterm zone="ch-system-gettext msgcat"><primary sortas="b-msgcat">msgcat</primary></indexterm> <filename class="extension">.po</filename> files</para>
</listitem> <indexterm zone="ch-system-gettext msgcat">
</varlistentry> <primary sortas="b-msgcat">msgcat</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="msgcmp"> <varlistentry id="msgcmp">
<term><command>msgcmp</command></term> <term><command>msgcmp</command></term>
<listitem> <listitem>
<para>Compares two <filename class="extension">.po</filename> <para>Compares two <filename class="extension">.po</filename>
files to check that both contain the same set of msgid strings</para> files to check that both contain the same set of msgid strings</para>
<indexterm zone="ch-system-gettext msgcmp"><primary sortas="b-msgcmp">msgcmp</primary></indexterm> <indexterm zone="ch-system-gettext msgcmp">
</listitem> <primary sortas="b-msgcmp">msgcmp</primary>
</varlistentry> </indexterm>
</listitem>
</varlistentry>
<varlistentry id="msgcomm"> <varlistentry id="msgcomm">
<term><command>msgcomm</command></term> <term><command>msgcomm</command></term>
<listitem> <listitem>
<para>Finds the messages that are common to <para>Finds the messages that are common to to the given
to the given <filename class="extension">.po</filename> files</para> <filename class="extension">.po</filename> files</para>
<indexterm zone="ch-system-gettext msgcomm"><primary sortas="b-msgcomm">msgcomm</primary></indexterm> <indexterm zone="ch-system-gettext msgcomm">
</listitem> <primary sortas="b-msgcomm">msgcomm</primary>
</varlistentry> </indexterm>
</listitem>
</varlistentry>
<varlistentry id="msgconv"> <varlistentry id="msgconv">
<term><command>msgconv</command></term> <term><command>msgconv</command></term>
<listitem> <listitem>
<para>Converts a translation catalog to a different character encoding</para> <para>Converts a translation catalog to a different character
<indexterm zone="ch-system-gettext msgconv"><primary sortas="b-msgconv">msgconv</primary></indexterm> encoding</para>
</listitem> <indexterm zone="ch-system-gettext msgconv">
</varlistentry> <primary sortas="b-msgconv">msgconv</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="msgen"> <varlistentry id="msgen">
<term><command>msgen</command></term> <term><command>msgen</command></term>
<listitem> <listitem>
<para>Creates an English translation catalog</para> <para>Creates an English translation catalog</para>
<indexterm zone="ch-system-gettext msgen"><primary sortas="b-msgen">msgen</primary></indexterm> <indexterm zone="ch-system-gettext msgen">
</listitem> <primary sortas="b-msgen">msgen</primary>
</varlistentry> </indexterm>
</listitem>
</varlistentry>
<varlistentry id="msgexec"> <varlistentry id="msgexec">
<term><command>msgexec</command></term> <term><command>msgexec</command></term>
<listitem> <listitem>
<para>Applies a command to all translations of a translation catalog</para> <para>Applies a command to all translations of a translation
<indexterm zone="ch-system-gettext msgexec"><primary sortas="b-msgexec">msgexec</primary></indexterm> catalog</para>
</listitem> <indexterm zone="ch-system-gettext msgexec">
</varlistentry> <primary sortas="b-msgexec">msgexec</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="msgfilter"> <varlistentry id="msgfilter">
<term><command>msgfilter</command></term> <term><command>msgfilter</command></term>
<listitem> <listitem>
<para>Applies a filter to all translations of a translation catalog</para> <para>Applies a filter to all translations of a translation
<indexterm zone="ch-system-gettext msgfilter"><primary sortas="b-msgfilter">msgfilter</primary></indexterm> catalog</para>
</listitem> <indexterm zone="ch-system-gettext msgfilter">
</varlistentry> <primary sortas="b-msgfilter">msgfilter</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="msgfmt"> <varlistentry id="msgfmt">
<term><command>msgfmt</command></term> <term><command>msgfmt</command></term>
<listitem> <listitem>
<para>Generates a binary message catalog from a translation catalog</para> <para>Generates a binary message catalog from a translation
<indexterm zone="ch-system-gettext msgfmt"><primary sortas="b-msgfmt">msgfmt</primary></indexterm> catalog</para>
</listitem> <indexterm zone="ch-system-gettext msgfmt">
</varlistentry> <primary sortas="b-msgfmt">msgfmt</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="msggrep"> <varlistentry id="msggrep">
<term><command>msggrep</command></term> <term><command>msggrep</command></term>
<listitem> <listitem>
<para>Extracts all messages of a translation catalog that match a <para>Extracts all messages of a translation catalog that match a
given pattern or belong to some given source files</para> given pattern or belong to some given source files</para>
<indexterm zone="ch-system-gettext msggrep"><primary sortas="b-msggrep">msggrep</primary></indexterm> <indexterm zone="ch-system-gettext msggrep">
</listitem> <primary sortas="b-msggrep">msggrep</primary>
</varlistentry> </indexterm>
</listitem>
</varlistentry>
<varlistentry id="msginit"> <varlistentry id="msginit">
<term><command>msginit</command></term> <term><command>msginit</command></term>
<listitem> <listitem>
<para>Creates a new <filename class="extension">.po</filename> file, initializing the meta <para>Creates a new <filename class="extension">.po</filename> file,
information with values from the user's environment</para> initializing the meta information with values from the user's
<indexterm zone="ch-system-gettext msginit"><primary sortas="b-msginit">msginit</primary></indexterm> environment</para>
</listitem> <indexterm zone="ch-system-gettext msginit">
</varlistentry> <primary sortas="b-msginit">msginit</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="msgmerge"> <varlistentry id="msgmerge">
<term><command>msgmerge</command></term> <term><command>msgmerge</command></term>
<listitem> <listitem>
<para>Combines two raw translations into a single file</para> <para>Combines two raw translations into a single file</para>
<indexterm zone="ch-system-gettext msgmerge"><primary sortas="b-msgmerge">msgmerge</primary></indexterm> <indexterm zone="ch-system-gettext msgmerge">
</listitem> <primary sortas="b-msgmerge">msgmerge</primary>
</varlistentry> </indexterm>
</listitem>
</varlistentry>
<varlistentry id="msgunfmt"> <varlistentry id="msgunfmt">
<term><command>msgunfmt</command></term> <term><command>msgunfmt</command></term>
<listitem> <listitem>
<para>Decompiles a binary message catalog into raw translation text</para> <para>Decompiles a binary message catalog into raw translation
<indexterm zone="ch-system-gettext msgunfmt"><primary sortas="b-msgunfmt">msgunfmt</primary></indexterm> text</para>
</listitem> <indexterm zone="ch-system-gettext msgunfmt">
</varlistentry> <primary sortas="b-msgunfmt">msgunfmt</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="msguniq"> <varlistentry id="msguniq">
<term><command>msguniq</command></term> <term><command>msguniq</command></term>
<listitem> <listitem>
<para>Unifies duplicate translations in a translation catalog</para> <para>Unifies duplicate translations in a translation catalog</para>
<indexterm zone="ch-system-gettext msguniq"><primary sortas="b-msguniq">msguniq</primary></indexterm> <indexterm zone="ch-system-gettext msguniq">
</listitem> <primary sortas="b-msguniq">msguniq</primary>
</varlistentry> </indexterm>
</listitem>
</varlistentry>
<varlistentry id="ngettext"> <varlistentry id="ngettext">
<term><command>ngettext</command></term> <term><command>ngettext</command></term>
<listitem> <listitem>
<para>Displays native language translations of a textual message whose <para>Displays native language translations of a textual message whose
grammatical form depends on a number</para> grammatical form depends on a number</para>
<indexterm zone="ch-system-gettext ngettext"><primary sortas="b-ngettext">ngettext</primary></indexterm> <indexterm zone="ch-system-gettext ngettext">
</listitem> <primary sortas="b-ngettext">ngettext</primary>
</varlistentry> </indexterm>
</listitem>
</varlistentry>
<varlistentry id="xgettext"> <varlistentry id="xgettext">
<term><command>xgettext</command></term> <term><command>xgettext</command></term>
<listitem> <listitem>
<para>Extracts the translatable message lines from the given source <para>Extracts the translatable message lines from the given source
files to make the first translation template</para> files to make the first translation template</para>
<indexterm zone="ch-system-gettext xgettext"><primary sortas="b-xgettext">xgettext</primary></indexterm> <indexterm zone="ch-system-gettext xgettext">
</listitem> <primary sortas="b-xgettext">xgettext</primary>
</varlistentry> </indexterm>
</listitem>
</varlistentry>
<varlistentry id="libasprintf"> <varlistentry id="libasprintf">
<term><filename class="libraryfile">libasprintf</filename></term> <term><filename class="libraryfile">libasprintf</filename></term>
<listitem> <listitem>
<para>defines the <emphasis>autosprintf</emphasis> class, which makes <para>defines the <emphasis>autosprintf</emphasis> class, which makes
C formatted output routines usable in C++ programs, for use with the C formatted output routines usable in C++ programs, for use with the
<emphasis>&lt;string&gt;</emphasis> strings and the <emphasis>&lt;string&gt;</emphasis> strings and the
<emphasis>&lt;iostream&gt;</emphasis> streams</para> <emphasis>&lt;iostream&gt;</emphasis> streams</para>
<indexterm zone="ch-system-gettext libasprintf"><primary sortas="c-libasprintf">libasprintf</primary></indexterm> <indexterm zone="ch-system-gettext libasprintf">
</listitem> <primary sortas="c-libasprintf">libasprintf</primary>
</varlistentry> </indexterm>
</listitem>
</varlistentry>
<varlistentry id="libgettextlib"> <varlistentry id="libgettextlib">
<term><filename class="libraryfile">libgettextlib</filename></term> <term><filename class="libraryfile">libgettextlib</filename></term>
<listitem> <listitem>
<para>a private library containing common routines used by the various Gettext <para>a private library containing common routines used by the
programs; these are not intended for general use</para> various Gettext programs; these are not intended for general use</para>
<indexterm zone="ch-system-gettext libgettextlib"><primary sortas="c-libgettextlib">libgettextlib</primary></indexterm> <indexterm zone="ch-system-gettext libgettextlib">
</listitem> <primary sortas="c-libgettextlib">libgettextlib</primary>
</varlistentry> </indexterm>
</listitem>
</varlistentry>
<varlistentry id="libgettextpo"> <varlistentry id="libgettextpo">
<term><filename class="libraryfile">libgettextpo</filename></term> <term><filename class="libraryfile">libgettextpo</filename></term>
<listitem> <listitem>
<para>Used to write specialized programs that process <filename <para>Used to write specialized programs that process
class="extension">.po</filename> files; this library is used when the <filename class="extension">.po</filename> files; this library is
standard applications shipped with Gettext (such as used when the standard applications shipped with Gettext (such as
<command>msgcomm</command>, <command>msgcmp</command>, <command>msgcomm</command>, <command>msgcmp</command>,
<command>msgattrib</command>, and <command>msgen</command>) will not <command>msgattrib</command>, and <command>msgen</command>) will
suffice</para> not suffice</para>
<indexterm zone="ch-system-gettext libgettextpo"><primary sortas="c-libgettextpo">libgettextpo</primary></indexterm> <indexterm zone="ch-system-gettext libgettextpo">
</listitem> <primary sortas="c-libgettextpo">libgettextpo</primary>
</varlistentry> </indexterm>
</listitem>
</varlistentry>
<varlistentry id="libgettextsrc"> <varlistentry id="libgettextsrc">
<term><filename class="libraryfile">libgettextsrc</filename></term> <term><filename class="libraryfile">libgettextsrc</filename></term>
<listitem> <listitem>
<para>A private library containing common routines used by the various Gettext <para>A private library containing common routines used by the
programs; these are not intended for general use</para> various Gettext programs; these are not intended for general use</para>
<indexterm zone="ch-system-gettext libgettextsrc"><primary sortas="c-libgettextsrc">libgettextsrc</primary></indexterm> <indexterm zone="ch-system-gettext libgettextsrc">
</listitem> <primary sortas="c-libgettextsrc">libgettextsrc</primary>
</varlistentry> </indexterm>
</variablelist> </listitem>
</varlistentry>
</sect2> </variablelist>
</sect2>
</sect1> </sect1>

File diff suppressed because it is too large Load Diff

View File

@ -1,98 +1,123 @@
<?xml version="1.0" encoding="ISO-8859-1"?> <?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"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-system-grep" role="wrap"> <sect1 id="ch-system-grep" role="wrap">
<title>Grep-&grep-version;</title> <?dbhtml filename="grep.html"?>
<?dbhtml filename="grep.html"?>
<indexterm zone="ch-system-grep"><primary sortas="a-Grep">Grep</primary></indexterm> <title>Grep-&grep-version;</title>
<sect2 role="package"><title/> <indexterm zone="ch-system-grep">
<para>The Grep package contains programs for searching through files.</para> <primary sortas="a-Grep">Grep</primary>
</indexterm>
<segmentedlist> <sect2 role="package">
<segtitle>&buildtime;</segtitle> <title/>
<segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.1 SBU</seg><seg>4.5 MB</seg></seglistitem>
</segmentedlist>
<segmentedlist> <para>The Grep package contains programs for searching through files.</para>
<segtitle>&dependencies;</segtitle>
<seglistitem><seg>Bash, Binutils, Coreutils,
Diffutils, GCC, Gettext, Glibc, Make, Sed, and Texinfo</seg></seglistitem>
</segmentedlist>
</sect2>
<sect2 role="installation"> <segmentedlist>
<title>Installation of Grep</title> <segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle>
<para>The current Grep package has many bugs, especially in the support of <seglistitem>
multibyte locales. RedHat fixed some of them with the following patch:</para> <seg>0.1 SBU</seg>
<seg>4.5 MB</seg>
</seglistitem>
</segmentedlist>
<segmentedlist>
<segtitle>&dependencies;</segtitle>
<seglistitem>
<seg>Bash, Binutils, Coreutils, Diffutils, GCC, Gettext, Glibc, Make,
Sed, and Texinfo</seg>
</seglistitem>
</segmentedlist>
</sect2>
<sect2 role="installation">
<title>Installation of Grep</title>
<para>The current Grep package has many bugs, especially in the support of
multibyte locales. RedHat fixed some of them with the following patch:</para>
<screen><userinput>patch -Np1 -i ../&grep-fixes-patch;</userinput></screen> <screen><userinput>patch -Np1 -i ../&grep-fixes-patch;</userinput></screen>
<para>In order for the tests added by this patch to pass, the permissions for <para>In order for the tests added by this patch to pass, the permissions for
the test file have to be changed:</para> the test file have to be changed:</para>
<screen><userinput>chmod +x tests/fmbtest.sh</userinput></screen> <screen><userinput>chmod +x tests/fmbtest.sh</userinput></screen>
<para>Prepare Grep for compilation:</para> <para>Prepare Grep for compilation:</para>
<screen><userinput>./configure --prefix=/usr --bindir=/bin</userinput></screen> <screen><userinput>./configure --prefix=/usr --bindir=/bin</userinput></screen>
<para>Compile the package:</para> <para>Compile the package:</para>
<screen><userinput>make</userinput></screen> <screen><userinput>make</userinput></screen>
<para>To test the results, issue: <para>To test the results, issue:
<userinput>make check</userinput>.</para> <userinput>make check</userinput>.</para>
<para>Install the package:</para> <para>Install the package:</para>
<screen><userinput>make install</userinput></screen> <screen><userinput>make install</userinput></screen>
</sect2> </sect2>
<sect2 id="contents-grep" role="content">
<title>Contents of Grep</title>
<sect2 id="contents-grep" role="content"><title>Contents of Grep</title> <segmentedlist>
<segtitle>Installed programs</segtitle>
<segmentedlist> <seglistitem>
<segtitle>Installed programs</segtitle> <seg>egrep (link to grep), fgrep (link to grep), and grep</seg>
<seglistitem><seg>egrep (link to grep), fgrep (link to grep), and grep</seg></seglistitem> </seglistitem>
</segmentedlist> </segmentedlist>
<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead> <variablelist>
<?dbfo list-presentation="list"?> <bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbhtml list-presentation="table"?> <?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="egrep"> <varlistentry id="egrep">
<term><command>egrep</command></term> <term><command>egrep</command></term>
<listitem> <listitem>
<para>Prints lines matching an extended regular expression</para> <para>Prints lines matching an extended regular expression</para>
<indexterm zone="ch-system-grep egrep"><primary sortas="b-egrep">egrep</primary></indexterm> <indexterm zone="ch-system-grep egrep">
</listitem> <primary sortas="b-egrep">egrep</primary>
</varlistentry> </indexterm>
</listitem>
</varlistentry>
<varlistentry id="fgrep"> <varlistentry id="fgrep">
<term><command>fgrep</command></term> <term><command>fgrep</command></term>
<listitem> <listitem>
<para>Prints lines matching a list of fixed strings</para> <para>Prints lines matching a list of fixed strings</para>
<indexterm zone="ch-system-grep fgrep"><primary sortas="b-fgrep">fgrep</primary></indexterm> <indexterm zone="ch-system-grep fgrep">
</listitem> <primary sortas="b-fgrep">fgrep</primary>
</varlistentry> </indexterm>
</listitem>
</varlistentry>
<varlistentry id="grep"> <varlistentry id="grep">
<term><command>grep</command></term> <term><command>grep</command></term>
<listitem> <listitem>
<para>Prints lines matching a basic regular expression</para> <para>Prints lines matching a basic regular expression</para>
<indexterm zone="ch-system-grep grep"><primary sortas="b-grep">grep</primary></indexterm> <indexterm zone="ch-system-grep grep">
</listitem> <primary sortas="b-grep">grep</primary>
</varlistentry> </indexterm>
</variablelist> </listitem>
</varlistentry>
</sect2> </variablelist>
</sect2>
</sect1> </sect1>