r195 - in trunk/BOOK: chapter05 chapter06

manuel at linuxfromscratch.org manuel at linuxfromscratch.org
Mon Feb 14 12:59:46 PST 2005


Author: manuel
Date: 2005-02-14 13:59:45 -0700 (Mon, 14 Feb 2005)
New Revision: 195

Added:
   trunk/BOOK/chapter05/bzip2.xml
   trunk/BOOK/chapter05/ncurses.xml
   trunk/BOOK/chapter05/patch.xml
   trunk/BOOK/chapter05/tar.xml
   trunk/BOOK/chapter06/bzip2.xml
   trunk/BOOK/chapter06/ncurses.xml
   trunk/BOOK/chapter06/patch.xml
   trunk/BOOK/chapter06/tar.xml
Modified:
   trunk/BOOK/chapter05/chapter05.xml
   trunk/BOOK/chapter06/chapter06.xml
Log:
Added package files up to Gzip2.

Added: trunk/BOOK/chapter05/bzip2.xml
===================================================================
--- trunk/BOOK/chapter05/bzip2.xml	2005-02-14 20:20:32 UTC (rev 194)
+++ trunk/BOOK/chapter05/bzip2.xml	2005-02-14 20:59:45 UTC (rev 195)
@@ -0,0 +1,54 @@
+<?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" [
+  <!ENTITY % general-entities SYSTEM "../general.ent">
+  %general-entities;
+]>
+<sect1 id="ch-tools-bzip2" role="wrap">
+<title>Bzip2-&bzip2-version;</title>
+<?dbhtml filename="bzip2.html"?>
+
+<indexterm zone="ch-tools-bzip2">
+<primary sortas="a-Bzip2">Bzip2</primary>
+<secondary>tools</secondary></indexterm>
+
+<sect2 role="package"><title/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/bzip2.xml" xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
+
+<segmentedlist>
+<segtitle>&buildtime;</segtitle>
+<segtitle>&diskspace;</segtitle>
+<seglistitem><seg>0.1 SBU</seg><seg>2.5 MB</seg></seglistitem>
+</segmentedlist>
+
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/bzip2.xml" xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
+
+</sect2>
+
+<sect2 role="installation">
+<title>Installation of Bzip2</title>
+
+<para>This is installed late to work around the uClibc bug in Tar-1.14* which may
+exist on the host system.</para>
+
+<para>Apply a patch to ... EDIT ME</para>
+
+<screen><userinput>patch -Np1 -i ../bzip2-&bzip2-version;-hardened_cflags-1.patch</userinput></screen>
+
+<para>The Bzip2 package does not contain a <command>configure</command>
+script. Compile it with:</para>
+
+<screen><userinput>make</userinput></screen>
+
+<para>Install the package:</para>
+
+<screen><userinput>make PREFIX=/tools install</userinput></screen>
+
+</sect2>
+
+<sect2 role="content"><title/>
+<para>Details on this package are located in <xref
+linkend="contents-bzip2" role="."/></para>
+</sect2>
+
+</sect1>
+


Property changes on: trunk/BOOK/chapter05/bzip2.xml
___________________________________________________________________
Name: svn:keywords
   + "Author Date Revision Id"

Modified: trunk/BOOK/chapter05/chapter05.xml
===================================================================
--- trunk/BOOK/chapter05/chapter05.xml	2005-02-14 20:20:32 UTC (rev 194)
+++ trunk/BOOK/chapter05/chapter05.xml	2005-02-14 20:59:45 UTC (rev 195)
@@ -29,11 +29,11 @@
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="make.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="grep.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="sed.xml"/>
-<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="gettext.xml"/><!--
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="gettext.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="ncurses.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="patch.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="tar.xml"/>
-<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="bzip2.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="bzip2.xml"/><!--
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="gzip.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="texinfo.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="bash.xml"/>

