gronod/lfs
1
0
Fork 0
mirror of https://git.linuxfromscratch.org/lfs.git synced 2025-06-19 03:39:20 +01:00
Code Issues Packages Projects Releases Wiki Activity

text updates

Browse Source 
git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@1105 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689
This commit is contained in:
Gerard Beekmans 2001-08-29 16:56:32 +00:00
parent bc831b5f5f
commit fada43129e
7 changed files with 51 additions and 46 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
chapter01/how.xml
View File

@ -14,20 +14,25 @@ will be installed onto.</para>
<para>The next step, chapter 5, will be the installation of a number of
packages that are statically linked and installed on the LFS partition.
These packages form a basic development suite which will be used to
install the actual system.</para>
install the actual system, and are also needed to resolve circular
dependencies. Examples of circular dependencies are: you need a compiler
to install a compiler. You need a shell in order to install a shell. And
so on.</para>
<para>Chapter 6 installs the actual base system. We use the chroot program to
start a new shell who's root directory will be set to the LFS
<para>Chapter 6 installs the actual base system. We use the chroot program
to start a new shell whose root directory will be set to the LFS
partition. This, in essence, is the same as rebooting and have the
kernel mount the LFS partition as the root partition. The reason that
we don't actually reboot, but instead chroot, is that this way you can
still use your host system. While software is being installed you can
simply switch to a different VC (Virtual Console) or X desktop and
continue using your computer.</para>
continue using your computer as you normally would.</para>
<para>When all the software is installed, chapter 7 will setup the boot
scripts. Chapter 8 will setup the Linux boot loader and you can finally
reboot your system into your new LFS-system.</para>
scripts. Chapter 8 will setup the Linux boot loader and in chapter 9
there are some pointers what you can do after you finish the book. Then
you can finally reboot your system into your new LFS system, and start
to really use it.</para>
<para>This is the process in a nutshell. Detailed information on the steps
you are taking are provided in the chapters as you go through them. If

7
chapter01/versions.xml
View File

@ -2,11 +2,12 @@
<title>Book version</title>
<para>This is LFS-BOOK version &version; dated &releasedate;. If this
version is older than a month a newer version might be available for download
at the LFS homepage.</para>
version is older than a month a newer version is probably already available
for download. Check one of the mirror sites below for updated
versions.</para>
<para>Below is a list of our current HTTP and FTP mirror sites as
of August 27th, 2001. This list might not be accurate anymore.
of August 29th, 2001. This list might not be accurate anymore.
The latest info can be found on our website at
<ulink url="http://www.linuxfromscratch.org">http://www.linuxfromscratch.org</ulink>.</para>

8
chapter02/aboutlfs.xml
View File

@ -3,10 +3,10 @@
<para>Please read the following carefully: throughout this book
the variable $LFS will be used frequently. $LFS must at all times be
replaced by the directory where the partition that contains the LFS system
replaced with the directory where the partition that contains the LFS system
is mounted. How to create and where to mount the partition will be
explained in full detail in chapter 4. In my case, the LFS
partition is mounted on /mnt/lfs.</para>
explained in full detail in chapter 4. For example, let's assume that
the LFS partition is mounted on /mnt/lfs.</para>
<para>For example when you are told to run a command like
<userinput>./configure --prefix=$LFS</userinput> you actually have to
@ -16,7 +16,7 @@ execute <userinput>./configure --prefix=/mnt/lfs</userinput></para>
commands entered in a shell, or in a file edited or created.</para>
<para>A possible solution is to set the environment variable LFS.
This way $LFS can be entered literally instead of replacing it by
This way $LFS can be entered literally instead of replacing it with
/mnt/lfs. This is accomplished by running <userinput>export
LFS=/mnt/lfs</userinput>.</para>

2
chapter02/bootscripts.xml
View File

@ -1,7 +1,7 @@
<sect1 id="ch02-bootscripts">
<title>Download the bootscripts</title>
<para>Typing out all the bootscripts in chapters 7 and 9 can be a long, tedious
<para>Typing out all the bootscripts in chapter 7can be a long, tedious
process, not to mention very error-prone.</para>
<para>To save some time, the bootscripts can be downloaded from <ulink

19
chapter02/commands.xml
View File

