mirror of
https://git.linuxfromscratch.org/lfs.git
synced 2025-03-05 22:04:48 +00:00
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
parent
54e422c1d9
commit
6a82dd9a18
@ -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"?>
|
||||
|
||||
<indexterm zone="ch-system-gawk"><primary sortas="a-Gawk">Gawk</primary></indexterm>
|
||||
<title>Gawk-&gawk-version;</title>
|
||||
|
||||
<sect2 role="package"><title/>
|
||||
<para>The Gawk package contains programs for manipulating text files.</para>
|
||||
<indexterm zone="ch-system-gawk">
|
||||
<primary sortas="a-Gawk">Gawk</primary>
|
||||
</indexterm>
|
||||
|
||||
<segmentedlist>
|
||||
<segtitle>&buildtime;</segtitle>
|
||||
<segtitle>&diskspace;</segtitle>
|
||||
<seglistitem><seg>0.2 SBU</seg><seg>16.4 MB</seg></seglistitem>
|
||||
</segmentedlist>
|
||||
<sect2 role="package">
|
||||
<title/>
|
||||
|
||||
<segmentedlist>
|
||||
<segtitle>&dependencies;</segtitle>
|
||||
<seglistitem><seg>Bash, Binutils, Coreutils,
|
||||
Diffutils, GCC, Gettext, Glibc, Grep, Make, and Sed</seg></seglistitem>
|
||||
</segmentedlist>
|
||||
</sect2>
|
||||
<para>The Gawk package contains programs for manipulating text files.</para>
|
||||
|
||||
<sect2 role="installation">
|
||||
<title>Installation of Gawk</title>
|
||||
<segmentedlist>
|
||||
<segtitle>&buildtime;</segtitle>
|
||||
<segtitle>&diskspace;</segtitle>
|
||||
|
||||
<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>
|
||||
<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>
|
||||
|
||||
<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>
|
||||
|
||||
<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>
|
||||
<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>
|
||||
<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"?>
|
||||
<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="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">
|
||||
<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="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="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="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">
|
||||
<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="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>
|
||||
<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>
|
||||
|
||||
</sect2>
|
||||
</variablelist>
|
||||
|
||||
</sect2>
|
||||
|
||||
</sect1>
|
||||
|
||||
|
||||
@ -1,217 +1,261 @@
|
||||
<?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-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/>
|
||||
<para>The GCC package contains the GNU compiler collection, which includes
|
||||
the C and C++ compilers.</para>
|
||||
<indexterm zone="ch-system-gcc">
|
||||
<primary sortas="a-GCC">GCC</primary>
|
||||
</indexterm>
|
||||
|
||||
<segmentedlist>
|
||||
<segtitle>&buildtime;</segtitle>
|
||||
<segtitle>&diskspace;</segtitle>
|
||||
<seglistitem><seg>11.7 SBU</seg><seg>451 MB</seg></seglistitem>
|
||||
</segmentedlist>
|
||||
<sect2 role="package">
|
||||
<title/>
|
||||
|
||||
<segmentedlist>
|
||||
<segtitle>&dependencies;</segtitle>
|
||||
<seglistitem><seg>Bash, Binutils, Coreutils, Diffutils, Findutils,
|
||||
Gawk, Gettext, Glibc, Grep, Make, Perl, Sed, and Texinfo</seg></seglistitem>
|
||||
</segmentedlist>
|
||||
</sect2>
|
||||
<para>The GCC package contains the GNU compiler collection, which includes
|
||||
the C and C++ compilers.</para>
|
||||
|
||||
<sect2 role="installation">
|
||||
<title>Installation of GCC</title>
|
||||
<segmentedlist>
|
||||
<segtitle>&buildtime;</segtitle>
|
||||
<segtitle>&diskspace;</segtitle>
|
||||
|
||||
<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>
|
||||
<seglistitem>
|
||||
<seg>11.7 SBU</seg>
|
||||
<seg>451 MB</seg>
|
||||
</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>
|
||||
|
||||
<para>The bootstrap build performed in <xref linkend="ch-tools-gcc-pass1"/>
|
||||
built GCC with the <option>-fomit-frame-pointer</option> compiler flag.
|
||||
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.
|
||||
</para>
|
||||
<para>The bootstrap build performed in <xref linkend="ch-tools-gcc-pass1"/>
|
||||
built GCC with the <option>-fomit-frame-pointer</option> compiler flag.
|
||||
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.</para>
|
||||
|
||||
<screen><userinput>sed -i 's/^XCFLAGS =$/& -fomit-frame-pointer/' gcc/Makefile.in</userinput></screen>
|
||||
|
||||
<para>The <command>fixincludes</command> script is known to occasionally
|
||||
erroneously attempt to "fix" the system headers installed so far. As
|
||||
the headers installed by GCC-&gcc-version; and Glibc-&glibc-version; are known
|
||||
to not require fixing, issue the following command to prevent the
|
||||
<command>fixincludes</command> script from running:</para>
|
||||
<para>The <command>fixincludes</command> script is known to occasionally
|
||||
erroneously attempt to "fix" the system headers installed so far. As
|
||||
the headers installed by GCC-&gcc-version; and Glibc-&glibc-version; are known
|
||||
to not require fixing, issue the following command to prevent the
|
||||
<command>fixincludes</command> script from running:</para>
|
||||
|
||||
<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
|
||||
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
|
||||
temporary files. We will be installing mktemp later, so the following sed
|
||||
will simulate its presence.</para>
|
||||
<para>GCC provides a <command>gccbug</command> script which detects at
|
||||
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
|
||||
temporary files. We will be installing mktemp later, so the following sed
|
||||
will simulate its presence.</para>
|
||||
|
||||
<screen>sed -i 's/@have_mktemp_command@/yes/' gcc/gccbug.in</screen>
|
||||
|
||||
<para>The GCC documentation recommends building GCC outside of the source
|
||||
directory in a dedicated build directory:</para>
|
||||
<para>The GCC documentation recommends building GCC outside of the source
|
||||
directory in a dedicated build directory:</para>
|
||||
|
||||
<screen><userinput>mkdir -v ../gcc-build
|
||||
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 \
|
||||
--libexecdir=/usr/lib --enable-shared \
|
||||
--enable-threads=posix --enable-__cxa_atexit \
|
||||
--enable-clocale=gnu --enable-languages=c,c++</userinput></screen>
|
||||
|
||||
<para>Compile the package:</para>
|
||||
<para>Compile the package:</para>
|
||||
|
||||
<screen><userinput>make</userinput></screen>
|
||||
|
||||
<important><para>In this section, the test suite for GCC is considered
|
||||
critical. Do not skip it under any circumstance.</para></important>
|
||||
<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>
|
||||
|
||||
<para>Some of the errors are known issues and were noted in the
|
||||
previous chapter. The test suite notes from <xref
|
||||
linkend="ch-tools-gcc-pass2" role=","/> are still relevant here. Be sure to
|
||||
refer back to them as necessary.</para>
|
||||
<para>Some of the errors are known issues and were noted in the
|
||||
previous chapter. The test suite notes from <xref
|
||||
linkend="ch-tools-gcc-pass2" role=","/> are still relevant here. Be sure to
|
||||
refer back to them as necessary.</para>
|
||||
|
||||
<para>Install the package:</para>
|
||||
<para>Install the package:</para>
|
||||
|
||||
<screen><userinput>make install</userinput></screen>
|
||||
|
||||
<para>Some packages expect the C preprocessor to be installed in the
|
||||
<filename class="directory">/lib</filename> directory.
|
||||
To support those packages, create this symlink:</para>
|
||||
<para>Some packages expect the C preprocessor to be installed in the
|
||||
<filename class="directory">/lib</filename> directory.
|
||||
To support those packages, create this symlink:</para>
|
||||
|
||||
<screen><userinput>ln -sv ../usr/bin/cpp /lib</userinput></screen>
|
||||
|
||||
<para>Many packages use the name <command>cc</command> to call the C
|
||||
compiler. To satisfy those packages, create a symlink:</para>
|
||||
<para>Many packages use the name <command>cc</command> to call the C
|
||||
compiler. To satisfy those packages, create a symlink:</para>
|
||||
|
||||
<screen><userinput>ln -sv gcc /usr/bin/cc</userinput></screen>
|
||||
|
||||
<note><para>At this point, it is strongly recommended to repeat the
|
||||
sanity check performed earlier in this chapter. Refer back to <xref
|
||||
linkend="ch-system-readjusting" role=","/> and repeat the check. If the results
|
||||
are in error, then the most likely reason is that the GCC Specs patch
|
||||
from <xref linkend="chapter-temporary-tools"/> was erroneously applied
|
||||
here.</para></note>
|
||||
<note>
|
||||
<para>At this point, it is strongly recommended to repeat the sanity
|
||||
check performed earlier in this chapter. Refer back to <xref
|
||||
linkend="ch-system-readjusting" role=","/> and repeat the check. If
|
||||
the results are in error, then the most likely reason is that the GCC
|
||||
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>
|
||||
<segtitle>Installed programs</segtitle>
|
||||
<segtitle>Installed libraries</segtitle>
|
||||
<seglistitem><seg>c++, cc (link to gcc), cpp, g++, gcc, gccbug, and
|
||||
gcov</seg>
|
||||
<seg>libgcc.a, libgcc_eh.a, libgcc_s.so, libstdc++.[a,so], and libsupc++.a</seg></seglistitem>
|
||||
</segmentedlist>
|
||||
<seglistitem>
|
||||
<seg>c++, cc (link to gcc), cpp, g++, gcc, gccbug, and gcov</seg>
|
||||
<seg>libgcc.a, libgcc_eh.a, libgcc_s.so, libstdc++.[a,so], and
|
||||
libsupc++.a</seg>
|
||||
</seglistitem>
|
||||
</segmentedlist>
|
||||
|
||||
<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead>
|
||||
<?dbfo list-presentation="list"?>
|
||||
<?dbhtml list-presentation="table"?>
|
||||
<variablelist>
|
||||
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
|
||||
<?dbfo list-presentation="list"?>
|
||||
<?dbhtml list-presentation="table"?>
|
||||
|
||||
<varlistentry id="cc">
|
||||
<term><command>cc</command></term>
|
||||
<listitem>
|
||||
<para>The C compiler</para>
|
||||
<indexterm zone="ch-system-gcc cc"><primary sortas="b-cc">cc</primary></indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry id="cc">
|
||||
<term><command>cc</command></term>
|
||||
<listitem>
|
||||
<para>The C compiler</para>
|
||||
<indexterm zone="ch-system-gcc cc">
|
||||
<primary sortas="b-cc">cc</primary>
|
||||
</indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry id="cpp">
|
||||
<term><command>cpp</command></term>
|
||||
<listitem>
|
||||
<para>The C preprocessor; it is used by the compiler to expand the
|
||||
#include, #define, and similar statements in the source files</para>
|
||||
<indexterm zone="ch-system-gcc cpp"><primary sortas="b-cpp">cpp</primary></indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry id="cpp">
|
||||
<term><command>cpp</command></term>
|
||||
<listitem>
|
||||
<para>The C preprocessor; it is used by the compiler to expand the
|
||||
#include, #define, and similar statements in the source files</para>
|
||||
<indexterm zone="ch-system-gcc cpp">
|
||||
<primary sortas="b-cpp">cpp</primary>
|
||||
</indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry id="c">
|
||||
<term><command>c++</command></term>
|
||||
<listitem>
|
||||
<para>The C++ compiler</para>
|
||||
<indexterm zone="ch-system-gcc c"><primary sortas="b-c++">c++</primary></indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry id="c">
|
||||
<term><command>c++</command></term>
|
||||
<listitem>
|
||||
<para>The C++ compiler</para>
|
||||
<indexterm zone="ch-system-gcc c">
|
||||
<primary sortas="b-c++">c++</primary>
|
||||
</indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry id="g">
|
||||
<term><command>g++</command></term>
|
||||
<listitem>
|
||||
<para>The C++ compiler</para>
|
||||
<indexterm zone="ch-system-gcc g"><primary sortas="b-g++">g++</primary></indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry id="g">
|
||||
<term><command>g++</command></term>
|
||||
<listitem>
|
||||
<para>The C++ compiler</para>
|
||||
<indexterm zone="ch-system-gcc g">
|
||||
<primary sortas="b-g++">g++</primary>
|
||||
</indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry id="gcc">
|
||||
<term><command>gcc</command></term>
|
||||
<listitem>
|
||||
<para>The C compiler</para>
|
||||
<indexterm zone="ch-system-gcc gcc"><primary sortas="b-gcc">gcc</primary></indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry id="gcc">
|
||||
<term><command>gcc</command></term>
|
||||
<listitem>
|
||||
<para>The C compiler</para>
|
||||
<indexterm zone="ch-system-gcc gcc">
|
||||
<primary sortas="b-gcc">gcc</primary>
|
||||
</indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry id="gccbug">
|
||||
<term><command>gccbug</command></term>
|
||||
<listitem>
|
||||
<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>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry id="gccbug">
|
||||
<term><command>gccbug</command></term>
|
||||
<listitem>
|
||||
<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>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry id="gcov">
|
||||
<term><command>gcov</command></term>
|
||||
<listitem>
|
||||
<para>A coverage testing tool; it is used to analyze programs to
|
||||
determine where optimizations will have the most effect</para>
|
||||
<indexterm zone="ch-system-gcc gcov"><primary sortas="b-gcov">gcov</primary></indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry id="gcov">
|
||||
<term><command>gcov</command></term>
|
||||
<listitem>
|
||||
<para>A coverage testing tool; it is used to analyze programs to
|
||||
determine where optimizations will have the most effect</para>
|
||||
<indexterm zone="ch-system-gcc gcov">
|
||||
<primary sortas="b-gcov">gcov</primary>
|
||||
</indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry id="libgcc">
|
||||
<term><filename class="libraryfile">libgcc</filename></term>
|
||||
<listitem>
|
||||
<para>Contains run-time support for <command>gcc</command></para>
|
||||
<indexterm zone="ch-system-gcc libgcc"><primary sortas="c-libgcc*">libgcc*</primary></indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry id="libgcc">
|
||||
<term><filename class="libraryfile">libgcc</filename></term>
|
||||
<listitem>
|
||||
<para>Contains run-time support for <command>gcc</command></para>
|
||||
<indexterm zone="ch-system-gcc libgcc">
|
||||
<primary sortas="c-libgcc*">libgcc*</primary>
|
||||
</indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry id="libstdc">
|
||||
<term><filename class="libraryfile">libstdc++</filename></term>
|
||||
<listitem>
|
||||
<para>The standard C++ library</para>
|
||||
<indexterm zone="ch-system-gcc libstdc"><primary sortas="c-libstdc++">libstdc++</primary></indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry id="libstdc">
|
||||
<term><filename class="libraryfile">libstdc++</filename></term>
|
||||
<listitem>
|
||||
<para>The standard C++ library</para>
|
||||
<indexterm zone="ch-system-gcc libstdc">
|
||||
<primary sortas="c-libstdc++">libstdc++</primary>
|
||||
</indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry id="libsupc">
|
||||
<term><filename class="libraryfile">libsupc++</filename></term>
|
||||
<listitem>
|
||||
<para>Provides supporting routines for the C++ programming language</para>
|
||||
<indexterm zone="ch-system-gcc libsupc"><primary sortas="c-libsupc++">libsupc++</primary></indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
<varlistentry id="libsupc">
|
||||
<term><filename class="libraryfile">libsupc++</filename></term>
|
||||
<listitem>
|
||||
<para>Provides supporting routines for the C++ programming
|
||||
language</para>
|
||||
<indexterm zone="ch-system-gcc libsupc">
|
||||
<primary sortas="c-libsupc++">libsupc++</primary>
|
||||
</indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
</sect2>
|
||||
</variablelist>
|
||||
|
||||
</sect2>
|
||||
|
||||
</sect1>
|
||||
|
||||
|
||||
@ -1,308 +1,393 @@
|
||||
<?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-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/>
|
||||
<para>The Gettext package contains utilities for internationalization and
|
||||
localization. These allow programs to be compiled with NLS (Native Language
|
||||
Support), enabling them to output messages in the user's native language.</para>
|
||||
<indexterm zone="ch-system-gettext">
|
||||
<primary sortas="a-Gettext">Gettext</primary>
|
||||
</indexterm>
|
||||
|
||||
<segmentedlist>
|
||||
<segtitle>&buildtime;</segtitle>
|
||||
<segtitle>&diskspace;</segtitle>
|
||||
<seglistitem><seg>1.2 SBU</seg><seg>65.1 MB</seg></seglistitem>
|
||||
</segmentedlist>
|
||||
<sect2 role="package">
|
||||
<title/>
|
||||
|
||||
<segmentedlist>
|
||||
<segtitle>&dependencies;</segtitle>
|
||||
<seglistitem><seg>Bash, Binutils, Bison, Coreutils,
|
||||
Diffutils, Gawk, GCC, Glibc, Grep, Make, and Sed</seg></seglistitem>
|
||||
</segmentedlist>
|
||||
</sect2>
|
||||
<para>The Gettext package contains utilities for internationalization and
|
||||
localization. These allow programs to be compiled with NLS (Native Language
|
||||
Support), enabling them to output messages in the user's native
|
||||
language.</para>
|
||||
|
||||
<sect2 role="installation">
|
||||
<title>Installation of Gettext</title>
|
||||
<segmentedlist>
|
||||
<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>
|
||||
|
||||
<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>. This takes a very long time, around
|
||||
7 SBUs.</para>
|
||||
<para>To test the results, issue:
|
||||
<userinput>make check</userinput>.
|
||||
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>
|
||||
|
||||
</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>
|
||||
<segtitle>Installed programs</segtitle>
|
||||
<segtitle>Installed libraries</segtitle>
|
||||
<seglistitem><seg>autopoint, config.charset, config.rpath, envsubst, gettext,
|
||||
gettextize, hostname, msgattrib, msgcat, msgcmp, msgcomm, msgconv, msgen,
|
||||
msgexec, msgfilter, msgfmt, msggrep, msginit, msgmerge, msgunfmt, msguniq,
|
||||
ngettext, and xgettext</seg>
|
||||
<seg>libasprintf.[a,so], libgettextlib.so, libgettextpo.[a,so], and libgettextsrc.so</seg></seglistitem>
|
||||
</segmentedlist>
|
||||
<seglistitem>
|
||||
<seg>autopoint, config.charset, config.rpath, envsubst, gettext,
|
||||
gettextize, hostname, msgattrib, msgcat, msgcmp, msgcomm, msgconv, msgen,
|
||||
msgexec, msgfilter, msgfmt, msggrep, msginit, msgmerge, msgunfmt, msguniq,
|
||||
ngettext, and xgettext</seg>
|
||||
<seg>libasprintf.[a,so], libgettextlib.so, libgettextpo.[a,so], and
|
||||
libgettextsrc.so</seg>
|
||||
</seglistitem>
|
||||
</segmentedlist>
|
||||
|
||||
<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead>
|
||||
<?dbfo list-presentation="list"?>
|
||||
<?dbhtml list-presentation="table"?>
|
||||
<variablelist>
|
||||
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
|
||||
<?dbfo list-presentation="list"?>
|
||||
<?dbhtml list-presentation="table"?>
|
||||
|
||||
<varlistentry id="autopoint">
|
||||
<term><command>autopoint</command></term>
|
||||
<listitem>
|
||||
<para>Copies standard Gettext infrastructure files into a source package</para>
|
||||
<indexterm zone="ch-system-gettext autopoint"><primary sortas="b-autopoint">autopoint</primary></indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry id="autopoint">
|
||||
<term><command>autopoint</command></term>
|
||||
<listitem>
|
||||
<para>Copies standard Gettext infrastructure files into a source
|
||||
package</para>
|
||||
<indexterm zone="ch-system-gettext autopoint">
|
||||
<primary sortas="b-autopoint">autopoint</primary>
|
||||
</indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry id="config.charset">
|
||||
<term><command>config.charset</command></term>
|
||||
<listitem>
|
||||
<para>Outputs a system-dependent table of character encoding aliases</para>
|
||||
<indexterm zone="ch-system-gettext config.charset"><primary sortas="b-config.charset">config.charset</primary></indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry id="config.charset">
|
||||
<term><command>config.charset</command></term>
|
||||
<listitem>
|
||||
<para>Outputs a system-dependent table of character encoding
|
||||
aliases</para>
|
||||
<indexterm zone="ch-system-gettext config.charset">
|
||||
<primary sortas="b-config.charset">config.charset</primary>
|
||||
</indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry id="config.rpath">
|
||||
<term><command>config.rpath</command></term>
|
||||
<listitem>
|
||||
<para>Outputs a system-dependent set of variables, describing how to set the
|
||||
runtime search path of shared libraries in an executable</para>
|
||||
<indexterm zone="ch-system-gettext config.rpath"><primary sortas="b-config.rpath">config.rpath</primary></indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry id="config.rpath">
|
||||
<term><command>config.rpath</command></term>
|
||||
<listitem>
|
||||
<para>Outputs a system-dependent set of variables, describing how
|
||||
to set the runtime search path of shared libraries in an
|
||||
executable</para>
|
||||
<indexterm zone="ch-system-gettext config.rpath">
|
||||
<primary sortas="b-config.rpath">config.rpath</primary>
|
||||
</indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry id="envsubst">
|
||||
<term><command>envsubst</command></term>
|
||||
<listitem>
|
||||
<para>Substitutes environment variables in shell format strings</para>
|
||||
<indexterm zone="ch-system-gettext envsubst"><primary sortas="b-envsubst">envsubst</primary></indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry id="envsubst">
|
||||
<term><command>envsubst</command></term>
|
||||
<listitem>
|
||||
<para>Substitutes environment variables in shell format strings</para>
|
||||
<indexterm zone="ch-system-gettext envsubst">
|
||||
<primary sortas="b-envsubst">envsubst</primary>
|
||||
</indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry id="gettext">
|
||||
<term><command>gettext</command></term>
|
||||
<listitem>
|
||||
<para>Translates a natural language message into the user's language
|
||||
by looking up the translation in a message catalog</para>
|
||||
<indexterm zone="ch-system-gettext gettext"><primary sortas="b-gettext">gettext</primary></indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry id="gettext">
|
||||
<term><command>gettext</command></term>
|
||||
<listitem>
|
||||
<para>Translates a natural language message into the user's language
|
||||
by looking up the translation in a message catalog</para>
|
||||
<indexterm zone="ch-system-gettext gettext">
|
||||
<primary sortas="b-gettext">gettext</primary>
|
||||
</indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry id="gettextize">
|
||||
<term><command>gettextize</command></term>
|
||||
<listitem>
|
||||
<para>Copies all standard Gettext files into the given top-level
|
||||
directory of a package to begin internationalizing it</para>
|
||||
<indexterm zone="ch-system-gettext gettextize"><primary sortas="b-gettextize">gettextize</primary></indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry id="gettextize">
|
||||
<term><command>gettextize</command></term>
|
||||
<listitem>
|
||||
<para>Copies all standard Gettext files into the given top-level
|
||||
directory of a package to begin internationalizing it</para>
|
||||
<indexterm zone="ch-system-gettext gettextize">
|
||||
<primary sortas="b-gettextize">gettextize</primary>
|
||||
</indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry id="hostname-gettext">
|
||||
<term><command>hostname</command></term>
|
||||
<listitem>
|
||||
<para>Displays a network hostname in various forms</para>
|
||||
<indexterm zone="ch-system-gettext hostname-gettext"><primary sortas="b-hostname-gettext">hostname</primary></indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry id="hostname-gettext">
|
||||
<term><command>hostname</command></term>
|
||||
<listitem>
|
||||
<para>Displays a network hostname in various forms</para>
|
||||
<indexterm zone="ch-system-gettext hostname-gettext">
|
||||
<primary sortas="b-hostname-gettext">hostname</primary>
|
||||
</indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry id="msgattrib">
|
||||
<term><command>msgattrib</command></term>
|
||||
<listitem>
|
||||
<para>Filters the messages of a translation catalog according to their
|
||||
attributes and manipulates the attributes</para>
|
||||
<indexterm zone="ch-system-gettext msgattrib"><primary sortas="b-msgattrib">msgattrib</primary></indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry id="msgattrib">
|
||||
<term><command>msgattrib</command></term>
|
||||
<listitem>
|
||||
<para>Filters the messages of a translation catalog according to their
|
||||
attributes and manipulates the attributes</para>
|
||||
<indexterm zone="ch-system-gettext msgattrib">
|
||||
<primary sortas="b-msgattrib">msgattrib</primary>
|
||||
</indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry id="msgcat">
|
||||
<term><command>msgcat</command></term>
|
||||
<listitem>
|
||||
<para>Concatenates and merges the given <filename class="extension">.po</filename> files</para>
|
||||
<indexterm zone="ch-system-gettext msgcat"><primary sortas="b-msgcat">msgcat</primary></indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry id="msgcat">
|
||||
<term><command>msgcat</command></term>
|
||||
<listitem>
|
||||
<para>Concatenates and merges the given
|
||||
<filename class="extension">.po</filename> files</para>
|
||||
<indexterm zone="ch-system-gettext msgcat">
|
||||
<primary sortas="b-msgcat">msgcat</primary>
|
||||
</indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry id="msgcmp">
|
||||
<term><command>msgcmp</command></term>
|
||||
<listitem>
|
||||
<para>Compares two <filename class="extension">.po</filename>
|
||||
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>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry id="msgcmp">
|
||||
<term><command>msgcmp</command></term>
|
||||
<listitem>
|
||||
<para>Compares two <filename class="extension">.po</filename>
|
||||
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>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry id="msgcomm">
|
||||
<term><command>msgcomm</command></term>
|
||||
<listitem>
|
||||
<para>Finds the messages that are common to
|
||||
to the given <filename class="extension">.po</filename> files</para>
|
||||
<indexterm zone="ch-system-gettext msgcomm"><primary sortas="b-msgcomm">msgcomm</primary></indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry id="msgcomm">
|
||||
<term><command>msgcomm</command></term>
|
||||
<listitem>
|
||||
<para>Finds the messages that are common to to the given
|
||||
<filename class="extension">.po</filename> files</para>
|
||||
<indexterm zone="ch-system-gettext msgcomm">
|
||||
<primary sortas="b-msgcomm">msgcomm</primary>
|
||||
</indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry id="msgconv">
|
||||
<term><command>msgconv</command></term>
|
||||
<listitem>
|
||||
<para>Converts a translation catalog to a different character encoding</para>
|
||||
<indexterm zone="ch-system-gettext msgconv"><primary sortas="b-msgconv">msgconv</primary></indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry id="msgconv">
|
||||
<term><command>msgconv</command></term>
|
||||
<listitem>
|
||||
<para>Converts a translation catalog to a different character
|
||||
encoding</para>
|
||||
<indexterm zone="ch-system-gettext msgconv">
|
||||
<primary sortas="b-msgconv">msgconv</primary>
|
||||
</indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry id="msgen">
|
||||
<term><command>msgen</command></term>
|
||||
<listitem>
|
||||
<para>Creates an English translation catalog</para>
|
||||
<indexterm zone="ch-system-gettext msgen"><primary sortas="b-msgen">msgen</primary></indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry id="msgen">
|
||||
<term><command>msgen</command></term>
|
||||
<listitem>
|
||||
<para>Creates an English translation catalog</para>
|
||||
<indexterm zone="ch-system-gettext msgen">
|
||||
<primary sortas="b-msgen">msgen</primary>
|
||||
</indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry id="msgexec">
|
||||
<term><command>msgexec</command></term>
|
||||
<listitem>
|
||||
<para>Applies a command to all translations of a translation catalog</para>
|
||||
<indexterm zone="ch-system-gettext msgexec"><primary sortas="b-msgexec">msgexec</primary></indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry id="msgexec">
|
||||
<term><command>msgexec</command></term>
|
||||
<listitem>
|
||||
<para>Applies a command to all translations of a translation
|
||||
catalog</para>
|
||||
<indexterm zone="ch-system-gettext msgexec">
|
||||
<primary sortas="b-msgexec">msgexec</primary>
|
||||
</indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry id="msgfilter">
|
||||
<term><command>msgfilter</command></term>
|
||||
<listitem>
|
||||
<para>Applies a filter to all translations of a translation catalog</para>
|
||||
<indexterm zone="ch-system-gettext msgfilter"><primary sortas="b-msgfilter">msgfilter</primary></indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry id="msgfilter">
|
||||
<term><command>msgfilter</command></term>
|
||||
<listitem>
|
||||
<para>Applies a filter to all translations of a translation
|
||||
catalog</para>
|
||||
<indexterm zone="ch-system-gettext msgfilter">
|
||||
<primary sortas="b-msgfilter">msgfilter</primary>
|
||||
</indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry id="msgfmt">
|
||||
<term><command>msgfmt</command></term>
|
||||
<listitem>
|
||||
<para>Generates a binary message catalog from a translation catalog</para>
|
||||
<indexterm zone="ch-system-gettext msgfmt"><primary sortas="b-msgfmt">msgfmt</primary></indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry id="msgfmt">
|
||||
<term><command>msgfmt</command></term>
|
||||
<listitem>
|
||||
<para>Generates a binary message catalog from a translation
|
||||
catalog</para>
|
||||
<indexterm zone="ch-system-gettext msgfmt">
|
||||
<primary sortas="b-msgfmt">msgfmt</primary>
|
||||
</indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry id="msggrep">
|
||||
<term><command>msggrep</command></term>
|
||||
<listitem>
|
||||
<para>Extracts all messages of a translation catalog that match a
|
||||
given pattern or belong to some given source files</para>
|
||||
<indexterm zone="ch-system-gettext msggrep"><primary sortas="b-msggrep">msggrep</primary></indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry id="msggrep">
|
||||
<term><command>msggrep</command></term>
|
||||
<listitem>
|
||||
<para>Extracts all messages of a translation catalog that match a
|
||||
given pattern or belong to some given source files</para>
|
||||
<indexterm zone="ch-system-gettext msggrep">
|
||||
<primary sortas="b-msggrep">msggrep</primary>
|
||||
</indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry id="msginit">
|
||||
<term><command>msginit</command></term>
|
||||
<listitem>
|
||||
<para>Creates a new <filename class="extension">.po</filename> file, initializing the meta
|
||||
information with values from the user's environment</para>
|
||||
<indexterm zone="ch-system-gettext msginit"><primary sortas="b-msginit">msginit</primary></indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry id="msginit">
|
||||
<term><command>msginit</command></term>
|
||||
<listitem>
|
||||
<para>Creates a new <filename class="extension">.po</filename> file,
|
||||
initializing the meta information with values from the user's
|
||||
environment</para>
|
||||
<indexterm zone="ch-system-gettext msginit">
|
||||
<primary sortas="b-msginit">msginit</primary>
|
||||
</indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry id="msgmerge">
|
||||
<term><command>msgmerge</command></term>
|
||||
<listitem>
|
||||
<para>Combines two raw translations into a single file</para>
|
||||
<indexterm zone="ch-system-gettext msgmerge"><primary sortas="b-msgmerge">msgmerge</primary></indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry id="msgmerge">
|
||||
<term><command>msgmerge</command></term>
|
||||
<listitem>
|
||||
<para>Combines two raw translations into a single file</para>
|
||||
<indexterm zone="ch-system-gettext msgmerge">
|
||||
<primary sortas="b-msgmerge">msgmerge</primary>
|
||||
</indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry id="msgunfmt">
|
||||
<term><command>msgunfmt</command></term>
|
||||
<listitem>
|
||||
<para>Decompiles a binary message catalog into raw translation text</para>
|
||||
<indexterm zone="ch-system-gettext msgunfmt"><primary sortas="b-msgunfmt">msgunfmt</primary></indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry id="msgunfmt">
|
||||
<term><command>msgunfmt</command></term>
|
||||
<listitem>
|
||||
<para>Decompiles a binary message catalog into raw translation
|
||||
text</para>
|
||||
<indexterm zone="ch-system-gettext msgunfmt">
|
||||
<primary sortas="b-msgunfmt">msgunfmt</primary>
|
||||
</indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry id="msguniq">
|
||||
<term><command>msguniq</command></term>
|
||||
<listitem>
|
||||
<para>Unifies duplicate translations in a translation catalog</para>
|
||||
<indexterm zone="ch-system-gettext msguniq"><primary sortas="b-msguniq">msguniq</primary></indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry id="msguniq">
|
||||
<term><command>msguniq</command></term>
|
||||
<listitem>
|
||||
<para>Unifies duplicate translations in a translation catalog</para>
|
||||
<indexterm zone="ch-system-gettext msguniq">
|
||||
<primary sortas="b-msguniq">msguniq</primary>
|
||||
</indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry id="ngettext">
|
||||
<term><command>ngettext</command></term>
|
||||
<listitem>
|
||||
<para>Displays native language translations of a textual message whose
|
||||
grammatical form depends on a number</para>
|
||||
<indexterm zone="ch-system-gettext ngettext"><primary sortas="b-ngettext">ngettext</primary></indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry id="ngettext">
|
||||
<term><command>ngettext</command></term>
|
||||
<listitem>
|
||||
<para>Displays native language translations of a textual message whose
|
||||
grammatical form depends on a number</para>
|
||||
<indexterm zone="ch-system-gettext ngettext">
|
||||
<primary sortas="b-ngettext">ngettext</primary>
|
||||
</indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry id="xgettext">
|
||||
<term><command>xgettext</command></term>
|
||||
<listitem>
|
||||
<para>Extracts the translatable message lines from the given source
|
||||
files to make the first translation template</para>
|
||||
<indexterm zone="ch-system-gettext xgettext"><primary sortas="b-xgettext">xgettext</primary></indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry id="xgettext">
|
||||
<term><command>xgettext</command></term>
|
||||
<listitem>
|
||||
<para>Extracts the translatable message lines from the given source
|
||||
files to make the first translation template</para>
|
||||
<indexterm zone="ch-system-gettext xgettext">
|
||||
<primary sortas="b-xgettext">xgettext</primary>
|
||||
</indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry id="libasprintf">
|
||||
<term><filename class="libraryfile">libasprintf</filename></term>
|
||||
<listitem>
|
||||
<para>defines the <emphasis>autosprintf</emphasis> class, which makes
|
||||
C formatted output routines usable in C++ programs, for use with the
|
||||
<emphasis><string></emphasis> strings and the
|
||||
<emphasis><iostream></emphasis> streams</para>
|
||||
<indexterm zone="ch-system-gettext libasprintf"><primary sortas="c-libasprintf">libasprintf</primary></indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry id="libasprintf">
|
||||
<term><filename class="libraryfile">libasprintf</filename></term>
|
||||
<listitem>
|
||||
<para>defines the <emphasis>autosprintf</emphasis> class, which makes
|
||||
C formatted output routines usable in C++ programs, for use with the
|
||||
<emphasis><string></emphasis> strings and the
|
||||
<emphasis><iostream></emphasis> streams</para>
|
||||
<indexterm zone="ch-system-gettext libasprintf">
|
||||
<primary sortas="c-libasprintf">libasprintf</primary>
|
||||
</indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry id="libgettextlib">
|
||||
<term><filename class="libraryfile">libgettextlib</filename></term>
|
||||
<listitem>
|
||||
<para>a private library containing common routines used by the various Gettext
|
||||
programs; these are not intended for general use</para>
|
||||
<indexterm zone="ch-system-gettext libgettextlib"><primary sortas="c-libgettextlib">libgettextlib</primary></indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry id="libgettextlib">
|
||||
<term><filename class="libraryfile">libgettextlib</filename></term>
|
||||
<listitem>
|
||||
<para>a private library containing common routines used by the
|
||||
various Gettext programs; these are not intended for general use</para>
|
||||
<indexterm zone="ch-system-gettext libgettextlib">
|
||||
<primary sortas="c-libgettextlib">libgettextlib</primary>
|
||||
</indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry id="libgettextpo">
|
||||
<term><filename class="libraryfile">libgettextpo</filename></term>
|
||||
<listitem>
|
||||
<para>Used to write specialized programs that process <filename
|
||||
class="extension">.po</filename> files; this library is used when the
|
||||
standard applications shipped with Gettext (such as
|
||||
<command>msgcomm</command>, <command>msgcmp</command>,
|
||||
<command>msgattrib</command>, and <command>msgen</command>) will not
|
||||
suffice</para>
|
||||
<indexterm zone="ch-system-gettext libgettextpo"><primary sortas="c-libgettextpo">libgettextpo</primary></indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry id="libgettextpo">
|
||||
<term><filename class="libraryfile">libgettextpo</filename></term>
|
||||
<listitem>
|
||||
<para>Used to write specialized programs that process
|
||||
<filename class="extension">.po</filename> files; this library is
|
||||
used when the standard applications shipped with Gettext (such as
|
||||
<command>msgcomm</command>, <command>msgcmp</command>,
|
||||
<command>msgattrib</command>, and <command>msgen</command>) will
|
||||
not suffice</para>
|
||||
<indexterm zone="ch-system-gettext libgettextpo">
|
||||
<primary sortas="c-libgettextpo">libgettextpo</primary>
|
||||
</indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry id="libgettextsrc">
|
||||
<term><filename class="libraryfile">libgettextsrc</filename></term>
|
||||
<listitem>
|
||||
<para>A private library containing common routines used by the various Gettext
|
||||
programs; these are not intended for general use</para>
|
||||
<indexterm zone="ch-system-gettext libgettextsrc"><primary sortas="c-libgettextsrc">libgettextsrc</primary></indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
<varlistentry id="libgettextsrc">
|
||||
<term><filename class="libraryfile">libgettextsrc</filename></term>
|
||||
<listitem>
|
||||
<para>A private library containing common routines used by the
|
||||
various Gettext programs; these are not intended for general use</para>
|
||||
<indexterm zone="ch-system-gettext libgettextsrc">
|
||||
<primary sortas="c-libgettextsrc">libgettextsrc</primary>
|
||||
</indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
</sect2>
|
||||
</variablelist>
|
||||
|
||||
</sect2>
|
||||
|
||||
</sect1>
|
||||
|
||||
|
||||
1238
chapter06/glibc.xml
1238
chapter06/glibc.xml
File diff suppressed because it is too large
Load Diff
@ -1,98 +1,123 @@
|
||||
<?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-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/>
|
||||
<para>The Grep package contains programs for searching through files.</para>
|
||||
<indexterm zone="ch-system-grep">
|
||||
<primary sortas="a-Grep">Grep</primary>
|
||||
</indexterm>
|
||||
|
||||
<segmentedlist>
|
||||
<segtitle>&buildtime;</segtitle>
|
||||
<segtitle>&diskspace;</segtitle>
|
||||
<seglistitem><seg>0.1 SBU</seg><seg>4.5 MB</seg></seglistitem>
|
||||
</segmentedlist>
|
||||
<sect2 role="package">
|
||||
<title/>
|
||||
|
||||
<segmentedlist>
|
||||
<segtitle>&dependencies;</segtitle>
|
||||
<seglistitem><seg>Bash, Binutils, Coreutils,
|
||||
Diffutils, GCC, Gettext, Glibc, Make, Sed, and Texinfo</seg></seglistitem>
|
||||
</segmentedlist>
|
||||
</sect2>
|
||||
<para>The Grep package contains programs for searching through files.</para>
|
||||
|
||||
<sect2 role="installation">
|
||||
<title>Installation of Grep</title>
|
||||
<segmentedlist>
|
||||
<segtitle>&buildtime;</segtitle>
|
||||
<segtitle>&diskspace;</segtitle>
|
||||
|
||||
<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>
|
||||
<seglistitem>
|
||||
<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>
|
||||
|
||||
<para>In order for the tests added by this patch to pass, the permissions for
|
||||
the test file have to be changed:</para>
|
||||
<para>In order for the tests added by this patch to pass, the permissions for
|
||||
the test file have to be changed:</para>
|
||||
|
||||
<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>
|
||||
|
||||
<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>
|
||||
|
||||
<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>
|
||||
<segtitle>Installed programs</segtitle>
|
||||
<seglistitem><seg>egrep (link to grep), fgrep (link to grep), and grep</seg></seglistitem>
|
||||
</segmentedlist>
|
||||
<seglistitem>
|
||||
<seg>egrep (link to grep), fgrep (link to grep), and grep</seg>
|
||||
</seglistitem>
|
||||
</segmentedlist>
|
||||
|
||||
<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead>
|
||||
<?dbfo list-presentation="list"?>
|
||||
<?dbhtml list-presentation="table"?>
|
||||
<variablelist>
|
||||
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
|
||||
<?dbfo list-presentation="list"?>
|
||||
<?dbhtml list-presentation="table"?>
|
||||
|
||||
<varlistentry id="egrep">
|
||||
<term><command>egrep</command></term>
|
||||
<listitem>
|
||||
<para>Prints lines matching an extended regular expression</para>
|
||||
<indexterm zone="ch-system-grep egrep"><primary sortas="b-egrep">egrep</primary></indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry id="egrep">
|
||||
<term><command>egrep</command></term>
|
||||
<listitem>
|
||||
<para>Prints lines matching an extended regular expression</para>
|
||||
<indexterm zone="ch-system-grep egrep">
|
||||
<primary sortas="b-egrep">egrep</primary>
|
||||
</indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry id="fgrep">
|
||||
<term><command>fgrep</command></term>
|
||||
<listitem>
|
||||
<para>Prints lines matching a list of fixed strings</para>
|
||||
<indexterm zone="ch-system-grep fgrep"><primary sortas="b-fgrep">fgrep</primary></indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry id="fgrep">
|
||||
<term><command>fgrep</command></term>
|
||||
<listitem>
|
||||
<para>Prints lines matching a list of fixed strings</para>
|
||||
<indexterm zone="ch-system-grep fgrep">
|
||||
<primary sortas="b-fgrep">fgrep</primary>
|
||||
</indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry id="grep">
|
||||
<term><command>grep</command></term>
|
||||
<listitem>
|
||||
<para>Prints lines matching a basic regular expression</para>
|
||||
<indexterm zone="ch-system-grep grep"><primary sortas="b-grep">grep</primary></indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
<varlistentry id="grep">
|
||||
<term><command>grep</command></term>
|
||||
<listitem>
|
||||
<para>Prints lines matching a basic regular expression</para>
|
||||
<indexterm zone="ch-system-grep grep">
|
||||
<primary sortas="b-grep">grep</primary>
|
||||
</indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
</sect2>
|
||||
</variablelist>
|
||||
|
||||
</sect2>
|
||||
|
||||
</sect1>
|
||||
|
||||
|
||||
Loading…
Reference in New Issue
Block a user