Added: trunk/BOOK/chapter05/ncurses.xml
===================================================================
--- trunk/BOOK/chapter05/ncurses.xml	2005-02-14 20:20:32 UTC (rev 194)
+++ trunk/BOOK/chapter05/ncurses.xml	2005-02-14 20:59:45 UTC (rev 195)
@@ -0,0 +1,78 @@
+<?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" [
+  <!ENTITY % general-entities SYSTEM "../general.ent">
+  %general-entities;
+]>
+<sect1 id="ch-tools-ncurses" role="wrap">
+<title>Ncurses-&ncurses-version;</title>
+<?dbhtml filename="ncurses.html"?>
+
+<indexterm zone="ch-tools-ncurses">
+<primary sortas="a-Ncurses">Ncurses</primary>
+<secondary>tools</secondary></indexterm>
+
+<sect2 role="package"><title/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/ncurses.xml" xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
+
+<segmentedlist>
+<segtitle>&buildtime;</segtitle>
+<segtitle>&diskspace;</segtitle>
+<seglistitem><seg>?? SBU</seg><seg>?? MB</seg></seglistitem>
+</segmentedlist>
+
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/ncurses.xml" xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
+
+</sect2>
+
+<sect2 role="installation">
+<title>Installation of Ncurses</title>
+
+<para>Amend <filename>Makefile.in</filename>:</para>
+
+<screen><userinput>sed -e 's/^CFLAGS .*$/& -pie -fpie/' -i {progs,tack}/Makefile.in</userinput></screen>
+
+<para>Prepare Ncurses for compilation:</para>
+
+<screen><userinput>./configure --prefix=/tools ${disable_nls} --with-shared \
+    --without-debug --without-ada --enable-overwrite</userinput></screen>
+
+<para>The meaning of the configure options:</para>
+
+<variablelist>
+<varlistentry>
+<term><parameter>--without-ada</parameter></term>
+<listitem><para>This tells Ncurses not to build its Ada bindings, even
+if an Ada compiler is installed on the host. This needs to be done
+because once we enter the chroot environment, Ada will no longer be
+available.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><parameter>--enable-overwrite</parameter></term>
+<listitem><para>This tells Ncurses to install its header files into
+<filename class="directory">/tools/include</filename>, instead of
+<filename class="directory">/tools/include/ncurses</filename>, to
+ensure that other packages can find the Ncurses headers
+successfully.</para></listitem>
+</varlistentry>
+</variablelist>
+
+<para>Compile the package:</para>
+
+<screen><userinput>make</userinput></screen>
+
+<para>This package does not come with a test suite.</para>
+
+<para>Install the package:</para>
+
+<screen><userinput>make install</userinput></screen>
+
+</sect2>
+
+<sect2 role="content"><title/>
+<para>Details on this package are located in <xref
+linkend="contents-ncurses" role="."/></para>
+</sect2>
+
+</sect1>
+


Property changes on: trunk/BOOK/chapter05/ncurses.xml
___________________________________________________________________
Name: svn:keywords
   + "Author Date Revision Id"

Added: trunk/BOOK/chapter05/patch.xml
===================================================================
--- trunk/BOOK/chapter05/patch.xml	2005-02-14 20:20:32 UTC (rev 194)
+++ trunk/BOOK/chapter05/patch.xml	2005-02-14 20:59:45 UTC (rev 195)
@@ -0,0 +1,56 @@
+<?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" [
+  <!ENTITY % general-entities SYSTEM "../general.ent">
+  %general-entities;
+]>
+<sect1 id="ch-tools-patch" role="wrap">
+<title>Patch-&patch-version;</title>
+<?dbhtml filename="patch.html"?>
+
+<indexterm zone="ch-tools-patch">
+<primary sortas="a-Patch">Patch</primary>
+<secondary>tools</secondary></indexterm>
+
+<sect2 role="package"><title/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/patch.xml" xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
+
+<segmentedlist>
+<segtitle>&buildtime;</segtitle>
+<segtitle>&diskspace;</segtitle>
+<seglistitem><seg>?? SBU</seg><seg>?? MB</seg></seglistitem>
+</segmentedlist>
+
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/patch.xml" xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
+
+</sect2>
+
+<sect2 role="installation">
+<title>Installation of Patch</title>
+
+<para>Amend <filename>Makefile.in</filename>:</para>
+
+<screen><userinput>sed -e 's/^CFLAGS .*$/& -pie -fpie/' -i Makefile.in</userinput></screen>
+
+<para>Prepare Patch for compilation:</para>
+
+<screen><userinput>./configure --prefix=/tools ${disable_nls}</userinput></screen>
+
+<para>Compile the package:</para>
+
+<screen><userinput>make</userinput></screen>
+
+<para>This package does not come with a test suite.</para>
+
+<para>Install the package:</para>
+
+<screen><userinput>make install</userinput></screen>
+
+</sect2>
+
+<sect2 role="content"><title/>
+<para>Details on this package are located in <xref
+linkend="contents-patch" role="."/></para>
+</sect2>
+
+</sect1>
+