@ -5,7 +5,7 @@
commands for the packages installed in this book.</para>
<para>These files can be used to quickly find out which commands have
been changed between the different LFS versions as well. Download the
been changed between the different LFS versions. Download the
lfs-commands tarball for this book version and the previous book
version and run a diff on the files. That way it is possible to see which
packages have updated installation instructions, so any scripts you may
@ -13,13 +13,16 @@ have can be modified, or you can reinstall a package if you think that
necessary.</para>
<para>A side effect is that these files can be used to dump to a shell and
install the packages, though some files need to be modified (for
example, when the kbd package is installed, you needed to select the
keyboard layout file, because it can't reliably be guessed). Keep in
mind, please, that these files are not checked for correctness,
integrity and so forth. There may be bugs in the files (since they are
manually created, typo's are often inevitable) so do check them and
don't blindly trust them.</para>
install the packages, though some files need to be modified (where
certain settings can't be guessed and depend on user preference or
system hardware). Keep in mind, please, that these files are not
thoroughly checked for correctness. There may be bugs in the files (since
they are manually created at the moment) so do check them and don't
blindly trust them.</para>
<para>If you decide to use the commands to automatically install a
package and it doesn't work, try reading the book's instructions
instead before you ask for help on the mailinglist.</para>
<para>The lfscommands can be downloaded from <ulink
url="&http-root;/lfs-commands/">&http-root;/lfs-commands/</ulink>

21
chapter02/download.xml
View File

@ -1,25 +1,20 @@
<sect1 id="ch02-download">
<title>How to download the software</title>
<para>Throughout this document, I will assume that all the
<para>Throughout this document, we will assume that all the
packages that were downloaded are placed somewhere in $LFS/usr/src.</para>
<para>I use the convention of having a $LFS/usr/src/sources directory.
Under sources, I have the directory 0-9 and the directories a
<para>A convention you could use is having a $LFS/usr/src/sources directory.
Under sources, you can create the directory 0-9 and the directories a
through z. A package like sysvinit-&sysvinit-version;.tar.bz2 is stored under
$LFS/usr/src/sources/s/. A package like bash-&bash-version;.tar.bz2 is stored
under $LFS/usr/src/sources/b/, and so forth. This convention does not have to
be followed, of course; I was just giving an example. It's better to keep
the packages out of $LFS/usr/src and move them to a subdirectory, so
we'll have a clean $LFS/usr/src directory in which we will unpack the
packages and work with them.</para>
under $LFS/usr/src/sources/b/, and so forth.</para>
<para>The next chapter contains the list of all the packages that need to be
downloaded,
but the partition that is going to contain our LFS system isn't created yet.
Therefore, the files are temporarily stored somewhere else (it's up to
you to decide where this 'else' is) and later moved to $LFS/usr/src/ when
the chapter in which the new partition is prepared has been finished.</para>
downloaded, but the partition that is going to contain our LFS system isn't
created yet. Therefore, you should store the files somewhere else and later
moved to $LFS/usr/src/ when the chapter in which the new partition is
prepared has been finished.</para>
</sect1>

23
chapter02/install.xml
View File

@ -8,8 +8,8 @@ simple life, use bash.</para>
<para>Before you can actually start doing something with a package, you need
to unpack it first. Often the package files are tar'ed and
gzip'ed or bzip2'ed. I'm not going to write down every time how to
unpack an archive. I will explain how to do that once, in this
gzip'ed or bzip2'ed. We're not going to write down every time how to
unpack an archive. We'll explain how to do that once, in this
section.</para>
<para>To start with, change to the $LFS/usr/src directory by running:</para>
@ -58,15 +58,16 @@ can be used they need to be uncompressed first.</para>
<para><screen><userinput>bunzip2 filename.bz2</userinput></screen></para>
<para>After a package has been installed, two things can be done with it:
either the directory that contains the sources can be deleted,
or it can be kept. If it is kept, that's fine with me, but if the
same package is needed again in a later chapter, the directory
needs to be deleted first before using it again. If this is not done,
you might end up in trouble because old settings will be used (settings
that apply to the host system but which don't always apply to
the LFS system). Doing a simple make clean or make distclean does not
always guarantee a totally clean source tree.</para>
<para>After a package has been installed, two things can be done with
it: either the directory that contains the sources can be deleted, or it
can be kept. We highly recommend deleting it. If you don't do this and
try to re-use the same source later on in the book (for example re-using
the source trees from chapter 5 for use in chapter 6), it may not work
as you expect it to. Source trees from chapter 5 will have your host
distribution's settings, which don't always apply to the LFS system
after you enter the chroot'ed environment. Even running something like
<emphasis>make clean</emphasis> doesn't always guarantee a clean source
tree.</para>
<para>So, save yourself a lot of hassle and just remove the source directory
immediately after you have installed it.</para>