From c035712175aec19a56894f0ef675dbce4be7939e Mon Sep 17 00:00:00 2001 From: bdubbs Date: Sun, 29 Mar 2020 20:04:31 +0000 Subject: [PATCH] Textual updates thanks to Kevin Buckley. git-svn-id: svn://svn.linuxfromscratch.org/LFS/trunk/BOOK@11800 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689 --- chapter01/changelog.xml | 9 ++++++++ chapter04/settingenviron.xml | 49 +++++++++++++++++++++++++++++++++++++++++--- chapter05/dejagnu.xml | 5 +++-- chapter05/expect.xml | 11 ++++++++-- chapter05/tcl.xml | 4 +++- general.ent | 6 +++--- 6 files changed, 73 insertions(+), 11 deletions(-) diff --git a/chapter01/changelog.xml b/chapter01/changelog.xml index 8fc5d7860..dcf0325b2 100644 --- a/chapter01/changelog.xml +++ b/chapter01/changelog.xml @@ -42,6 +42,15 @@ or as appropriate for the entry or if needed the entire day's listitem. --> + + 2020-03-29 + + + [bdubbs] - Textual updates thanks to Kevin Buckley. + + + + 2020-03-19 diff --git a/chapter04/settingenviron.xml b/chapter04/settingenviron.xml index 3221bed85..512d30d10 100644 --- a/chapter04/settingenviron.xml +++ b/chapter04/settingenviron.xml @@ -32,8 +32,8 @@ EOF ensuring a clean environment. The new instance of the shell is a non-login - shell, which does not read the /etc/profile or - .bash_profile files, but rather reads the + shell, which does not read, and execute, the conten of /etc/profile or + .bash_profile files, but rather reads, and executes, the .bashrc file instead. Create the .bashrc file now: @@ -47,6 +47,12 @@ PATH=/tools/bin:/bin:/usr/bin export LFS LC_ALL LFS_TGT PATH EOF + + The meaning of the command line options in <filename>.bashrc</filename> + + + set +h + The set +h command turns off bash's hash function. Hashing is ordinarily a useful feature—bash uses a hash table to remember the @@ -58,33 +64,70 @@ EOF $LFS/tools as soon as they are available without remembering a previous version of the same program in a different location. + + + + umask 022 + Setting the user file-creation mask (umask) to 022 ensures that newly created files and directories are only writable by their owner, but are readable and executable by anyone (assuming default modes are used by the open(2) system call, new files will end up with permission mode 644 and directories with mode 755). + + + + LFS=/mnt/lfs + The LFS variable should be set to the chosen mount point. + + + + LC_ALL=POSIX + The LC_ALL variable controls the localization of certain programs, making their messages follow the conventions of a specified country. Setting LC_ALL to POSIX or C (the two are equivalent) ensures that everything will work as expected in the chroot environment. + + + + LFS_TGT=(uname -m)-lfs-linux-gnu + The LFS_TGT variable sets a non-default, but compatible machine description for use when building our cross compiler and linker and when cross compiling our temporary toolchain. More information is contained in . + + + + PATH=/tools/bin:/bin:/usr/bin + By putting /tools/bin ahead of the standard PATH, all the programs installed in are picked up by the shell immediately after their installation. This, combined with turning off hashing, limits the risk that old programs are used from the host when the same programs are available in - the chapter 5 environment. + the Chapter 5 environment. + + + + + export LFS LC_ALL LFS_TGT PATH + + While the above commands have set some variables, in order + to make them visible within any sub-shells, we export them + + + + Finally, to have the environment fully prepared for building the temporary tools, source the just-created user profile: diff --git a/chapter05/dejagnu.xml b/chapter05/dejagnu.xml index bae0ed7d9..a821e9bba 100644 --- a/chapter05/dejagnu.xml +++ b/chapter05/dejagnu.xml @@ -23,8 +23,9 @@ - <para>The DejaGNU package contains a framework for testing other - programs.</para> + <para>The <application>DejaGnu</application> package contains a framework for running test + suites on GNU tools. It is written in <command>expect</command>, which itself + uses <application>Tcl</application> (Tool Command Language).</para> <segmentedlist> <segtitle>&buildtime;</segtitle> diff --git a/chapter05/expect.xml b/chapter05/expect.xml index ae6f50026..a2cc67d0e 100644 --- a/chapter05/expect.xml +++ b/chapter05/expect.xml @@ -23,8 +23,15 @@ <sect2 role="package"> <title/> - <para>The Expect package contains a program for carrying out scripted - dialogues with other interactive programs.</para> + <para>The <application>Expect</application> package contains tools for + automating, via scripted dialogues, interactive applications such as + <command>telnet</command>, <command>ftp</command>, + <command>passwd</command>, <command>fsck</command>, + <command>rlogin</command>, and <command>tip</command>. + <application>Expect</application> is also useful for testing these same + applications as well as easing all sorts of tasks that are prohibitively + difficult with anything else. The <application>DejaGnu</application> + framework is written in <application>Expect</application>.</para> <segmentedlist> <segtitle>&buildtime;</segtitle> diff --git a/chapter05/tcl.xml b/chapter05/tcl.xml index a186e0fde..f2265fd8d 100644 --- a/chapter05/tcl.xml +++ b/chapter05/tcl.xml @@ -23,7 +23,9 @@ <sect2 role="package"> <title/> - <para>The Tcl package contains the Tool Command Language.</para> + <para>The <application>Tcl</application> package contains the Tool Command Language, + a robust general-purpose scripting language. The <application>Expect</application> package + is written in the <application>Tcl</application> language.</para> <segmentedlist> <segtitle>&buildtime;</segtitle> diff --git a/general.ent b/general.ent index f8ae867aa..99ec601f1 100644 --- a/general.ent +++ b/general.ent @@ -1,13 +1,13 @@ -<!ENTITY version "SVN-20200319"> +<!ENTITY version "SVN-20200329"> <!ENTITY short-version "svn"> <!-- Used below in &blfs-book; Change to x.y for release but not -rc releases --> <!ENTITY generic-version "development"> <!-- Use "development" or "x.y[-pre{x}]" --> -<!ENTITY versiond "20200319-systemd"> +<!ENTITY versiond "20200329-systemd"> <!ENTITY short-versiond "systemd"> <!ENTITY generic-versiond "systemd"> -<!ENTITY releasedate "March 19th, 2020"> +<!ENTITY releasedate "March 29th, 2020"> <!ENTITY copyrightdate "1999-2020"><!-- jhalfs needs a literal dash, not – --> -- 2.11.4.GIT