Property changes on: trunk/BOOK/chapter05/patch.xml
___________________________________________________________________
Name: svn:keywords
   + "Author Date Revision Id"

Added: trunk/BOOK/chapter05/tar.xml
===================================================================
--- trunk/BOOK/chapter05/tar.xml	2005-02-14 20:20:32 UTC (rev 194)
+++ trunk/BOOK/chapter05/tar.xml	2005-02-14 20:59:45 UTC (rev 195)
@@ -0,0 +1,57 @@
+<?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" [
+  <!ENTITY % general-entities SYSTEM "../general.ent">
+  %general-entities;
+]>
+<sect1 id="ch-tools-tar" role="wrap">
+<title>Tar-&tar-version;</title>
+<?dbhtml filename="tar.html"?>
+
+<indexterm zone="ch-tools-tar">
+<primary sortas="a-Tar">Tar</primary>
+<secondary>tools</secondary></indexterm>
+
+<sect2 role="package"><title/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/tar.xml" xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
+
+<segmentedlist>
+<segtitle>&buildtime;</segtitle>
+<segtitle>&diskspace;</segtitle>
+<seglistitem><seg>?? SBU</seg><seg>?? MB</seg></seglistitem>
+</segmentedlist>
+
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/tar.xml" xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
+
+</sect2>
+
+<sect2 role="installation">
+<title>Installation of Tar</title>
+
+<para>Amend <filename>Makefile.in</filename>:</para>
+
+<screen><userinput>sed -e 's/^CFLAGS .*$/& -pie -fpie/' -i {rmt,src}/Makefile.in</userinput></screen>
+
+<para>Prepare Tar for compilation:</para>
+
+<screen><userinput>./configure --prefix=/tools ${disable_nls}</userinput></screen>
+
+<para>Compile the package:</para>
+
+<screen><userinput>make</userinput></screen>
+
+<para>To test the results, issue: <userinput>make
+check</userinput>.</para>
+
+<para>Install the package:</para>
+
+<screen><userinput>make install</userinput></screen>
+
+</sect2>
+
+<sect2 role="content"><title/>
+<para>Details on this package are located in <xref
+linkend="contents-tar" role="."/></para>
+</sect2>
+
+</sect1>
+


Property changes on: trunk/BOOK/chapter05/tar.xml
___________________________________________________________________
Name: svn:keywords
   + "Author Date Revision Id"

