Changeset 7b82580


Ignore:
Timestamp:
01/22/2006 12:20:02 PM (18 years ago)
Author:
Manuel Canales Esparcia <manuel@…>
Branches:
10.0, 10.0-rc1, 10.1, 10.1-rc1, 11.0, 11.0-rc1, 11.0-rc2, 11.0-rc3, 11.1, 11.1-rc1, 11.2, 11.2-rc1, 11.3, 11.3-rc1, 12.0, 12.0-rc1, 12.1, 12.1-rc1, 6.3, 6.4, 6.5, 6.6, 6.7, 6.8, 7.0, 7.1, 7.2, 7.3, 7.4, 7.5, 7.5-systemd, 7.6, 7.6-systemd, 7.7, 7.7-systemd, 7.8, 7.8-systemd, 7.9, 7.9-systemd, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, arm, bdubbs/gcc13, ml-11.0, multilib, renodr/libudev-from-systemd, s6-init, trunk, xry111/arm64, xry111/arm64-12.0, xry111/clfs-ng, xry111/lfs-next, xry111/loongarch, xry111/loongarch-12.0, xry111/loongarch-12.1, xry111/mips64el, xry111/pip3, xry111/rust-wip-20221008, xry111/update-glibc
Children:
b28fd35
Parents:
e1d5f7b
Message:

Indenting chapter 05, part 4.

git-svn-id: ​http://svn.linuxfromscratch.org/LFS/trunk/BOOK@7290 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689

Files:
8 edited

Legend:

Unmodified
Added
Removed

  • chapter05/introduction.xml

    re1d5f7b r7b82580  
    11<?xml version="1.0" encoding="ISO-8859-1"?>
    2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
     3  "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
    34  <!ENTITY % general-entities SYSTEM "../general.ent">
    45  %general-entities;
    56]>
     7
    68<sect1 id="ch-tools-introduction">
    7 <title>Introduction</title>
    8 <?dbhtml filename="introduction.html"?>
     9  <?dbhtml filename="introduction.html"?>
    910
    10 <para>This chapter shows how to compile and install a minimal Linux
    11 system. This system will contain just enough tools to start
    12 constructing the final LFS system in <xref
    13 linkend="chapter-building-system"/> and allow a working environment
    14 with more user convenience than a minimum environment would.</para>
     11  <title>Introduction</title>
    1512
    16 <para>There are two steps in building this minimal system. The first
    17 step is to build a new and host-independent toolchain (compiler,
    18 assembler, linker, libraries, and a few useful utilities).  The second
    19 step uses this toolchain to build the other essential tools.</para>
     13  <para>This chapter shows how to compile and install a minimal Linux system.
     14  This system will contain just enough tools to start constructing the final
     15  LFS system in <xref linkend="chapter-building-system"/> and allow a working
     16  environment with more user convenience than a minimum environment would.</para>
    2017
    21 <para>The files compiled in this chapter will be installed under the
    22 <filename class="directory">$LFS/tools</filename> directory to keep
    23 them separate from the files installed in the next chapter and the
    24 host production directories. Since the packages compiled here are
    25 temporary, we do not want them to pollute the soon-to-be LFS
    26 system.</para>
     18  <para>There are two steps in building this minimal system. The first step
     19  is to build a new and host-independent toolchain (compiler, assembler,
     20  linker, libraries, and a few useful utilities).  The second step uses this
     21  toolchain to build the other essential tools.</para>
    2722
    28 <important><para>Before issuing the build instructions for a package, the package
    29 should be unpacked as user <emphasis>lfs</emphasis>, and a
    30 <command>cd</command> into the created directory should be performed. The build
    31 instructions assume that the <command>bash</command> shell is in use.</para></important>
     23  <para>The files compiled in this chapter will be installed under the
     24  <filename class="directory">$LFS/tools</filename> directory to keep them
     25  separate from the files installed in the next chapter and the host
     26  production directories. Since the packages compiled here are temporary,
     27  we do not want them to pollute the soon-to-be LFS system.</para>
    3228
    33 <para>Several of the packages are patched before compilation, but only
    34 when the patch is needed to circumvent a problem. A patch is often
    35 needed in both this and the next chapter, but sometimes in only one or
    36 the other. Therefore, do not be concerned if instructions for a downloaded
    37 patch seem to be missing. Warning messages about
    38 <emphasis>offset</emphasis> or <emphasis>fuzz</emphasis> may
    39 also be encountered when applying a patch. Do not worry about these
    40 warnings, as the patch was still successfully applied.</para>
     29  <important>
     30    <para>Before issuing the build instructions for a package, the package
     31    should be unpacked as user <systemitem class="username">lfs</systemitem>,
     32    and a <command>cd</command> into the created directory should be performed.
     33    The build instructions assume that the <command>bash</command> shell is
     34    in use.</para>
     35  </important>
    4136
    42 <para>During the compilation of most packages, there will be several
    43 warnings that scroll by on the screen. These are normal and can safely
    44 be ignored. These warnings are as they appear&mdash;warnings about
    45 deprecated, but not invalid, use of the C or C++ syntax. C standards
    46 change fairly often, and some packages still use the older standard.
    47 This is not a problem, but does prompt the warning.</para>
     37  <para>Several of the packages are patched before compilation, but only when
     38  the patch is needed to circumvent a problem. A patch is often needed in both
     39  this and the next chapter, but sometimes in only one or the other. Therefore,
     40  do not be concerned if instructions for a downloaded patch seem to be missing.
     41  Warning messages about <emphasis>offset</emphasis> or <emphasis>fuzz</emphasis>
     42  may also be encountered when applying a patch. Do not worry about these
     43  warnings, as the patch was still successfully applied.</para>
    4844
    49 <important><para>After installing each package, delete its source and build
    50 directories, unless specifically instructed otherwise. Deleting the
    51 sources prevents mis-configuration when the same package is reinstalled later.
    52 Only three of the packages need to retain the source and build directories in
    53 order for their contents to be used by later commands. Pay special attention to
    54 these reminders.</para></important>
     45  <para>During the compilation of most packages, there will be several warnings
     46  that scroll by on the screen. These are normal and can safely be ignored.
     47  These warnings are as they appear&mdash;warnings about deprecated, but not
     48  invalid, use of the C or C++ syntax. C standards change fairly often, and
     49  some packages still use the older standard. This is not a problem, but does
     50  prompt the warning.</para>
    5551
    56 <para>Check one last time that the <envar>LFS</envar> environment
    57 variable is set up properly:</para>
     52  <important>
     53    <para>After installing each package, delete its source and build directories,
     54    unless specifically instructed otherwise. Deleting the sources prevents
     55    mis-configuration when the same package is reinstalled later. Only three
     56    of the packages need to retain the source and build directories in order
     57    for their contents to be used by later commands. Pay special attention to
     58    these reminders.</para>
     59  </important>
     60
     61  <para>Check one last time that the <envar>LFS</envar> environment
     62  variable is set up properly:</para>
    5863
    5964<screen role="nodump"><userinput>echo $LFS</userinput></screen>
    6065
    61 <para>Make sure the output shows the path to the LFS partition's mount
    62 point, which is <filename class="directory">/mnt/lfs</filename>, using
    63 our example.</para>
     66  <para>Make sure the output shows the path to the LFS partition's mount
     67  point, which is <filename class="directory">/mnt/lfs</filename>, using
     68  our example.</para>
    6469
    6570</sect1>
    66 

  • chapter05/linux-libc-headers.xml

    re1d5f7b r7b82580  
    11<?xml version="1.0" encoding="ISO-8859-1"?>
    2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
     3  "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
    34  <!ENTITY % general-entities SYSTEM "../general.ent">
    45  %general-entities;
    56]>
     7
    68<sect1 id="ch-tools-linux-libc-headers" role="wrap">
    7 <title>Linux-Libc-Headers-&linux-libc-headers-version;</title>
    8 <?dbhtml filename="linux-libc-headers.html"?>
     9  <?dbhtml filename="linux-libc-headers.html"?>
    910
    10 <indexterm zone="ch-tools-linux-libc-headers">
    11 <primary sortas="a-Linux-Libc-Headers">Linux-Libc-Headers</primary>
    12 <secondary>tools, headers</secondary></indexterm>
     11  <title>Linux-Libc-Headers-&linux-libc-headers-version;</title>
    1312
    14 <sect2 role="package"><title/>
    15 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
    16         href="../chapter06/linux-libc-headers.xml"
    17         xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
     13  <indexterm zone="ch-tools-linux-libc-headers">
     14    <primary sortas="a-Linux-Libc-Headers">Linux-Libc-Headers</primary>
     15    <secondary>tools, headers</secondary>
     16  </indexterm>
    1817
    19 <segmentedlist>
    20 <segtitle>&buildtime;</segtitle>
    21 <segtitle>&diskspace;</segtitle>
    22 <seglistitem><seg>0.1 SBU</seg><seg>26.9 MB</seg></seglistitem>
    23 </segmentedlist>
     18  <sect2 role="package">
     19    <title/>
    2420
    25 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
    26         href="../chapter06/linux-libc-headers.xml"
    27         xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
     21    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
     22    href="../chapter06/linux-libc-headers.xml"
     23    xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
     24
     25    <segmentedlist>
     26      <segtitle>&buildtime;</segtitle>
     27      <segtitle>&diskspace;</segtitle>
     28
     29      <seglistitem>
     30        <seg>0.1 SBU</seg>
     31        <seg>26.9 MB</seg>
     32      </seglistitem>
     33    </segmentedlist>
     34
     35    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
     36    href="../chapter06/linux-libc-headers.xml"
     37    xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
    2838
    2939
    30 </sect2>
     40  </sect2>
    3141
    32 <sect2 role="installation">
    33 <title>Installation of Linux-Libc-Headers</title>
     42  <sect2 role="installation">
     43    <title>Installation of Linux-Libc-Headers</title>
    3444
    35 <para>For years it has been common practice to use <quote>raw</quote> kernel
    36 headers (straight from a kernel tarball) in <filename
    37 class="directory">/usr/include</filename>, but over the
    38 last few years, the kernel developers have taken a strong stance that
    39 this should not be done. This gave birth to the Linux-Libc-Headers
    40 Project, which was designed to maintain an Application Programming
    41 Interface (API) stable version of the Linux headers.</para>
     45    <para>For years it has been common practice to use <quote>raw</quote>
     46    kernel headers (straight from a kernel tarball) in <filename
     47    class="directory">/usr/include</filename>, but over the last few years,
     48    the kernel developers have taken a strong stance that this should not
     49    be done. This gave birth to the Linux-Libc-Headers Project, which was
     50    designed to maintain an Application Programming Interface (API) stable
     51    version of the Linux headers.</para>
    4252
    43 <para>Install the header files:</para>
     53    <para>Install the header files:</para>
    4454
    4555<screen><userinput>cp -Rv include/asm-i386 /tools/include/asm
    4656cp -Rv include/linux /tools/include</userinput></screen>
    4757
    48 <para>If your architecture is not i386 (compatible), adjust the first command
    49 accordingly.</para>
     58    <para>If your architecture is not i386 (compatible), adjust the first command
     59    accordingly.</para>
    5060
    51 </sect2>
     61  </sect2>
    5262
    53 <sect2 role="content"><title/>
    54 <para>Details on this package are located in <xref
    55 linkend="contents-linux-libc-headers" role="."/></para>
    56 </sect2>
     63  <sect2 role="content">
     64    <title/>
     65
     66    <para>Details on this package are located in
     67    <xref linkend="contents-linux-libc-headers" role="."/></para>
     68
     69  </sect2>
    5770
    5871</sect1>
    59 

  • chapter05/m4.xml

    re1d5f7b r7b82580  
    11<?xml version="1.0" encoding="ISO-8859-1"?>
    2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
     3  "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
    34  <!ENTITY % general-entities SYSTEM "../general.ent">
    45  %general-entities;
    56]>
     7
    68<sect1 id="ch-tools-m4" role="wrap">
    7 <title>M4-&m4-version;</title>
    8 <?dbhtml filename="m4.html"?>
     9  <?dbhtml filename="m4.html"?>
    910
    10 <indexterm zone="ch-tools-m4">
    11 <primary sortas="a-M4">M4</primary>
    12 <secondary>tools</secondary></indexterm>
     11  <title>M4-&m4-version;</title>
    1312
    14 <sect2 role="package"><title/>
    15 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/m4.xml" xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
     13  <indexterm zone="ch-tools-m4">
     14    <primary sortas="a-M4">M4</primary>
     15    <secondary>tools</secondary>
     16  </indexterm>
    1617
    17 <segmentedlist>
    18 <segtitle>&buildtime;</segtitle>
    19 <segtitle>&diskspace;</segtitle>
    20 <seglistitem><seg>0.1 SBU</seg><seg>2.8 MB</seg></seglistitem>
    21 </segmentedlist>
     18  <sect2 role="package">
     19    <title/>
    2220
    23 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/m4.xml" xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
     21    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
     22    href="../chapter06/m4.xml"
     23    xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
    2424
    25 </sect2>
     25    <segmentedlist>
     26      <segtitle>&buildtime;</segtitle>
     27      <segtitle>&diskspace;</segtitle>
    2628
    27 <sect2 role="installation">
    28 <title>Installation of M4</title>
     29      <seglistitem>
     30        <seg>0.1 SBU</seg>
     31        <seg>2.8 MB</seg>
     32      </seglistitem>
     33    </segmentedlist>
    2934
    30 <para>Prepare M4 for compilation:</para>
     35    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
     36    href="../chapter06/m4.xml"
     37    xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
     38
     39  </sect2>
     40
     41  <sect2 role="installation">
     42    <title>Installation of M4</title>
     43
     44    <para>Prepare M4 for compilation:</para>
    3145
    3246<screen><userinput>./configure --prefix=/tools</userinput></screen>
    3347
    34 <para>Compile the package:</para>
     48    <para>Compile the package:</para>
    3549
    3650<screen><userinput>make</userinput></screen>
    3751
    38 <para>To test the results, issue: <userinput>make check</userinput>.</para>
     52    <para>To test the results, issue:
     53    <userinput>make check</userinput>.</para>
    3954
    40 <para>Install the package:</para>
     55    <para>Install the package:</para>
    4156
    4257<screen><userinput>make install</userinput></screen>
    4358
    44 </sect2>
     59  </sect2>
    4560
    46 <sect2 role="content"><title/>
    47 <para>Details on this package are located in <xref
    48 linkend="contents-m4" role="."/></para>
    49 </sect2>
     61  <sect2 role="content">
     62    <title/>
     63
     64    <para>Details on this package are located in
     65    <xref linkend="contents-m4" role="."/></para>
     66
     67  </sect2>
    5068
    5169</sect1>
    52 

  • chapter05/make.xml

    re1d5f7b r7b82580  
    11<?xml version="1.0" encoding="ISO-8859-1"?>
    2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
     3  "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
    34  <!ENTITY % general-entities SYSTEM "../general.ent">
    45  %general-entities;
    56]>
    67<sect1 id="ch-tools-make" role="wrap">
    7 <title>Make-&make-version;</title>
    8 <?dbhtml filename="make.html"?>
     8  <?dbhtml filename="make.html"?>
    99
    10 <indexterm zone="ch-tools-make">
    11 <primary sortas="a-Make">Make</primary>
    12 <secondary>tools</secondary></indexterm>
     10  <title>Make-&make-version;</title>
    1311
    14 <sect2 role="package"><title/>
    15 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/make.xml" xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
     12  <indexterm zone="ch-tools-make">
     13    <primary sortas="a-Make">Make</primary>
     14    <secondary>tools</secondary>
     15  </indexterm>
    1616
    17 <segmentedlist>
    18 <segtitle>&buildtime;</segtitle>
    19 <segtitle>&diskspace;</segtitle>
    20 <seglistitem><seg>0.2 SBU</seg><seg>7.1 MB</seg></seglistitem>
    21 </segmentedlist>
     17  <sect2 role="package">
     18    <title/>
    2219
    23 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/make.xml" xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
     20    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
     21    href="../chapter06/make.xml"
     22    xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
    2423
    25 </sect2>
     24    <segmentedlist>
     25      <segtitle>&buildtime;</segtitle>
     26      <segtitle>&diskspace;</segtitle>
    2627
    27 <sect2 role="installation">
    28 <title>Installation of Make</title>
     28      <seglistitem>
     29        <seg>0.2 SBU</seg>
     30        <seg>7.1 MB</seg>
     31      </seglistitem>
     32    </segmentedlist>
    2933
    30 <para>Prepare Make for compilation:</para>
     34    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
     35    href="../chapter06/make.xml"
     36    xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
     37
     38  </sect2>
     39
     40  <sect2 role="installation">
     41    <title>Installation of Make</title>
     42
     43    <para>Prepare Make for compilation:</para>
    3144
    3245<screen><userinput>./configure --prefix=/tools</userinput></screen>
    3346
    34 <para>Compile the package:</para>
     47    <para>Compile the package:</para>
    3548
    3649<screen><userinput>make</userinput></screen>
    3750
    38 <para>To test the results, issue: <userinput>make check</userinput>.</para>
     51    <para>To test the results, issue:
     52    <userinput>make check</userinput>.</para>
    3953
    40 <para>Install the package:</para>
     54    <para>Install the package:</para>
    4155
    4256<screen><userinput>make install</userinput></screen>
    4357
    44 </sect2>
     58  </sect2>
    4559
    46 <sect2 role="content"><title/>
    47 <para>Details on this package are located in <xref
    48 linkend="contents-make" role="."/></para>
    49 </sect2>
     60  <sect2 role="content">
     61    <title/>
     62
     63    <para>Details on this package are located in
     64    <xref linkend="contents-make" role="."/></para>
     65
     66  </sect2>
    5067
    5168</sect1>
    52 

  • chapter05/ncurses.xml

    re1d5f7b r7b82580  
    11<?xml version="1.0" encoding="ISO-8859-1"?>
    2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
     3  "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
    34  <!ENTITY % general-entities SYSTEM "../general.ent">
    45  %general-entities;
    56]>
     7
    68<sect1 id="ch-tools-ncurses" role="wrap">
    7 <title>Ncurses-&ncurses-version;</title>
    8 <?dbhtml filename="ncurses.html"?>
     9  <?dbhtml filename="ncurses.html"?>
    910
    10 <indexterm zone="ch-tools-ncurses">
    11 <primary sortas="a-Ncurses">Ncurses</primary>
    12 <secondary>tools</secondary></indexterm>
     11  <title>Ncurses-&ncurses-version;</title>
    1312
    14 <sect2 role="package"><title/>
    15 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/ncurses.xml" xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
     13  <indexterm zone="ch-tools-ncurses">
     14    <primary sortas="a-Ncurses">Ncurses</primary>
     15    <secondary>tools</secondary>
     16  </indexterm>
    1617
    17 <segmentedlist>
    18 <segtitle>&buildtime;</segtitle>
    19 <segtitle>&diskspace;</segtitle>
    20 <seglistitem><seg>0.7 SBU</seg><seg>27.5 MB</seg></seglistitem>
    21 </segmentedlist>
     18  <sect2 role="package">
     19    <title/>
    2220
    23 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/ncurses.xml" xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
     21    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
     22    href="../chapter06/ncurses.xml"
     23    xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
    2424
    25 </sect2>
     25    <segmentedlist>
     26      <segtitle>&buildtime;</segtitle>
     27      <segtitle>&diskspace;</segtitle>
    2628
    27 <sect2 role="installation">
    28 <title>Installation of Ncurses</title>
     29      <seglistitem>
     30      <seg>0.7 SBU</seg>
     31      <seg>27.5 MB</seg>
     32      </seglistitem>
     33    </segmentedlist>
    2934
    30 <para>Prepare Ncurses for compilation:</para>
     35    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
     36    href="../chapter06/ncurses.xml"
     37    xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
     38
     39  </sect2>
     40
     41  <sect2 role="installation">
     42    <title>Installation of Ncurses</title>
     43
     44    <para>Prepare Ncurses for compilation:</para>
    3145
    3246<screen><userinput>./configure --prefix=/tools --with-shared \
    3347    --without-debug --without-ada --enable-overwrite</userinput></screen>
    3448
    35 <para>The meaning of the configure options:</para>
     49    <variablelist>
     50      <title>The meaning of the configure options:</title>
    3651
    37 <variablelist>
    38 <varlistentry>
    39 <term><parameter>--without-ada</parameter></term>
    40 <listitem><para>This ensures that Ncurses does not build support for the Ada
    41 compiler which may be present on the host but will not be available once we
    42 enter the <command>chroot</command> environment.</para></listitem>
    43 </varlistentry>
     52      <varlistentry>
     53        <term><parameter>--without-ada</parameter></term>
     54        <listitem>
     55          <para>This ensures that Ncurses does not build support for the Ada
     56          compiler which may be present on the host but will not be available
     57          once we enter the <command>chroot</command> environment.</para>
     58        </listitem>
     59      </varlistentry>
    4460
    45 <varlistentry>
    46 <term><parameter>--enable-overwrite</parameter></term>
    47 <listitem><para>This tells Ncurses to install its header files into
    48 <filename class="directory">/tools/include</filename>, instead of
    49 <filename class="directory">/tools/include/ncurses</filename>, to
    50 ensure that other packages can find the Ncurses headers
    51 successfully.</para></listitem>
    52 </varlistentry>
    53 </variablelist>
     61      <varlistentry>
     62        <term><parameter>--enable-overwrite</parameter></term>
     63        <listitem>
     64          <para>This tells Ncurses to install its header files into
     65          <filename class="directory">/tools/include</filename>, instead of
     66          <filename class="directory">/tools/include/ncurses</filename>, to
     67          ensure that other packages can find the Ncurses headers
     68          successfully.</para>
     69        </listitem>
     70      </varlistentry>
    5471
    55 <para>Compile the package:</para>
     72    </variablelist>
     73
     74    <para>Compile the package:</para>
    5675
    5776<screen><userinput>make</userinput></screen>
    5877
    59 <para>This package does not come with a test suite.</para>
     78    <para>This package does not come with a test suite.</para>
    6079
    61 <para>Install the package:</para>
     80    <para>Install the package:</para>
    6281
    6382<screen><userinput>make install</userinput></screen>
    6483
    65 </sect2>
     84  </sect2>
    6685
    67 <sect2 role="content"><title/>
    68 <para>Details on this package are located in <xref
    69 linkend="contents-ncurses" role="."/></para>
    70 </sect2>
     86  <sect2 role="content">
     87    <title/>
     88
     89    <para>Details on this package are located in
     90    <xref linkend="contents-ncurses" role="."/></para>
     91
     92  </sect2>
    7193
    7294</sect1>
    73 

  • chapter05/patch.xml

    re1d5f7b r7b82580  
    11<?xml version="1.0" encoding="ISO-8859-1"?>
    2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
     3  "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
    34  <!ENTITY % general-entities SYSTEM "../general.ent">
    45  %general-entities;
    56]>
     7
    68<sect1 id="ch-tools-patch" role="wrap">
    7 <title>Patch-&patch-version;</title>
    8 <?dbhtml filename="patch.html"?>
     9  <?dbhtml filename="patch.html"?>
    910
    10 <indexterm zone="ch-tools-patch">
    11 <primary sortas="a-Patch">Patch</primary>
    12 <secondary>tools</secondary></indexterm>
     11  <title>Patch-&patch-version;</title>
    1312
    14 <sect2 role="package"><title/>
    15 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/patch.xml" xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
     13  <indexterm zone="ch-tools-patch">
     14    <primary sortas="a-Patch">Patch</primary>
     15    <secondary>tools</secondary>
     16  </indexterm>
    1617
    17 <segmentedlist>
    18 <segtitle>&buildtime;</segtitle>
    19 <segtitle>&diskspace;</segtitle>
    20 <seglistitem><seg>0.1 SBU</seg><seg>1.5 MB</seg></seglistitem>
    21 </segmentedlist>
     18  <sect2 role="package">
     19    <title/>
    2220
    23 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/patch.xml" xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
     21    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
     22    href="../chapter06/patch.xml"
     23    xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
    2424
    25 </sect2>
     25    <segmentedlist>
     26      <segtitle>&buildtime;</segtitle>
     27      <segtitle>&diskspace;</segtitle>
    2628
    27 <sect2 role="installation">
    28 <title>Installation of Patch</title>
     29      <seglistitem>
     30        <seg>0.1 SBU</seg>
     31        <seg>1.5 MB</seg>
     32      </seglistitem>
     33    </segmentedlist>
    2934
    30 <para>Prepare Patch for compilation:</para>
     35    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
     36    href="../chapter06/patch.xml"
     37    xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
     38
     39  </sect2>
     40
     41  <sect2 role="installation">
     42    <title>Installation of Patch</title>
     43
     44    <para>Prepare Patch for compilation:</para>
    3145
    3246<screen><userinput>CPPFLAGS=-D_GNU_SOURCE ./configure --prefix=/tools</userinput></screen>
    3347
    34 <para>The preprocessor flag <parameter>-D_GNU_SOURCE</parameter> is
    35 only needed on the PowerPC platform. It can be left out on other
    36 architectures.</para>
     48    <para>The preprocessor flag <parameter>-D_GNU_SOURCE</parameter> is
     49    only needed on the PowerPC platform. It can be left out on other
     50    architectures.</para>
    3751
    38 <para>Compile the package:</para>
     52    <para>Compile the package:</para>
    3953
    4054<screen><userinput>make</userinput></screen>
    4155
    42 <para>This package does not come with a test suite.</para>
     56    <para>This package does not come with a test suite.</para>
    4357
    44 <para>Install the package:</para>
     58    <para>Install the package:</para>
    4559
    4660<screen><userinput>make install</userinput></screen>
    4761
    48 </sect2>
     62  </sect2>
    4963
    50 <sect2 role="content"><title/>
    51 <para>Details on this package are located in <xref
    52 linkend="contents-patch" role="."/></para>
    53 </sect2>
     64  <sect2 role="content">
     65    <title/>
     66
     67    <para>Details on this package are located in
     68    <xref linkend="contents-patch" role="."/></para>
     69
     70  </sect2>
    5471
    5572</sect1>
    56 

  • chapter05/perl.xml

    re1d5f7b r7b82580  
    11<?xml version="1.0" encoding="ISO-8859-1"?>
    2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
     3  "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
    34  <!ENTITY % general-entities SYSTEM "../general.ent">
    45  %general-entities;
    56]>
     7
    68<sect1 id="ch-tools-perl" role="wrap">
    7 <title>Perl-&perl-version;</title>
    8 <?dbhtml filename="perl.html"?>
     9  <?dbhtml filename="perl.html"?>
    910
    10 <indexterm zone="ch-tools-perl">
    11 <primary sortas="a-Perl">Perl</primary>
    12 <secondary>tools</secondary></indexterm>
     11  <title>Perl-&perl-version;</title>
    1312
    14 <sect2 role="package"><title/>
    15 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/perl.xml" xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
     13  <indexterm zone="ch-tools-perl">
     14    <primary sortas="a-Perl">Perl</primary>
     15    <secondary>tools</secondary>
     16  </indexterm>
    1617
    17 <segmentedlist>
    18 <segtitle>&buildtime;</segtitle>
    19 <segtitle>&diskspace;</segtitle>
    20 <seglistitem><seg>0.8 SBU</seg><seg>79.8 MB</seg></seglistitem>
    21 </segmentedlist>
     18  <sect2 role="package">
     19    <title/>
    2220
    23 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/perl.xml" xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
     21    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
     22    href="../chapter06/perl.xml"
     23    xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
    2424
    25 </sect2>
     25    <segmentedlist>
     26      <segtitle>&buildtime;</segtitle>
     27      <segtitle>&diskspace;</segtitle>
    2628
    27 <sect2 role="installation">
    28 <title>Installation of Perl</title>
     29      <seglistitem>
     30        <seg>0.8 SBU</seg>
     31        <seg>79.8 MB</seg>
     32      </seglistitem>
     33    </segmentedlist>
    2934
    30 <para>First adapt some hard-wired paths to the C library by applying
    31 the following patch:</para>
     35    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
     36    href="../chapter06/perl.xml"
     37    xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
     38
     39  </sect2>
     40
     41  <sect2 role="installation">
     42    <title>Installation of Perl</title>
     43
     44    <para>First adapt some hard-wired paths to the C library by applying
     45    the following patch:</para>
    3246
    3347<screen><userinput>patch -Np1 -i ../&perl-libc-patch;</userinput></screen>
    3448
    35 <para>Prepare Perl for compilation (make sure to get the
    36 'Data/Dumper Fcntl IO POSIX' part of the command correct&mdash;they are all
    37 letters):</para>
     49    <para>Prepare Perl for compilation (make sure to get the
     50    'Data/Dumper Fcntl IO POSIX' part of the command correct&mdash;they are all
     51    letters):</para>
    3852
    3953<screen><userinput>./configure.gnu --prefix=/tools -Dstatic_ext='Data/Dumper Fcntl IO POSIX'</userinput></screen>
    4054
    41 <para>The meaning of the configure options:</para>
     55    <variablelist>
     56      <title>The meaning of the configure options:</title>
    4257
    43 <variablelist>
    44 <varlistentry>
    45 <term><parameter>-Dstatic_ext='Data/Dumper Fcntl IO POSIX'</parameter></term>
    46 <listitem><para>This tells Perl to build the minimum set of static
    47 extensions needed for installing and testing the Coreutils package in
    48 the next chapter.</para></listitem>
    49 </varlistentry>
    50 </variablelist>
     58      <varlistentry>
     59        <term><parameter>-Dstatic_ext='Data/Dumper Fcntl IO POSIX'</parameter></term>
     60        <listitem>
     61          <para>This tells Perl to build the minimum set of static extensions
     62          needed for installing and testing the Coreutils package in the next
     63          chapter.</para>
     64        </listitem>
     65      </varlistentry>
    5166
    52 <para>Only a few of the utilities contained in this package need to be
    53 built:</para>
     67    </variablelist>
     68
     69    <para>Only a few of the utilities contained in this package need to be
     70    built:</para>
    5471
    5572<screen><userinput>make perl utilities</userinput></screen>
    5673
    57 <para>Although Perl comes with a test suite, it is not recommended to
    58 run it at this point. Only part of Perl was built and running
    59 <userinput>make test</userinput> now will cause the rest of Perl to be
    60 built as well, which is unnecessary at this point. The test suite can
    61 be run in the next chapter if desired.</para>
     74    <para>Although Perl comes with a test suite, it is not recommended to
     75    run it at this point. Only part of Perl was built and running
     76    <userinput>make test</userinput> now will cause the rest of Perl to be
     77    built as well, which is unnecessary at this point. The test suite can
     78    be run in the next chapter if desired.</para>
    6279
    63 <para>Install these tools and their libraries:</para>
     80    <para>Install these tools and their libraries:</para>
    6481
    6582<screen><userinput>cp -v perl pod/pod2man /tools/bin
    … …  
    6784cp -Rv lib/* /tools/lib/perl5/&perl-version;</userinput></screen>
    6885
    69 </sect2>
     86  </sect2>
    7087
    71 <sect2 role="content"><title/>
    72 <para>Details on this package are located in <xref
    73 linkend="contents-perl" role="."/></para>
    74 </sect2>
     88  <sect2 role="content">
     89    <title/>
     90
     91    <para>Details on this package are located in
     92    <xref linkend="contents-perl" role="."/></para>
     93
     94  </sect2>
    7595
    7696</sect1>
    77 

  • general.ent

    re1d5f7b r7b82580  
    11<?xml version="1.0" encoding="ISO-8859-1"?>
    2 <!ENTITY version "SVN-20060120">
    3 <!ENTITY releasedate "January 20, 2006">
     2<!ENTITY version "SVN-20060122">
     3<!ENTITY releasedate "January 22, 2006">
    44<!ENTITY milestone "6.2">
    55<!ENTITY generic-version "development"> <!-- Use "development", "testing", or "x.y[-pre{x}]" -->
Note: See TracChangeset for help on using the changeset viewer.