diff --git a/appendixa/bash-desc.xml b/appendixa/bash-desc.xml index cf96fc4f7..489a43bbf 100644 --- a/appendixa/bash-desc.xml +++ b/appendixa/bash-desc.xml @@ -1,11 +1,8 @@ -Contents of Bash +Descriptions Last checked against version &bash-contversion;. -Program Files -bash, sh (link to bash) and bashbug - -Descriptions +ProgramfFiles descriptions bash bash is the Bourne-Again SHell, which is a widely used command diff --git a/appendixa/bash-shortdesc.xml b/appendixa/bash-shortdesc.xml new file mode 100644 index 000000000..9c195d277 --- /dev/null +++ b/appendixa/bash-shortdesc.xml @@ -0,0 +1,17 @@ +Contents of Bash + +Last checked against version &bash-contversion;. + +bash is the Bourne-Again SHell, which is a widely used command +interpreter on Unix systems. The bash program reads from standard +input, the keyboard. A user types something and the program will evaluate +what he has typed and do something with it, like running a +program. + +Bash installs the following files: + +Program Files +bash, sh (link to bash) and bashbug + + + diff --git a/appendixa/bash.xml b/appendixa/bash.xml index 8b7bad66a..52db7d404 100644 --- a/appendixa/bash.xml +++ b/appendixa/bash.xml @@ -3,6 +3,7 @@ &aa-bash-down; +&aa-bash-shortdesc; &aa-bash-desc; &aa-bash-dep; diff --git a/chapter05/bash-exp.xml b/chapter05/bash-exp.xml deleted file mode 100644 index ba7b375c1..000000000 --- a/chapter05/bash-exp.xml +++ /dev/null @@ -1,32 +0,0 @@ - -Command explanations - ---enable-static-link: This configure -option causes bash to be linked statically. - ---prefix=$LFS/static: This configure option -installs all of Bash's files under the $LFS/static directory, which becomes -the /static directory when chroot'ed or reboot'ed into LFS. - ---with-curses: This causes bash to be -linked against the curses library instead of the default termcap -library which is becoming obsolete. - -It is not strictly necessary for the static bash to be linked -against libncurses (it can link against a static termcap for the time -being just fine because we will reinstall Bash in Chapter 6 anyways, -where we will use libncurses), but it's a good test to make sure that -the Ncurses package has been installed properly. If not, you will get in -trouble later on in this chapter when you install the Texinfo package. -That package requires ncurses, and termcap can't reliably be used -there. - -The &&'s at the end of every line cause -the next command to be executed only if the previous command exits -with a return value of 0 indicating success. In case all of these -commands are copy & pasted on the shell, it is important to ensure -that if ./configure fails, make isn't executed and, likewise, if make -fails, that make install isn't executed, and so forth. - - - diff --git a/chapter05/bash-inst.xml b/chapter05/bash-inst.xml index 7283b50ae..08970350e 100644 --- a/chapter05/bash-inst.xml +++ b/chapter05/bash-inst.xml @@ -12,21 +12,56 @@ development package. This package is often called something like ncurses-dev or ncurses-static. If this package is already installed, or you just installed it, check for the two files again. Often the libcurses.a file is (still) -missing. If so, then create libcurses.a as a symlink -by running the following commands as user root: +missing. If so, create libcurses.a as a symlink +by running the following commands as user root: ln -s libncurses.a /usr/lib/libcurses.a -Now we can continue. Install Bash by running the following -commands: +Now we can really start. Prepare Bash to be compiled by running the +following command: + ./configure --enable-static-link \ -    --prefix=$LFS/static --with-curses && -make && -make install +    --prefix=$LFS/static --with-curses + +The meaning of the configure switches are: + + +--enable-static-link: This option +caused the bash program to be statically +linked. + +--prefix=$LFS/static This option +installs all of Bash's files under the $LFS/static directory, which becomes +the /static directory when chroot'ed or reboot'ed into +LFS. + +--with-curses: This option caused +bash to be linked against the curses library instead of the default termcap +library which is being phased out and has become obsolete. Note, on most +all Linux systems, the curses library is provided by the Ncurses +package (so in truth we link against the ncurses library). + +It is not strictly necessary for the static bash to be linked +against libncurses (it can link against a static termcap for the time +being just fine because we will reinstall Bash in Chapter 6 anyways, +where we will use libncurses), but it's a good test to make sure that +the Ncurses package has been installed properly. If not, you will get in +trouble later on in this chapter when you install the Texinfo package. +That package requires ncurses, and termcap can't reliably be used +there. + + +Now we can continue compiling Bash: + +make + +And finish off the installation by installing Bash: + +make install If the make install phase ends with something -along the lines of this: +along the lines of the following:
install-info: unknown option `--dir-file=/mnt/lfs/usr/info/dir' usage: install-info [--version] [--help] [--debug] [--maxwidth=nnn] @@ -40,11 +75,11 @@ make[1]: Leaving directory `/mnt/lfs/usr/src/bash-&bash-version;/doc' make: [install] Error 2 (ignored)
then that means that you are probably using Debian-2.2 (potato), and -that you have an old version of the texinfo package. This error is not -severe by any means: the info pages will be installed when we recompile bash -dynamically in Chapter 6, so you can ignore it. It is reported that the -current release of Debian (3.0; also known as Woody) doesn't have this -problem. +that you have an old version of the texinfo package and the info pages +can't be installed at this time. This error is not a problem as the info +pages will be installed when we recompile bash dynamically in Chapter 6, so +you can ignore it. It is reported that the current release of Debian +(3.0; also known as Woody) doesn't have this problem. diff --git a/chapter05/bash.xml b/chapter05/bash.xml index fce1614ef..2c102e39b 100644 --- a/chapter05/bash.xml +++ b/chapter05/bash.xml @@ -5,10 +5,9 @@ Estimated build time: &bash-time-static; Estimated required disk space: &bash-compsize-static; -&c5-bash-inst; -&c5-bash-exp; -&aa-bash-desc; +&aa-bash-shortdesc; &aa-bash-dep; +&c5-bash-inst; diff --git a/chapter06/glibc.xml b/chapter06/glibc.xml index a2160fbeb..5567defe8 100644 --- a/chapter06/glibc.xml +++ b/chapter06/glibc.xml @@ -2,9 +2,7 @@ Installing Glibc-&glibc-version; -Download location: -Download location (patch): -Estimated build time: &glibc-time; +Estimated build time: &glibc-time; Estimated required disk space: &glibc-compsize; &aa-glibc-shortdesc; diff --git a/entities/bash.ent b/entities/bash.ent index 7c31f6a40..eb0bce22f 100644 --- a/entities/bash.ent +++ b/entities/bash.ent @@ -8,6 +8,7 @@ + diff --git a/index.xml b/index.xml index 2e904f625..c8e87eaff 100644 --- a/index.xml +++ b/index.xml @@ -4,8 +4,8 @@ - - + +