Added: trunk/BOOK/chapter06/bzip2.xml
===================================================================
--- trunk/BOOK/chapter06/bzip2.xml	2005-02-14 20:20:32 UTC (rev 194)
+++ trunk/BOOK/chapter06/bzip2.xml	2005-02-14 20:59:45 UTC (rev 195)
@@ -0,0 +1,196 @@
+<?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" [
+  <!ENTITY % general-entities SYSTEM "../general.ent">
+  %general-entities;
+]>
+<sect1 id="ch-system-bzip2" role="wrap">
+<title>Bzip2-&bzip2-version;</title>
+<?dbhtml filename="bzip2.html"?>
+
+<indexterm zone="ch-system-bzip2"><primary sortas="a-Bzip2">Bzip2</primary></indexterm>
+
+<sect2 role="package"><title/>
+<para>The Bzip2 package contains programs for compressing and decompressing
+files. Text files yield a much better compression than with the
+traditional <command>gzip</command>.</para>
+
+<segmentedlist>
+<segtitle>&buildtime;</segtitle>
+<segtitle>&diskspace;</segtitle>
+<seglistitem><seg>0.1 SBU</seg><seg>3.0 MB</seg></seglistitem>
+</segmentedlist>
+
+<segmentedlist>
+<segtitle>Bzip2 installation depends on</segtitle>
+<seglistitem><seg>Bash, Binutils, Coreutils, Diffutils,
+GCC, Glibc, and Make</seg></seglistitem>
+</segmentedlist>
+</sect2>
+
+<sect2 role="installation">
+<title>Installation of Bzip2</title>
+
+<para>Apply a patch to ... EDIT ME</para>
+
+<screen><userinput>patch -Np1 -i ../bzip2-&bzip2-version;-hardened_cflags-1.patch</userinput></screen>
+
+<para>Prepare Bzip2 for compilation with:</para>
+
+<screen><userinput>make -f Makefile-libbz2_so
+make clean</userinput></screen>
+
+<para>The <parameter>-f</parameter> flag will cause Bzip2 to be built
+using a different <filename>Makefile</filename> file, in this case the
+<filename>Makefile-libbz2_so</filename> file, which creates a dynamic
+<filename class="libraryfile">libbz2.so</filename> library and links the Bzip2
+utilities against it.</para>
+
+<para>Compile the package:</para>
+
+<screen><userinput>make</userinput></screen>
+
+<para>If reinstalling Bzip2, perform
+<userinput>rm -f /usr/bin/bz*</userinput> first, otherwise the following
+<command>make install</command> will fail.</para>
+
+<para>Install the programs:</para>
+
+<screen><userinput>make install</userinput></screen>
+
+<para>Install the shared <command>bzip2</command> binary into the
+<filename class="directory">/bin</filename> directory, make
+some necessary symbolic links, and clean up:</para>
+
+<screen><userinput>install bzip2-shared /bin/bzip2
+cp -a libbz2.so* /lib
+ln -s ../../lib/libbz2.so.1.0 /usr/lib/libbz2.so
+rm /usr/bin/{bunzip2,bzcat,bzip2}
+ln -s bzip2 /bin/bunzip2
+ln -s bzip2 /bin/bzcat</userinput></screen>
+
+<para>Remove the static lib:</para>
+
+<screen><userinput>rm /usr/lib/libbz2.a</userinput></screen>
+
+</sect2>
+
+
+<sect2 id="contents-bzip2" role="content"><title>Contents of Bzip2</title>
+
+<segmentedlist>
+<segtitle>Installed programs</segtitle>
+<segtitle>Installed libraries</segtitle>
+<seglistitem><seg>bunzip2 (link to bzip2), bzcat (link to bzip2), bzcmp, bzdiff,
+bzegrep, bzfgrep, bzgrep, bzip2, bzip2recover, bzless, and bzmore</seg>
+<seg>libbz2.a, libbz2.so (link to libbz2.so.1.0), libbz2.so.1.0 (link to 
+libbz2.so.&bzip2-version;), and libbz2.so.&bzip2-version;</seg></seglistitem>
+</segmentedlist>
+
+<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead>
+<?dbfo list-presentation="list"?>
+
+<varlistentry id="bunzip2">
+<term><command>bunzip2</command></term>
+<listitem>
+<para>Decompresses bzipped files</para>
+<indexterm zone="ch-system-bzip2 bunzip2"><primary sortas="b-bunzip2">bunzip2</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="bzcat">
+<term><command>bzcat</command></term>
+<listitem>
+<para>Decompresses to standard output</para>
+<indexterm zone="ch-system-bzip2 bzcat"><primary sortas="b-bzcat">bzcat</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="bzcmp">
+<term><command>bzcmp</command></term>
+<listitem>
+<para>Runs <command>cmp</command> on bzipped files</para>
+<indexterm zone="ch-system-bzip2 bzcmp"><primary sortas="b-bzcmp">bzcmp</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="bzdiff">
+<term><command>bzdiff</command></term>
+<listitem>
+<para>Runs <command>diff</command> on bzipped files</para>
+<indexterm zone="ch-system-bzip2 bzdiff"><primary sortas="b-bzdiff">bzdiff</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="bzgrep">
+<term><command>bzgrep</command></term>
+<listitem>
+<para>Runs <command>grep</command> on bzipped files</para>
+<indexterm zone="ch-system-bzip2 bzgrep"><primary sortas="b-bzgrep">bzgrep</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="bzegrep">
+<term><command>bzegrep</command></term>
+<listitem>
+<para>Runs <command>egrep</command> on bzipped files</para>
+<indexterm zone="ch-system-bzip2 bzegrep"><primary sortas="b-bzegrep">bzegrep</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="bzfgrep">
+<term><command>bzfgrep</command></term>
+<listitem>
+<para>Runs <command>fgrep</command> on bzipped files</para>
+<indexterm zone="ch-system-bzip2 bzfgrep"><primary sortas="b-bzfgrep">bzfgrep</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="bzip2">
+<term><command>bzip2</command></term>
+<listitem>
+<para>Compresses files using the Burrows-Wheeler block sorting text
+compression algorithm with Huffman coding; the compression rate is
+better than that achieved by more conventional compressors using
+<quote>Lempel-Ziv</quote> algorithms, like <command>gzip</command></para>
+<indexterm zone="ch-system-bzip2 bzip2"><primary sortas="b-bzip2">bzip2</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="bzip2recover">
+<term><command>bzip2recover</command></term>
+<listitem>
+<para>Tries to recover data from damaged bzipped files</para>
+<indexterm zone="ch-system-bzip2 bzip2recover"><primary sortas="b-bzip2recover">bzip2recover</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="bzless">
+<term><command>bzless</command></term>
+<listitem>
+<para>Runs <command>less</command> on bzipped files</para>
+<indexterm zone="ch-system-bzip2 bzless"><primary sortas="b-bzless">bzless</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="bzmore">
+<term><command>bzmore</command></term>
+<listitem>
+<para>Runs <command>more</command> on bzipped files</para>
+<indexterm zone="ch-system-bzip2 bzmore"><primary sortas="b-bzmore">bzmore</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="libbz2">
+<term><filename class="libraryfile">libbz2*</filename></term>
+<listitem>
+<para>The library implementing lossless, block-sorting data
+compression, using the Burrows-Wheeler algorithm</para>
+<indexterm zone="ch-system-bzip2 libbz2"><primary sortas="c-libbz2*">libbz2*</primary></indexterm>
+</listitem>
+</varlistentry>
+</variablelist>
+
+</sect2>
+
+</sect1>
+


