Context Navigation

r978d0bf	r3a788f0c
11	11	<para>Now prepare Bash for compilation:</para>
12	12
13		<para><screen><userinput>./configure --prefix=/tools ~~--with-curses~~</userinput></screen></para>
	13	<para><screen><userinput>./configure --prefix=/tools</userinput></screen></para>
14	14
15	15	<para>Compile the program:</para>

chapter05/binutils-pass1-inst.xml

-              r978d0bf
+              r3a788f0c
 configure script to prepare to install the Binutils programs in the
 <filename>/tools</filename> directory.</para></listitem>
 <listitem><para><userinput>--disable-nls</userinput>: This disables
 internationalization (a word often shortened to i18n). We don't need this
 …
 <itemizedlist>
 <listitem><para><userinput>-C ld clean</userinput>: This tells the make program
 to remove all the compiled files only in the <filename>ld</filename>
+to remove all the compiled files, but only in the <filename>ld</filename>
 subdirectory.</para></listitem>
 …
 rebuilds everything in the <filename>ld</filename> subdirectory. Specifying the
 LIB_PATH makefile variable on the command line allows us to override the default
+value and have it point to our temporary tools location. This preparation will
+be utilised later on in the chapter.</para></listitem>
+value and have it point to our temporary tools location. The value of this
+variable specifies the linker's default library search path. You'll see how this
+preparation is utilised later on in the chapter.</para></listitem>
 </itemizedlist>

-              r978d0bf
+              r3a788f0c
 <para><screen><userinput>../binutils-&binutils-version;/configure --prefix=/tools \
 &nbsp;&nbsp;&nbsp;&nbsp;--enable-shared --with-lib-path=/tools/lib</userinput></screen></para>
+<para>The meaning of the new configure option:</para>
+<itemizedlist>
+<listitem><para><userinput>--with-lib-path=/tools/lib</userinput>: This tells
+the configure script to specify the default library search path. We don't want
+the library search path to contain library directories from the host
+system.</para></listitem>
+</itemizedlist>
 <para>Before starting to build Binutils, remember to unset any environment

-              r978d0bf
+              r3a788f0c
 <para><screen><userinput>make RUN_EXPENSIVE_TESTS=yes check</userinput></screen></para>
+<para>The meaning of the make option:</para>
+<itemizedlist>
+<listitem><para><userinput>RUN_EXPENSIVE_TESTS=yes</userinput>: This tells the
+test suite to run several additional tests that are considered relatively
+expensive on some platforms. Hovever, they are generally not a problem on
+Linux.</para></listitem>
+</itemizedlist>
 <para>And install the package:</para>
 <para><screen><userinput>make install</userinput></screen></para>
 </sect2>

-              r978d0bf
+              r3a788f0c
 <para><screen><userinput>./configure --prefix=/tools --with-tcl=/tools/lib --with-x=no</userinput></screen></para>
+<para>The meaning of the configure options:</para>
+<itemizedlist>
+<listitem><para><userinput>--with-tcl=/tools/lib</userinput>: This ensures that
+the configure script finds the Tcl installation in our temporary tools location.
+We don't want it to find an existing one that may possibly reside on the host
+system.</para></listitem>
+<listitem><para><userinput>--with-x=no</userinput>: This tells the configure
+script not to search for Tk (the Tcl GUI component) or the X Window System
+libraries, both of which may possibly reside on the host system.</para></listitem>
+</itemizedlist>
 <para>Build the package:</para>

-              r978d0bf
+              r3a788f0c
 <para><screen><userinput>TZ=UTC make test</userinput></screen></para>
+<para>The meaning of the make option:</para>
+<itemizedlist>
+<listitem><para><userinput>TZ=UTC</userinput>: This sets the time zone to
+Coordinated Universal Time (UTC) also known as Greenwich Mean Time (GMT), but
+only for the duration of the test suite run. This ensures the clock tests are
+exercised correctly. More information on the TZ environment variable is
+available later on in Chapter 7.</para></listitem>
+</itemizedlist>
 <para>Sometimes, package test suites will give false failures.  You can
 consult the LFS Wiki at <ulink url="http://wiki.linuxfromscratch.org"/>
 …
 <para><screen><userinput>make install</userinput></screen></para>
 <para>Make a link:</para>
+<para>Make a necessary symbolic link:</para>
 <para><screen><userinput>ln -s tclsh8.4 /tools/bin/tclsh</userinput></screen></para>

-              r978d0bf
+              r3a788f0c
 <para>We need to create the <filename>/etc/nsswitch.conf</filename> file,
 because, although Glibc provides defaults when this file is missing or corrupt,
 the Glibc defaults don't work well with networking. Also, our timezone needs
+the Glibc defaults don't work well with networking. Also, our time zone needs
 to be set up.</para>
 …
 <userinput>EOF</userinput></screen></para>
 <para>To find out what timezone you're in, run the following script:</para>
+<para>To find out what time zone you're in, run the following script:</para>
 <para><screen><userinput>tzselect</userinput></screen></para>
 <para>When you've answered a few questions about your location, the script will
 output the name of your timezone, something like <emphasis>EST5EDT</emphasis>
+output the name of your time zone, something like <emphasis>EST5EDT</emphasis>
 or <emphasis>Canada/Eastern</emphasis>. Then create the
 <filename>/etc/localtime</filename> file by running:</para>
 …
 <para>Of course, instead of <emphasis>Canada/Eastern</emphasis>, fill in
 the name of the timezone that the <userinput>tzselect</userinput> script
+the name of the time zone that the <userinput>tzselect</userinput> script
 gave you.</para>

-              r978d0bf
+              r3a788f0c
 <para>Please note that unpacking the MAKEDEV-&makedev-version;.bz2 file
 doesn't create a directory for you to <userinput>cd</userinput> into, as
 the file contains one shell script.</para>
+the file only contains a single shell script.</para>
 <para>Install the MAKEDEV script:</para>
 …
 ./MAKEDEV -v generic-nopty</userinput></screen></para>
+<para>The meaning of the option:</para>
+<itemizedlist>
+<listitem><para><userinput>-v generic-nopty</userinput>: The
+<userinput>-v</userinput> parameter tells the MAKEDEV script to run in verbose
+mode. The <userinput>generic-nopty</userinput> parameter instructs MAKEDEV to
+create a generic selection of commonly used device special files, except for the
+ptyXX and ttyXX range of files. We don't need those files because we are going
+to use Unix98 PTYs via the <emphasis>devpts</emphasis> file
+system.</para></listitem>
+</itemizedlist>
 <para>If a device you need is missing, try running
 <userinput>./MAKEDEV -v &lt;device&gt;</userinput>. Alternatively, you may

-              r978d0bf
+              r3a788f0c
 <!ENTITY version "20030923">
 <!ENTITY releasedate "September 23rd, 2003">
+<!ENTITY version "20030924">
+<!ENTITY releasedate "September 24th, 2003">
 <!ENTITY nbsp " ">

Note: See TracChangeset for help on using the changeset viewer.