aboutsummaryrefslogtreecommitdiffstats
path: root/chapter03
diff options
context:
space:
mode:
authorXi Ruoyao <xry111@mengyan1223.wang>2022-02-22 13:34:59 +0800
committerXi Ruoyao <xry111@mengyan1223.wang>2022-02-22 13:34:59 +0800
commit188fba74b44708940c9cc40a0fe3ae438c69089f (patch)
treefb4b5a7574904291852f4b55cbd11875eecc1019 /chapter03
parent25dc9a8cfa7687a40a5e4c3467b32bc0f2d89b77 (diff)
ch03 intro: "newer version" -> "different version", and ...
warn about the difference between release tarballs and repo snapshots
Diffstat (limited to 'chapter03')
-rw-r--r--chapter03/introduction.xml13
1 files changed, 11 insertions, 2 deletions
diff --git a/chapter03/introduction.xml b/chapter03/introduction.xml
index ba7e16366..c0a89afac 100644
--- a/chapter03/introduction.xml
+++ b/chapter03/introduction.xml
@@ -13,12 +13,21 @@
<para>This chapter includes a list of packages that need to be downloaded in
order to build a basic Linux system. The listed version numbers correspond to
versions of the software that are known to work, and this book is based on
- their use. We highly recommend against using newer versions because the build
- commands for one version may not work with a newer version. The newest package
+ their use. We highly recommend against using different versions because the build
+ commands for one version may not work with a different version. The newest package
versions may also have problems that require work-arounds. These work-arounds
will be developed and stabilized in the development version of the
book.</para>
+ <para>For some packages, the release tarball and the (Git or SVN)
+ repository snapshot tarball for this release may be published with
+ similar file name. A release tarball contains generated files (for
+ example, <command>configure</command> script generated by
+ <command>autoconf</command>), in addition to the contents of the
+ corresponding repository snapshot. The book uses release tarballs
+ whenever possible. Using a repository snapshot instead of a release
+ tarball specified by the book will cause problems.</para>
+
<para>Download locations may not always be accessible. If a download
location has changed since this book was published, Google (<ulink
url="http://www.google.com/"/>) provides a useful search engine for