Property changes on: trunk/BOOK/chapter06/bzip2.xml
___________________________________________________________________
Name: svn:keywords
   + "Author Date Revision Id"

Modified: trunk/BOOK/chapter06/chapter06.xml
===================================================================
--- trunk/BOOK/chapter06/chapter06.xml	2005-02-14 20:20:32 UTC (rev 194)
+++ trunk/BOOK/chapter06/chapter06.xml	2005-02-14 20:59:45 UTC (rev 195)
@@ -29,8 +29,8 @@
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="mktemp.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="iana-etc.xml"/>-->
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="findutils.xml"/>
-<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="gawk.xml"/><!--
-<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="ncurses.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="gawk.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="ncurses.xml"/><!--
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="readline.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="vim.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="m4.xml"/>
@@ -48,8 +48,8 @@
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="automake.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="bash.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="file.xml"/>
-<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="libtool.xml"/>
-<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="bzip2.xml"/>-->
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="libtool.xml"/>-->
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="bzip2.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="diffutils.xml"/><!--
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="kbd.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="e2fsprogs.xml"/>-->
@@ -59,16 +59,16 @@
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="hotplug.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="man.xml"/>-->
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="make.xml"/><!--
-<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="module-init-tools.xml"/>
-<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="patch.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="module-init-tools.xml"/>-->
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="patch.xml"/><!--
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="procps.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="psmisc.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="shadow.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="util-linux.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="libol.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="syslogng.xml"/>
-<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="sysvinit.xml"/>
-<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="tar.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="sysvinit.xml"/>-->
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="tar.xml"/><!--
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="udev.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="paxctl.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="aboutdebug.xml"/>

