diff options
Diffstat (limited to 'prologue')
| -rw-r--r-- | prologue/acknowledgments.xml | 306 | ||||
| -rw-r--r-- | prologue/audience.xml | 96 | ||||
| -rw-r--r-- | prologue/bookinfo.xml | 65 | ||||
| -rw-r--r-- | prologue/dedication.xml | 10 | ||||
| -rw-r--r-- | prologue/foreword.xml | 34 | ||||
| -rw-r--r-- | prologue/organization.xml | 38 | ||||
| -rw-r--r-- | prologue/preface.xml | 18 | ||||
| -rw-r--r-- | prologue/prerequisites.xml | 40 | ||||
| -rw-r--r-- | prologue/typography.xml | 52 |
9 files changed, 659 insertions, 0 deletions
diff --git a/prologue/acknowledgments.xml b/prologue/acknowledgments.xml new file mode 100644 index 000000000..84609cb3d --- /dev/null +++ b/prologue/acknowledgments.xml @@ -0,0 +1,306 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [ + <!ENTITY % general-entities SYSTEM "../general.ent"> + %general-entities; +]> +<sect1 id="ch-scatter-acknowledgments"> +<title>Acknowledgments</title> +<?dbhtml filename="acknowledgements.html"?> + +<para>We would like to thank the following people and organizations for their +contributions to the Linux From Scratch Project.</para> + +<sect2> +<title>Current Project Team Members</title> + +<itemizedlist> + +<listitem><para><ulink url="mailto:gerard@linuxfromscratch.org">Gerard +Beekmans</ulink> <gerard@linuxfromscratch.org> -- Linux-From-Scratch +initiator, LFS Project organizer.</para></listitem> + +<listitem><para><ulink url="mailto:matthew@linuxfromscratch.org">Matthew +Burgess</ulink> <matthew@linuxfromscratch.org> -- LFS General Package +maintainer, LFS Book editor.</para></listitem> + +<listitem><para><ulink url="mailto:meerkats@bellsouth.net">Craig +Colton</ulink> <meerkats@bellsouth.net> -- LFS, ALFS, BLFS and Hints +Project logo creator.</para></listitem> + +<listitem><para><ulink url="mailto:jeroen@linuxfromscratch.org">Jeroen +Coumans</ulink> <jeroen@linuxfromscratch.org> -- Website developer, FAQ +maintainer.</para></listitem> + +<listitem><para><ulink url="mailto:bdubbs@linuxfromscratch.org">Bruce +Dubbs</ulink> <bdubbs@linuxfromscratch.org> -- LFS Quality Assurance Team +leader, BLFS Book editor.</para></listitem> + +<listitem><para><ulink url="mailto:alex@linuxfromscratch.org">Alex +Groenewoud</ulink> <alex@linuxfromscratch.org> -- LFS Book +editor.</para></listitem> + +<listitem><para><ulink url="mailto:markh@linuxfromscratch.org">Mark +Hymers</ulink> <markh@linuxfromscratch.org> -- CVS maintainer, BLFS Book +creator, former LFS Book editor.</para></listitem> + +<listitem><para><ulink url="mailto:iwanek@linuxfromscratch.org">James +Iwanek</ulink> <iwanek@linuxfromscratch.org> -- System Administration +Team member.</para></listitem> + +<listitem><para><ulink url="mailto:nicholas@linuxfromscratch.org">Nicholas +Leippe</ulink> <nicholas@linuxfromscratch.org> -- Wiki +maintainer.</para></listitem> + +<listitem><para><ulink url="mailto:lizardo@linuxfromscratch.org">Anderson +Lizardo</ulink> <lizardo@linuxfromscratch.org> -- Website backend scripts +creator and maintainer.</para></listitem> + +<listitem><para><ulink url="mailto:bill@linuxfromscratch.org">Bill +Maltby</ulink> <bill@linuxfromscratch.org> -- LFS Project +organizer.</para></listitem> + +<listitem><para><ulink url="mailto:scot@linuxfromscratch.org">Scot Mc +Pherson</ulink> <scot@linuxfromscratch.org> -- LFS NNTP gateway +maintainer.</para></listitem> + +<listitem><para><ulink url="mailto:ryan@linuxfromscratch.org">Ryan +Oliver</ulink> <ryan@linuxfromscratch.org> -- Testing Team leader, +Toolchain maintainer, co-creator of PLFS.</para></listitem> + +<listitem><para><ulink url="mailto:jwrober@linuxfromscratch.org">James +Robertson</ulink> <jwrober@linuxfromscratch.org> -- Bugzilla maintainer, +Wiki developer, LFS Book editor.</para></listitem> + +<listitem><para><ulink url="mailto:greg@linuxfromscratch.org">Greg +Schafer</ulink> <greg@linuxfromscratch.org> -- Toolchain maintainer, +LFS Book editor, co-creator of PLFS.</para></listitem> + +<listitem><para><ulink url="mailto:tushar@linuxfromscratch.org">Tushar +Teredesai</ulink> <tushar@linuxfromscratch.org> -- BLFS Book editor, +Hints and Patches Projects maintainer.</para></listitem> + +<listitem><para><ulink url="mailto:jeremy@linuxfromscratch.org">Jeremy +Utley</ulink> <jeremy@linuxfromscratch.org> -- LFS Book editor, Bugzilla +maintainer.</para></listitem> + +<listitem><para>Countless other people on the various LFS and BLFS +mailing lists who are making this book happen by giving their suggestions, +testing the book and submitting bug reports, instructions and their +experiences with installing various packages.</para></listitem> + +</itemizedlist> + +</sect2> + +<sect2> +<title>Translators</title> + +<itemizedlist> + +<listitem><para><ulink url="mailto:macana@lfs-es.org">Manuel Canales +Esparcia</ulink> <macana@lfs-es.org> -- Spanish LFS translation +project.</para></listitem> + +<listitem><para><ulink url="mailto:johan@linuxfromscratch.org">Johan +Lenglet</ulink> <johan@linuxfromscratch.org> -- French LFS translation +project.</para></listitem> + +<listitem><para><ulink url="mailto:lizardo@linuxfromscratch.org">Anderson +Lizardo</ulink> <lizardo@linuxfromscratch.org> -- Portuguese LFS +translation project.</para></listitem> + +</itemizedlist> + +</sect2> + +<sect2> +<title>Mirror Maintainers</title> + +<itemizedlist> + +<listitem><para><ulink url="mailto:jason@dstc.edu.au">Jason Andrade</ulink> +<jason@dstc.edu.au> -- au.linuxfromscratch.org mirror.</para></listitem> + +<listitem><para><ulink url="mailto:lost@l-w.net">William Astle</ulink> +<lost@l-w.net> -- ca.linuxfromscratch.org mirror.</para></listitem> + +<listitem><para><ulink url="mailto:baque@cict.fr">Baque</ulink> +<baque@cict.fr> -- lfs.cict.fr mirror.</para></listitem> + +<listitem><para><ulink url="mailto:stevie@stevie20.de">Stephan Brendel</ulink> +<stevie@stevie20.de> -- lfs.netservice-neuss.de +mirror.</para></listitem> + +<listitem><para><ulink url="mailto:ian@ichilton.co.uk">Ian Chilton</ulink> +<ian@ichilton.co.uk> -- us.linuxfromscratch.org, linuxfromscratch.co.uk +mirrors.</para></listitem> + +<listitem><para><ulink url="mailto:fredan-lfs@fredan.org">Fredrik +Danerklint</ulink> <fredan-lfs@fredan.org> -- se.linuxfromscratch.org +mirror.</para></listitem> + +<listitem><para><ulink url="mailto:pgpkeys@aeternamtech.com">David D.W. +Downey</ulink> <pgpkeys@aeternamtech.com> -- lfs.learnbyexample.com +mirror.</para></listitem> + +<listitem><para><ulink url="mailto:ebf@aedsolucoes.com.br">Eduardo B. +Fonseca</ulink> <ebf@aedsolucoes.com.br> -- br.linuxfromscratch.org +mirror.</para></listitem> + +<listitem><para><ulink url="mailto:hrx@hrxnet.de">Hagen Herrschaft</ulink> +<hrx@hrxnet.de> -- de.linuxfromscratch.org mirror.</para></listitem> + +<listitem><para><ulink url="mailto:tim@idge.net">Tim Jackson</ulink> +<tim@idge.net> -- linuxfromscratch.idge.net mirror.</para></listitem> + +<listitem><para><ulink url="mailto:barna@siker.hu">Barna Koczka</ulink> +<barna@siker.hu> -- hu.linuxfromscratch.org mirror.</para></listitem> + +<listitem><para><ulink url="mailto:lfs-mirror@linuxfromscratch.rave.org">Roel +Neefs</ulink> -- linuxfromscratch.rave.org mirror.</para></listitem> + +<listitem><para><ulink url="mailto:sime@dot-sime.com">Simon Nicoll</ulink> +<sime@dot-sime.com> -- uk.linuxfromscratch.org mirror.</para></listitem> + +<listitem><para><ulink url="mailto:ervin@activalink.net">Ervin S. +Odisho</ulink> <ervin@activalink.net> -- lfs.activalink.net +mirror.</para></listitem> + +<listitem><para><ulink url="mailto:guido@primerelay.net">Guido Passet</ulink> +<guido@primerelay.net> -- nl.linuxfromscratch.org +mirror.</para></listitem> + +<listitem><para><ulink url="mailto:miha@xuy.biz">Mikhail Pastukhov</ulink> +<miha@xuy.biz> -- lfs.130th.net mirror.</para></listitem> + +<listitem><para><ulink url="mailto:jpolen@rackspace.com">Jeremy Polen</ulink> +<jpolen@rackspace.com> -- us2.linuxfromscratch.org +mirror.</para></listitem> + +<listitem><para><ulink url="http://www.mirror.ac.uk">UK Mirror Service</ulink> +-- linuxfromscratch.mirror.co.uk mirror.</para></listitem> + +<listitem><para><ulink url="mailto:thomas@sofagang.dk">Thomas Skyt</ulink> +<thomas@sofagang.dk> -- dk.linuxfromscratch.org mirror.</para></listitem> + +<listitem><para><ulink url="mailto:Antonin.Sprinzl@tuwien.ac.at">Antonin +Sprinzl</ulink> <Antonin.Sprinzl@tuwien.ac.at> -- at.linuxfromscratch.org +mirror.</para></listitem> + +<listitem><para><ulink url="mailto:dag@stenstad.net">Dag Stenstad</ulink> +<dag@stenstad.net> for providing no.linuxfromscratch.org and +<ulink url="mailto:ian@ichilton.co.uk">Ian Chilton</ulink> for running +it.</para></listitem> + +<listitem><para><ulink url="mailto:archive@doc.cs.univ-paris8.fr">Parisian +sysadmins</ulink> <archive@doc.cs.univ-paris8.fr> -- +www2.fr.linuxfromscratch.org mirror.</para></listitem> + +<listitem><para><ulink url="mailto:highos@linuxfromscratch.org">Jesse +Tie-Ten-Quee</ulink> <highos@linuxfromscratch.org> for providing and +running the linuxfromscratch.org server.</para></listitem> + +<listitem><para><ulink url="mailto:velin@zadnik.org">Alexander Velin</ulink> +<velin@zadnik.org> -- bg.linuxfromscratch.org mirror.</para></listitem> + +<listitem><para><ulink url="mailto:Martin.Voss@ada.de">Martin Voss</ulink> +<Martin.Voss@ada.de> -- lfs.linux-matrix.net mirror.</para></listitem> + +<listitem><para><ulink url="mailto:pyng@spam.averse.net">Pui Yong</ulink> +<pyng@spam.averse.net> -- sg.linuxfromscratch.org +mirror.</para></listitem> + +</itemizedlist> + +</sect2> + +<sect2> +<title>Donators</title> + +<itemizedlist> + +<listitem><para><ulink url="mailto:dean@vipersoft.co.uk">Dean Benson</ulink> +<dean@vipersoft.co.uk> for several monetary +contributions.</para></listitem> + +<listitem><para><ulink url="http://www.dreamwvr.com">DREAMWVR.COM</ulink> for +their past sponsorship of donating various resources to the LFS and related +sub projects.</para></listitem> + +<listitem><para><ulink url="mailto:hrx@hrxnet.de">Hagen Herrschaft</ulink> +<hrx@hrxnet.de> for donating a 2.2 GHz P4 system, now running under the +name of <emphasis>lorien</emphasis>.</para></listitem> + +<listitem><para><ulink url="http://www.oreilly.com">O'Reilly</ulink> for +donating books on SQL and PHP.</para></listitem> + +<listitem><para><ulink url="http://www.vasoftware.com">VA Software</ulink> +who, on behalf of <ulink url="http://www.linux.com">Linux.com</ulink>, donated +a VA Linux 420 (former StartX SP2) workstation.</para></listitem> + +<listitem><para><ulink url="mailto:strider@linux.com">Mark Stone</ulink> for +donating <emphasis>shadowfax</emphasis>, the first linuxfromscratch.org +server, a 750 MHz P3 with 512 MB RAM and two 9 GB SCSI drives. When the server +moved it was renamed to <emphasis>belgarath</emphasis>.</para></listitem> + +<listitem><para><ulink url="mailto:highos@linuxfromscratch.org">Jesse +Tie-Ten-Quee</ulink> <highos@linuxfromscratch.org> for donating a Yamaha +CDRW 8824E CD-writer.</para></listitem> + +<listitem><para>Countless other people on the various LFS mailing lists who are +making this book better by giving their suggestions, submitting bug reports, +and throwing in their criticism.</para></listitem> + +</itemizedlist> + +</sect2> + +<sect2> +<title>Former Team Members and Contributors</title> + +<itemizedlist> + +<listitem><para><ulink url="mailto:timothy@linuxfromscratch.org">Timothy +Bauscher</ulink> <timothy@linuxfromscratch.org> -- LFS Book editor, Hints +Project maintainer.</para></listitem> + +<listitem><para>Robert Briggs for originally donating the +<emphasis>linuxfromscratch.org</emphasis> and +<emphasis>linuxfromscratch.com</emphasis> domain names.</para></listitem> + +<listitem><para><ulink url="mailto:ian@ichilton.co.uk">Ian Chilton</ulink> +<ian@ichilton.co.uk> for maintaining the Hints project.</para></listitem> + +<listitem><para><ulink url="mailto:gimli@linuxfromscratch.org">Marc +Heerdink</ulink> <gimli@linuxfromscratch.org> -- LFS Book +editor.</para></listitem> + +<listitem><para><ulink url="mailto:sklein@linuxfromscratch.org">Seth W. +Klein</ulink> <sklein@linuxfromscratch.org> -- LFS FAQ +creator.</para></listitem> + +<listitem><para><ulink url="mailto:garrett@linuxart.com">Garrett +LeSage</ulink> <garrett@linuxart.com> -- Original LFS banner +creator.</para></listitem> + +<listitem><para><ulink url="mailto:nomis80@videotron.ca">Simon +Perreault</ulink> <nomis80@videotron.ca> -- Hints Project +maintainer.</para></listitem> + +<listitem><para><ulink url="mailto:Geert.Poels@skynet.be">Geert Poels</ulink> +<Geert.Poels@skynet.be> -- Original BLFS banner creator; based on the +LFS banner by Garrett LeSage.</para></listitem> + +<listitem><para><ulink url="mailto:bkenoah@oswd.org">Frank Skettino</ulink> +<bkenoah@oswd.org> for the initial design of the old website -- have a +look at <ulink url="http://www.oswd.org/"/>.</para></listitem> + +<listitem><para><ulink url="mailto:highos@linuxfromscratch.org">Jesse +Tie-Ten-Quee</ulink> <highos@linuxfromscratch.org> for answering +countless questions on IRC and having a great deal of patience.</para></listitem> + +</itemizedlist> + +</sect2> + +</sect1> diff --git a/prologue/audience.xml b/prologue/audience.xml new file mode 100644 index 000000000..c769b9067 --- /dev/null +++ b/prologue/audience.xml @@ -0,0 +1,96 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [ + <!ENTITY % general-entities SYSTEM "../general.ent"> + %general-entities; +]> +<sect1 id="pre-audience"> +<title>Audience</title> +<?dbhtml filename="audience.html"?> + +<sect2> +<title>Who would want to read this book</title> + +<para>There are many reasons why somebody would want to read this book. The +principal reason being to install a Linux system straight from the source +code. A question many people raise is <quote>Why go through all the hassle of +manually building a Linux system from scratch when you can just download and +install an existing one?</quote>. That is a good question and is the impetus for +this section of the book.</para> + +<para>One important reason for LFS's existence is to help people learn how a +Linux system works from the inside out. Building an LFS system helps demonstrate +to you what makes Linux tick, how things work together and depend on each +other. One of the best things that this learning experience provides is the +ability to customize Linux to your own tastes and needs.</para> + +<para>A key benefit of LFS is that you have more control of your system +without relying on someone else's Linux implementation. With LFS, you are +in the driver's seat and dictate every aspect of your system, such as the +directory layout and bootscript setup. You also dictate where, why and how +programs are installed.</para> + +<para>Another benefit of LFS is the ability to create a very compact Linux +system. When installing a regular distribution, you are usually forced to +install several programs which you are likely never to use. They're just +sitting there wasting precious disk space (or worse, CPU cycles). It isn't +difficult to build an LFS system of less than 100 MB. Does that still sound like a +lot? A few of us have been working on creating a very small embedded LFS +system. We successfully built a system that was just enough to run the Apache +web server with approximately 8MB of disk space used. Further stripping could +bring that down to 5 MB or less. Try that with a regular distribution.</para> + +<para>We could compare Linux distributions to a hamburger you buy at a +fast-food restaurant -- you have no idea what you are eating. LFS, on the +other hand, doesn't give you a hamburger, but the recipe to make a hamburger. +This allows you to review it, to omit unwanted ingredients, and to +add your own ingredients which enhance the flavor of your burger. When you +are satisfied with the recipe, you go on to preparing it. You make it just +the way you like it: broil it, bake it, deep-fry it, barbecue it, or eat it +tar-tar (raw).</para> + +<para>Another analogy that we can use is that of comparing LFS with a +finished house. LFS will give you the skeletal plan of a house, but it's up +to you to build it. You have the freedom to adjust your plans as you +go.</para> + +<para>One last advantage of a custom built Linux system is security. +By compiling the entire system from source code, you are empowered to audit +everything and apply all the security patches you feel are needed. You don't +have to wait for somebody else to compile binary packages that fix a security +hole. Unless you examine the patch and implement it yourself you have no +guarantee that the new binary package was built correctly and actually fixes the +problem (adequately).</para> + +<para>There are too many good reasons to build your own LFS system for them all +to be listed here. This section is only the tip of the iceberg. As you +continue in your LFS experience, you will find on your own the power that +information and knowledge truly bring.</para> + +</sect2> + +<sect2> +<title>Who would not want to read this book</title> + +<para>There are probably some who, for whatever reason, would feel that they do not +want to read this book. If you do not wish to build your own Linux system from +scratch, then you probably don't want to read this book. Our goal is to help +you build a complete and usable foundation-level system. If you only want to +know what happens while your computer boots, then we recommend the <quote>From +Power Up To Bash Prompt</quote> HOWTO. The HOWTO builds a bare system which is +similar to that of this book, but it focuses strictly on creating a system +capable of booting to a BASH prompt.</para> + +<para>While you decide which to read, consider your objective. If you wish +to build a Linux system while learning a bit along the way, then this book +is probably your best choice. If your objective is strictly educational and +you do not have any plans for your finished system, then the +<quote>From Power Up To Bash Prompt</quote> HOWTO is probably a better choice.</para> + +<para>The <quote>From Power Up To Bash Prompt</quote> HOWTO is located at +<ulink url="http://axiom.anu.edu.au/~okeefe/p2b/"/> or on The Linux +Documentation Project's website at +<ulink url="http://www.tldp.org/HOWTO/From-PowerUp-To-Bash-Prompt-HOWTO.html"/>.</para> + +</sect2> + +</sect1> diff --git a/prologue/bookinfo.xml b/prologue/bookinfo.xml new file mode 100644 index 000000000..501816b06 --- /dev/null +++ b/prologue/bookinfo.xml @@ -0,0 +1,65 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!DOCTYPE bookinfo PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [ + <!ENTITY % general-entities SYSTEM "../general.ent"> + %general-entities; +]> +<bookinfo> +<title>Linux From Scratch</title> +<subtitle>Version &version;</subtitle> + + +<authorgroup> +<author><firstname>Gerard</firstname><surname>Beekmans</surname></author> +</authorgroup> + + +<copyright id="copyright"> + <year>1999-2004</year> + <holder>Gerard Beekmans</holder> +</copyright> + + +<abstract> +<para>This book describes the process of creating a Linux system from +scratch, using nothing but the sources of the required software.</para> +</abstract> + + +<legalnotice> +<para>Copyright (c) 1999-2004, Gerard Beekmans</para> + +<para>All rights reserved.</para> + +<para>Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are +met:</para> + +<itemizedlist> + +<listitem><para>Redistributions in any form must retain the above copyright +notice, this list of conditions and the following disclaimer.</para></listitem> + +<listitem><para>Neither the name of <quote>Linux From Scratch</quote> nor the +names of its contributors may be used to endorse or promote products derived +from this material without specific prior written permission.</para></listitem> + +<listitem><para>Any material derived from Linux From Scratch must contain +a reference to the <quote>Linux From Scratch</quote> project.</para></listitem> + +</itemizedlist> + +<para>THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS ``AS +IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED +TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A +PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR +CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, +EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, +PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR +PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF +LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING +NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS +SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.</para> +</legalnotice> + + +</bookinfo> diff --git a/prologue/dedication.xml b/prologue/dedication.xml new file mode 100644 index 000000000..21494b098 --- /dev/null +++ b/prologue/dedication.xml @@ -0,0 +1,10 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!DOCTYPE dedication PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [ + <!ENTITY % general-entities SYSTEM "../general.ent"> + %general-entities; +]> +<dedication> +<title>Dedication</title> +<para>This book is dedicated to my loving and supportive wife +<emphasis>Beverly Beekmans</emphasis>.</para> +</dedication> diff --git a/prologue/foreword.xml b/prologue/foreword.xml new file mode 100644 index 000000000..82376683a --- /dev/null +++ b/prologue/foreword.xml @@ -0,0 +1,34 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [ + <!ENTITY % general-entities SYSTEM "../general.ent"> + %general-entities; +]> +<sect1 id="pf-foreword"> +<title>Foreword</title> +<?dbhtml filename="foreword.html"?> + +<para>Having used a number of different Linux distributions, I was never +fully satisfied with any of them. I didn't like the arrangement of +the bootscripts. I didn't like the way certain programs were configured by +default. Much more of that sort of thing bothered me. Finally I realized +that if I wanted full satisfaction from my Linux system I would have to +build my own system from scratch, using only the source code. I resolved +not to use pre-compiled packages of any kind, nor CD-ROM or boot disk that +would install some basic utilities. I would use my current Linux system to +develop my own.</para> + +<para>This wild idea seemed very difficult at the time and often seemed +an impossible task. After sorting out all kinds of problems, such as +dependencies and compile-time errors, a custom-built Linux system was +created that was fully operational. I called this system a Linux From Scratch +system, or LFS for short.</para> + +<para>I hope you will have a great time working on your own LFS!</para> + +<literallayout> +-- +Gerard Beekmans +gerard@linuxfromscratch.org +</literallayout> + +</sect1> diff --git a/prologue/organization.xml b/prologue/organization.xml new file mode 100644 index 000000000..d88f4938d --- /dev/null +++ b/prologue/organization.xml @@ -0,0 +1,38 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [ + <!ENTITY % general-entities SYSTEM "../general.ent"> + %general-entities; +]> +<sect1 id="pre-organization"> +<title>Structure</title> +<?dbhtml filename="organization.html"?> + +<para>This book is divided into the following four parts:</para> + +<sect2> +<title>Part I - Introduction</title> + +<para>Part I explains a few important things on how to proceed with the +installation, and gives meta-information about the book (version, changelog, +acknowledgments, associated mailing lists, and so on).</para> +</sect2> + +<sect2> +<title>Part II - Preparing for the build</title> + +<para>Part II describes how to prepare for the building process: making a +partition, downloading the packages, and compiling temporary tools.</para> +</sect2> + +<sect2> +<title>Part III - Building the LFS system</title> + +<para>Part III guides you through the building of the LFS system: compiling and +installing all the packages one by one, setting up the boot scripts, and +installing the kernel. The resulting basic Linux system is the foundation upon +which you can build other software, to extend your system in the way you like. +At the end of the book you'll find a list of all of the programs, libraries and +important files that have been installed as an easy to use reference.</para> +</sect2> + +</sect1> diff --git a/prologue/preface.xml b/prologue/preface.xml new file mode 100644 index 000000000..5fa4aec94 --- /dev/null +++ b/prologue/preface.xml @@ -0,0 +1,18 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!DOCTYPE preface PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [ + <!ENTITY % general-entities SYSTEM "../general.ent"> + %general-entities; +]> +<preface id="preface"> +<?dbhtml dir="prologue"?> +<title>Preface</title> +<?dbhtml filename="preface.html"?> + +<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="foreword.xml"/> +<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="audience.xml"/> +<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="prerequisites.xml"/> +<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="typography.xml"/> +<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="acknowledgments.xml"/> +<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="organization.xml"/> + +</preface> diff --git a/prologue/prerequisites.xml b/prologue/prerequisites.xml new file mode 100644 index 000000000..62ac031b9 --- /dev/null +++ b/prologue/prerequisites.xml @@ -0,0 +1,40 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [ + <!ENTITY % general-entities SYSTEM "../general.ent"> + %general-entities; +]> +<sect1 id="pf-prerequisites"> +<title>Prerequisites</title> +<?dbhtml filename="prerequisites.html"?> + +<para>This book assumes that its reader has a good deal of knowledge about +using and installing Linux software. Before you begin building your LFS +system, you should read the following HOWTOs:</para> + +<itemizedlist> +<listitem><para>Software-Building-HOWTO</para> + +<para>This is a comprehensive guide to building and installing +<quote>generic</quote> Unix software distributions under Linux. This HOWTO is +available at <ulink +url="http://www.tldp.org/HOWTO/Software-Building-HOWTO.html"/>.</para> +</listitem> + +<listitem><para>The Linux Users' Guide</para> + +<para>This guide covers the usage of assorted Linux software and is +available at +<ulink url="http://espc22.murdoch.edu.au/~stewart/guide/guide.html"/>.</para></listitem> + +<listitem><para>The Essential Pre-Reading Hint</para> + +<para>This is an LFS Hint written specifically for new users of Linux. It is +mostly a list of links to excellent sources of information on a wide range of +topics. Any person attempting to install LFS, should at least have an +understanding of many of the topics in this hint. It is available at + +<ulink url="&hints-root;essential_prereading.txt"/></para></listitem> + +</itemizedlist> + +</sect1> diff --git a/prologue/typography.xml b/prologue/typography.xml new file mode 100644 index 000000000..3a54e8b0c --- /dev/null +++ b/prologue/typography.xml @@ -0,0 +1,52 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [ + <!ENTITY % general-entities SYSTEM "../general.ent"> + %general-entities; +]> +<sect1 id="pre-typography"> +<title>Typography</title> +<?dbhtml filename="typography.html"?> + +<para>To make things easier to follow, there are a few typographical +conventions used throughout the book. Following are some examples:</para> + +<screen><userinput>./configure --prefix=/usr</userinput></screen> + +<blockquote><para>This form of text is designed to be typed exactly +as seen unless otherwise noted in the surrounding text. It is also used +in the explanation sections to identify which of the commands is being +referenced.</para></blockquote> + +<para><filename>install-info: unknown option +`--dir-file=/mnt/lfs/usr/info/dir'</filename></para> + +<blockquote><para>This form of text (fixed width text) is showing screen +output, probably as the result of commands issued, and is also used to +show filenames, such as <filename>/etc/ld.so.conf</filename>.</para></blockquote> + +<para><emphasis>Emphasis</emphasis></para> + +<blockquote><para>This form of text is used for several purposes in the +book, mainly to emphasize important points, and to give examples of +what to type.</para></blockquote> + +<para><ulink url="&lfs-root;"/></para> + +<blockquote><para>This form of text is used for hyperlinks, both within the +book and to external pages such as HOWTOs, download locations and +websites.</para></blockquote> + +<screen><userinput>cat > $LFS/etc/group << "EOF"</userinput> +root:x:0: +bin:x:1: +...... +<userinput>EOF</userinput> +</screen> + +<blockquote><para>This type of section is used mainly when creating +configuration files. The first command tells the system to create +the file $LFS/etc/group from whatever is typed on the following lines until +the sequence EOF is encountered. Therefore, this whole section is generally +typed as seen.</para></blockquote> + +</sect1> |