Added: trunk/BOOK/chapter06/ncurses.xml
===================================================================
--- trunk/BOOK/chapter06/ncurses.xml	2005-02-14 20:20:32 UTC (rev 194)
+++ trunk/BOOK/chapter06/ncurses.xml	2005-02-14 20:59:45 UTC (rev 195)
@@ -0,0 +1,222 @@
+<?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" [
+  <!ENTITY % general-entities SYSTEM "../general.ent">
+  %general-entities;
+]>
+<sect1 id="ch-system-ncurses" role="wrap">
+<title>Ncurses-&ncurses-version;</title>
+<?dbhtml filename="ncurses.html"?>
+
+<indexterm zone="ch-system-ncurses"><primary sortas="a-Ncurses">Ncurses</primary></indexterm>
+
+<sect2 role="package"><title/>
+<para>The Ncurses package contains libraries for terminal-independent
+handling of character screens.</para>
+
+<segmentedlist>
+<segtitle>&buildtime;</segtitle>
+<segtitle>&diskspace;</segtitle>
+<seglistitem><seg>?? SBU</seg><seg>?? MB</seg></seglistitem>
+</segmentedlist>
+
+<segmentedlist>
+<segtitle>Ncurses installation depends on</segtitle>
+<seglistitem><seg>Bash, Binutils, Coreutils, Diffutils,
+Gawk, GCC, Glibc, Grep, Make, and Sed</seg></seglistitem>
+</segmentedlist>
+</sect2>
+
+<sect2 role="installation">
+<title>Installation of Ncurses</title>
+
+<para>Amend <filename>Makefile.in</filename>:</para>
+
+<screen><userinput>sed -e 's/^CFLAGS .*$/& -pie -fpie/' -i {progs,tack}/Makefile.in</userinput></screen>
+
+<para>Prepare Ncurses for compilation:</para>
+
+<screen><userinput>./configure --prefix=/usr --with-shared --without-debug \
+    --without-normal ${disable_nls}</userinput></screen>
+
+<para>Compile the package:</para>
+
+<screen><userinput>make</userinput></screen>
+
+<para>This package does not come with a test suite.</para>
+
+<para>Install the package:</para>
+
+<screen><userinput>make install</userinput></screen>
+
+<para>Give the Ncurses libraries execute permissions:</para>
+
+<screen><userinput>chmod 755 /usr/lib/*.&ncurses-version;</userinput></screen>
+
+<para>Fix a library that should not be executable:</para>
+
+<para>Move the libraries to the <filename class="directory">/lib</filename> directory,
+where they are expected to reside:</para>
+
+<screen><userinput>mv /usr/lib/libncurses.so.5* /lib</userinput></screen>
+
+<para>Because the libraries have been moved, a few symlinks are pointing to
+non-existent files. Recreate those symlinks:</para>
+
+<screen><userinput>ln -sf ../../lib/libncurses.so.5 /usr/lib/libncurses.so
+ln -sf libncurses.so /usr/lib/libcurses.so</userinput></screen>
+
+<para>Then remove the static libs:</para>
+
+<screen><userinput>rm /usr/lib/libncurses++.a</userinput></screen>
+
+</sect2>
+
+
+<sect2 id="contents-ncurses" role="content"><title>Contents of Ncurses</title>
+
+<segmentedlist>
+<segtitle>Installed programs</segtitle>
+<segtitle>Installed libraries</segtitle>
+<seglistitem><seg>captoinfo (link to tic), clear, infocmp, infotocap (link to tic), 
+reset (link to tset), tack, tic, toe, tput, and tset</seg>
+<seg>libcurses.[a,so] (link to libncurses.[a,so]), libform.[a,so], libmenu.[a,so], 
+libncurses++.a, libncurses.[a,so], and libpanel.[a,so]</seg></seglistitem>
+</segmentedlist>
+
+<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead>
+<?dbfo list-presentation="list"?>
+
+<varlistentry id="captoinfo">
+<term><command>captoinfo</command></term>
+<listitem>
+<para>Converts a termcap description into a terminfo description</para>
+<indexterm zone="ch-system-ncurses captoinfo"><primary sortas="b-captoinfo">captoinfo</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="clear">
+<term><command>clear</command></term>
+<listitem>
+<para>Clears the screen, if possible</para>
+<indexterm zone="ch-system-ncurses clear"><primary sortas="b-clear">clear</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="infocmp">
+<term><command>infocmp</command></term>
+<listitem>
+<para>Compares or prints out terminfo descriptions</para>
+<indexterm zone="ch-system-ncurses infocmp"><primary sortas="b-infocmp">infocmp</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="infotocap">
+<term><command>infotocap</command></term>
+<listitem>
+<para>Converts a terminfo description into a termcap description</para>
+<indexterm zone="ch-system-ncurses infotocap"><primary sortas="b-infotocap">infotocap</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="reset">
+<term><command>reset</command></term>
+<listitem>
+<para>Reinitializes a terminal to its default values</para>
+<indexterm zone="ch-system-ncurses reset"><primary sortas="b-reset">reset</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="tack">
+<term><command>tack</command></term>
+<listitem>
+<para>The terminfo action checker; it is mainly used to test the
+accuracy of an entry in the terminfo database</para>
+<indexterm zone="ch-system-ncurses tack"><primary sortas="b-tack">tack</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="tic">
+<term><command>tic</command></term>
+<listitem>
+<para>The terminfo entry-description compiler that translates a
+terminfo file from source format into the binary format needed for the
+ncurses library routines. A terminfo file contains information on the
+capabilities of a certain terminal</para>
+<indexterm zone="ch-system-ncurses tic"><primary sortas="b-tic">tic</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="toe">
+<term><command>toe</command></term>
+<listitem>
+<para>Lists all available terminal types, giving the primary name and
+description for each</para>
+<indexterm zone="ch-system-ncurses toe"><primary sortas="b-toe">toe</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="tput">
+<term><command>tput</command></term>
+<listitem>
+<para>Makes the values of terminal-dependent capabilities available to
+the shell; it can also be used to reset or initialize a terminal or
+report its long name</para>
+<indexterm zone="ch-system-ncurses tput"><primary sortas="b-tput">tput</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="tset">
+<term><command>tset</command></term>
+<listitem>
+<para>Can be used to initialize terminals</para>
+<indexterm zone="ch-system-ncurses tset"><primary sortas="b-tset">tset</primary></indexterm>
+<beginpage/></listitem>
+</varlistentry>
+
+<varlistentry id="libcurses">
+<term><filename class="libraryfile">libcurses</filename></term>
+<listitem>
+<para>A link to <filename>libncurses</filename></para>
+<indexterm zone="ch-system-ncurses libcurses"><primary sortas="c-libcurses">libcurses</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="libncurses">
+<term><filename class="libraryfile">libncurses</filename></term>
+<listitem>
+<para>Contains functions to display text in many complex ways on a
+terminal screen; a good example of the use of these functions is the
+menu displayed during the kernel's <command>make menuconfig</command></para>
+<indexterm zone="ch-system-ncurses libncurses"><primary sortas="c-libncurses">libncurses</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="libform">
+<term><filename class="libraryfile">libform</filename></term>
+<listitem>
+<para>Contains functions to implement forms</para>
+<indexterm zone="ch-system-ncurses libform"><primary sortas="c-libform">libform</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="libmenu">
+<term><filename class="libraryfile">libmenu</filename></term>
+<listitem>
+<para>Contains functions to implement menus</para>
+<indexterm zone="ch-system-ncurses libmenu"><primary sortas="c-libmenu">libmenu</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="libpanel">
+<term><filename class="libraryfile">libpanel</filename></term>
+<listitem>
+<para>Contains functions to implement panels</para>
+<indexterm zone="ch-system-ncurses libpanel"><primary sortas="c-libpanel">libpanel</primary></indexterm>
+</listitem>
+</varlistentry>
+</variablelist>
+
+</sect2>
+
+</sect1>
+


Property changes on: trunk/BOOK/chapter06/ncurses.xml
___________________________________________________________________
Name: svn:keywords
   + "Author Date Revision Id"

Added: trunk/BOOK/chapter06/patch.xml
===================================================================
--- trunk/BOOK/chapter06/patch.xml	2005-02-14 20:20:32 UTC (rev 194)
+++ trunk/BOOK/chapter06/patch.xml	2005-02-14 20:59:45 UTC (rev 195)
@@ -0,0 +1,77 @@
+<?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" [
+  <!ENTITY % general-entities SYSTEM "../general.ent">
+  %general-entities;
+]>
+<sect1 id="ch-system-patch" role="wrap">
+<title>Patch-&patch-version;</title>
+<?dbhtml filename="patch.html"?>
+
+<indexterm zone="ch-system-patch"><primary sortas="a-Patch">Patch</primary></indexterm>
+
+<sect2 role="package"><title/>
+<para>The Patch package contains a program for modifying files.</para>
+
+<segmentedlist>
+<segtitle>&buildtime;</segtitle>
+<segtitle>&diskspace;</segtitle>
+<seglistitem><seg>?? SBU</seg><seg>?? MB</seg></seglistitem>
+</segmentedlist>
+
+<segmentedlist>
+<segtitle>Patch installation depends on</segtitle>
+<seglistitem><seg>Bash, Binutils, Coreutils, Diffutils,
+GCC, Glibc, Grep, Make, and Sed</seg></seglistitem>
+</segmentedlist>
+</sect2>
+
+<sect2 role="installation">
+<title>Installation of Patch</title>
+
+<para>Amend <filename>Makefile.in</filename>:</para>
+
+<screen><userinput>sed -e 's/^CFLAGS .*$/& -pie -fpie/' -i Makefile.in</userinput></screen>
+
+<para>Prepare Patch for compilation:</para>
+
+<screen><userinput>./configure --prefix=/usr ${disable_nls}</userinput></screen>
+
+<para>Compile the package:</para>
+
+<screen><userinput>make</userinput></screen>
+
+<para>This package does not come with a test suite.</para>
+
+<para>Install the package:</para>
+
+<screen><userinput>make install</userinput></screen>
+
+</sect2>
+
+
+<sect2 id="contents-patch" role="content"><title>Contents of Patch</title>
+
+<segmentedlist>
+<segtitle>Installed program</segtitle>
+<seglistitem><seg>patch</seg></seglistitem>
+</segmentedlist>
+
+<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead>
+<?dbfo list-presentation="list"?>
+
+<varlistentry id="patch">
+<term><command>patch</command></term>
+<listitem>
+<para>Modifies files according to a patch file. A patch file is normally
+a difference listing created with the <command>diff</command> program. By applying
+these differences to the original files, <command>patch</command> creates the patched
+versions.</para>
+<indexterm zone="ch-system-patch patch"><primary sortas="b-patch">patch</primary></indexterm>
+</listitem>
+</varlistentry>
+</variablelist>
+
+</sect2>
+
+</sect1>
+


Property changes on: trunk/BOOK/chapter06/patch.xml
___________________________________________________________________
Name: svn:keywords
   + "Author Date Revision Id"

Added: trunk/BOOK/chapter06/tar.xml
===================================================================
--- trunk/BOOK/chapter06/tar.xml	2005-02-14 20:20:32 UTC (rev 194)
+++ trunk/BOOK/chapter06/tar.xml	2005-02-14 20:59:45 UTC (rev 195)
@@ -0,0 +1,85 @@
+<?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" [
+  <!ENTITY % general-entities SYSTEM "../general.ent">
+  %general-entities;
+]>
+<sect1 id="ch-system-tar" role="wrap">
+<title>Tar-&tar-version;</title>
+<?dbhtml filename="tar.html"?>
+
+<indexterm zone="ch-system-tar"><primary sortas="a-Tar">Tar</primary></indexterm>
+
+<sect2 role="package"><title/>
+<para>The Tar package contains an archiving program.</para>
+
+<segmentedlist>
+<segtitle>&buildtime;</segtitle>
+<segtitle>&diskspace;</segtitle>
+<seglistitem><seg>?? SBU</seg><seg>?? MB</seg></seglistitem>
+</segmentedlist>
+
+<segmentedlist>
+<segtitle>Tar installation depends on</segtitle>
+<seglistitem><seg>Bash, Binutils, Coreutils,
+Diffutils, GCC, Gettext, Glibc, Grep, Make, and Sed</seg></seglistitem>
+</segmentedlist>
+</sect2>
+
+<sect2 role="installation">
+<title>Installation of Tar</title>
+
+<para>Amend <filename>Makefile.in</filename>:</para>
+
+<screen><userinput>sed -e 's/^CFLAGS .*$/& -pie -fpie/' -i {rmt,src}/Makefile.in</userinput></screen>
+
+<para>Prepare Tar for compilation:</para>
+
+<screen><userinput>./configure --prefix=/usr --bindir=/bin \
+    --libexecdir=/usr/sbin ${disable_nls}</userinput></screen>
+
+<para>Compile the package:</para>
+
+<screen><userinput>make</userinput></screen>
+
+<para>To test the results, issue:
+<userinput>make check</userinput>.</para>
+
+<para>Install the package:</para>
+
+<screen><userinput>make install</userinput></screen>
+
+</sect2>
+
+
+<sect2 id="contents-tar" role="content"><title>Contents of Tar</title>
+
+<segmentedlist>
+<segtitle>Installed programs</segtitle>
+<seglistitem><seg>rmt and tar</seg></seglistitem>
+</segmentedlist>
+
+<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead>
+<?dbfo list-presentation="list"?>
+
+<varlistentry id="rmt">
+<term><command>rmt</command></term>
+<listitem>
+<para>Remotely manipulates a magnetic
+tape drive through an interprocess communication connection</para>
+<indexterm zone="ch-system-tar rmt"><primary sortas="b-rmt">rmt</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="tar">
+<term><command>tar</command></term>
+<listitem>
+<para>Creates and extracts files from archives, also known as tarballs</para>
+<indexterm zone="ch-system-tar tar"><primary sortas="b-tar">tar</primary></indexterm>
+</listitem>
+</varlistentry>
+</variablelist>
+
+</sect2>
+
+</sect1>
+


Property changes on: trunk/BOOK/chapter06/tar.xml
___________________________________________________________________
Name: svn:keywords
   + "Author Date Revision Id"




More information about the hlfs-dev mailing list