Upldated to the new module sections.

doc/html/index.html

@@ -38,8 +38,8 @@ continue &quot;OK&quot; or stop &quot;Cancel&quot;.</P>
 
 <p>
 The <u>first row</u> presently has only one Boot Method choice:
-"2 disk compression."&nbsp;&nbsp
+"2 disk compression."&nbsp;&nbsp;Clicking on the menu on the right selects 
-Clicking on the menu on the right selects the Boot Method.</p>
+the Boot Method.</p>
 
 
 <P>The <u>second row</u> allows you to select the kernel for the Boot/Root set.&nbsp;&nbsp;You 
@@ -58,8 +58,8 @@ provided in the Advanced Root Section.
 device is the first floppy disk - /dev/fd0.</P>
 
 <p>
-The <u>fifth row</u> allows you to choose the size of the device being used. &nbsp;&nbsp;
+The <u>fifth row</u> allows you to choose the size of the device being used.&nbsp;&nbsp;The default size of 1440 assumes you are using a floppy drive 
-The default size of 1440 assumes you are using a floppy drive (Note: You may 
+(Note: You may 
 want to experiment with 1722 which works fine with many floppy drives.), but
 can be used with other sized devices like tape drives.&nbsp;&nbsp;Click on the 
 appropriate radio button to choose either gzip or bzip2 compression if the 
@@ -71,8 +71,8 @@ program doesn't automatically detect it.</p>
 The <u>slider bar</u> on the right allows the output of the verbosity box 
 to be 
 changed from the highest (2) to the lowest setting (1) or to be turned off (0)
-or on again.&nbsp;&nbsp;
+or on again.&nbsp;&nbsp;At times it may be advantageous to turn off the 
-At times it may be advantageous to turn off the verbosity box 
+verbosity box 
 since large quantities of output to this box may cause gbootroot to use too 
 much cpu power; however, output may still be found in the text file "verbose" 
 in /tmp/gbootroot_tmp'time-date'.</p>
@@ -84,9 +84,11 @@ Using the Advanced Boot Section</b></p>
 
 <p><IMG ALT="" SRC="images/ABS.jpg" align="right">
 
-"Stripping"&nbsp;&nbsp;  On by default for libraries and binaries.&nbsp;&nbsp;  The stripping 
+Libraries & Binaries & Modules check boxes:&nbsp;&nbsp;Turn off and on the 
+stripping of symbols.&nbsp;&nbsp;The stripping 
 behavior for libraries may be changed by clicking on the right mouse button 
-to change from --strip-debug to --strip-all.</p>
+to change --strip-debug to --strip-all.&nbsp;&nbsp;Binaries default to
+--strip-all and Modules default to --strip-debug.</p>
 
 <p>
 
@@ -98,37 +100,49 @@ on the actual boot device.</p>
 <p>
 
 "Opt. Device"&nbsp;&nbsp;Add devices to the boot disk which are necessary for the
-kernel to function properly.&nbsp;&nbsp;  
+kernel to function properly.&nbsp;&nbsp;Put a space between each 
-Put a space between each device.&nbsp;&nbsp;  
+device.&nbsp;&nbsp;For instance, /dev/fb0 for frame buffer devices.</p>
-For instance, /dev/fb0 for frame buffer devices.</p>
+
+<p>
+
+"append ="&nbsp;&nbsp;Add append options to brlilo.conf.&nbsp;&nbsp;If you are using a frame
+buffer device you could add something like video=matrox:vesa:402,depth:16.</p>
 
 <p>
 
 "Kernel Module"&nbsp;&nbsp;Add the modules found in 
 /lib/modules/kernel-version which are necessary for the Boot Method to work
-properly.&nbsp;&nbsp;
+properly.&nbsp;&nbsp;If these modules aren't found in the modules directory 
-If these modules aren't found in the modules directory it is assumed 
+it is assumed 
-that they either are in the kernel or they do not exist.&nbsp;&nbsp; 
+that they either are in the kernel or they do not exist.&nbsp;&nbsp;In the 
-In the case of 2 disk compression, floppy needs to be included in the 
+case of 2 disk compression, floppy needs to be included in the 
-kernel or included as a module. &nbsp;&nbsp; 
+kernel or included as a module. &nbsp;&nbsp;Kmod inserts the modules, and 
-Kmod inserts the modules, and kmod needs to be built into the kernel along
+kmod needs to be built into the kernel along
-with initrd and ramdisk.",</p>
+with initrd and ramdisk."</p>
 
 <p>
 
-"append ="&nbsp;&nbsp;  Add append options to brlilo.conf.&nbsp;&nbsp;  If you are using a frame
+"Kernel Version"&nbsp;&nbsp;Override the kernel version number found in the
-buffer device you could add something like video=matrox:vesa:402,depth:16.</p>
+kernel header.&nbsp;&nbsp;This will change the /lib/modules/kernel-version
+directory.</p>
 
-<br><br><br><br><br><br><br><br><br>
+<p>
+
+System.map:&nbsp;&nbsp;When a non-running kernel is chosen it is important 
+to include a copy of that kernel's System.map file so that depmod can use 
+the correct set of kernel symbols to resolve kernel references in each 
+module.&nbsp;&nbsp;This can be found in the kernel's source code after 
+compilation.
+
+<br><br><br><br><br><br><br>
 
 <P align="center">
 <b>Using the Advanced Root Section</b></P>
 <p><IMG ALT="" SRC="images/ARS.jpg" align="right">
 
-"Root Device"&nbsp;&nbsp;  
+"Root Device"&nbsp;&nbsp;This is the device used for the root filesystem when 
-This is the device used for the root filesystem when 
+constructing the Boot/Root set.&nbsp;&nbsp;You may choose a device which is 
-constructing the Boot/Root set.&nbsp;&nbsp; 
+different 
-You may choose a device which is different 
 than the Boot device, but presently only floppy devices are supported.</p>
 
 <p>
@@ -137,23 +151,21 @@ than the Boot device, but presently only floppy devices are supported.</p>
 
 <p>
 
-"Root Filename"&nbsp;&nbsp;
+"Root Filename"&nbsp;&nbsp;The name give to the root filesystem when 
- The name give to the root filesystem when initially made
+initially made in the temporary creation location.&nbsp;&nbsp;The save 
-in the temporary creation location.&nbsp;&nbsp;
+button allows the creation to
-The save button allows the creation to
 be saved in the permanent default location when the 
 Accept button is pressed.</p>
 
 <p>
 
-"Filesystem Size"&nbsp;&nbsp;
+"Filesystem Size"&nbsp;&nbsp; Root Methods make the filesystem the size 
- Root Methods make the filesystem the size which is 
+which is specified here.</p>
-specified here.</p>
 
 <p>
 
-"Compression"&nbsp;&nbsp;
+"Compression"&nbsp;&nbsp;Off by default to allow user-mode-linux 
-Off by default to allow user-mode-linux testing.&nbsp;&nbsp; Turn on 
+testing.&nbsp;&nbsp;Turn on 
 compression when you are ready to use a Boot Method 
 which requires compression.</p>
 
@@ -163,8 +175,8 @@ which requires compression.</p>
 
 <p>
 
-"Template"&nbsp;&nbsp; The template associated with a Root Method.&nbsp;&nbsp;
+"Template"&nbsp;&nbsp;The template associated with a Root 
- Not all Root Methods
+Method.&nbsp;&nbsp;Not all Root Methods
 have templates.</p>
 
 <p>
@@ -173,19 +185,19 @@ have templates.</p>
 
 <p>
 
-"UML"&nbsp;&nbsp; Abbreviation for user-mode-linux. &nbsp;&nbsp;
+"UML"&nbsp;&nbsp;Abbreviation for user-mode-linux.&nbsp;&nbsp;This is a 
- This is a linux kernel which runs on
+linux kernel which runs on
 top of the host system's linux kernel and allows a you run a live root 
 filesystem.</p>
 
 <p>  
 
-"Accept"&nbsp;&nbsp; 
+"Accept"&nbsp;&nbsp;This accepts the created root filesystem if it is 
-This accepts the created root filesystem if it is found in the 
+found in the 
-temporary creation directory.  &nbsp;&nbsp;
+temporary creation directory.&nbsp;&nbsp;The UML box and the main section 
-The UML box and the main section will now 
+will now 
-reflect the path to this root filesystem. &nbsp;&nbsp;
+reflect the path to this root filesystem.&nbsp;&nbsp;You can now test with 
- You can now test with the UML 
+the UML 
 button or a put together a complete Boot/Root set with the Submit button.</p>
 
 <br><br><br><br><br><br><br>
@@ -203,12 +215,12 @@ devfs=nomount.</p>
 
 <p>
 
-"Root_Fs"&nbsp;&nbsp;Choose an uncompressed root filesystem.&nbsp;&nbsp;
+"Root_Fs"&nbsp;&nbsp;Choose an uncompressed root 
-Append with ubd?=.</p>
+filesystem.&nbsp;&nbsp;Append with ubd?=.</p>
 
 <p>
 
-"Abort"&nbsp;&nbsp; Abort user-mode-linux kernel processes.&nbsp;&nbsp;</p>
+"Abort"&nbsp;&nbsp;Abort user-mode-linux kernel processes.</p>
 
 
 <p><P align="center"><b>
@@ -217,31 +229,31 @@ About the Yard Box</b></p>
 <p><IMG ALT="" SRC="images/yard_box.jpg" align="center"></p>
 
 The Yard Box is a Root Method which is "Generated" from the Advanced Root
-Section after a Template is chosen.&nbsp;&nbsp;
+Section after a Template is chosen.&nbsp;&nbsp;It has several 
-It has several interesting features.
+interesting features.
 
 <p>
 
 The check boxes at the bottom represent the different stages involved in
-creating a root filesystem.&nbsp;&nbsp;
+creating a root filesystem.&nbsp;&nbsp;The behavior of these stages 
- The behavior of these stages may be altered in
+may be altered in
 three ways: Edit->Stages->one-by-one (default) will perform each stage
 sequentially, stopping between each stage, the user may continue the process
-by pressing the Continue button. &nbsp;&nbsp;
+by pressing the Continue 
-Edit->Stages->continuous proceeds non-stop
+button.&nbsp;&nbsp;Edit->Stages->continuous proceeds non-stop
-through all the stages.&nbsp;&nbsp;
+through all the 
-Edit->Stages->'user defined' allows the user to
+stages.&nbsp;&nbsp;Edit->Stages->'user defined' allows the user to
 choose any stages the user wants, and will then proceed through all the
-chosen stages.&nbsp;&nbsp;
+chosen 
-Choosing only 'Check', 'Links & Deps', 'Create" is a good 
+stages.&nbsp;&nbsp;Choosing only 'Check', 'Links & Deps', 'Create" is a good 
 example.</p>  
 
 <p><IMG ALT="" SRC="images/tests.jpg" align="center"></p>
 
 <p>
 
-The behavior of some of the stages may be altered.&nbsp;&nbsp; 
+The behavior of some of the stages may be 
-For instance Alt-T allows
+altered.&nbsp;&nbsp;For instance Alt-T allows
 you to choose which tests to run on the newly created 
 root filesystem.</p>
 
@@ -250,21 +262,19 @@ root filesystem.</p>
 <p>
 
 Press Alt-S to enable template text searching in either
-direction.&nbsp;&nbsp; 
+direction.&nbsp;&nbsp;Find exact matches or ignore case with 
-Find exact matches or ignore case with the case sensitive check
+the case sensitive check box.</p>
-box.</p>
 
 <p><IMG ALT="" SRC="images/file.jpg" align="center"></p>
 
 <p>
 
 Use Ctl-S to save the changes to an open template, and Alt-A to save the
-template with a new name.&nbsp;&nbsp;
+template with a new name.&nbsp;&nbsp;bOOTrOOT will not allow read-only 
-bOOTrOOT will not allow read-only templates or template links to be saved
+templates or template links to be saved
-with their own name.&nbsp;&nbsp; 
+with their own name.&nbsp;&nbsp;A few of these example files a
-A few of these example files are included.  &nbsp;&nbsp;
+re included.&nbsp;&nbsp;You may make changes to them or 
-You may make changes to them or clear their buffers.&nbsp;&nbsp;
+clear their buffers.&nbsp;&nbsp;Then you may save the template with a 
-Then you may save the template with a 
 different name.</p>
 
 <p><IMG ALT="" SRC="images/stripping.jpg" align="center"></p>
@@ -272,8 +282,8 @@ different name.</p>
 <p>
 
 Edit->Settings->Stripping allows you to turn off/on stripping for
-Libraries, Binaries, and Modules.&nbsp;&nbsp;
+Libraries, Binaries, and Modules.&nbsp;&nbsp;--strip-all is the 
---strip-all is the default for binaries and libraries, 
+default for binaries and libraries, 
 and --strip-debug is the default for modules; however libraries may 
 be changed to --strip-debug in the settings.</p>
 
@@ -291,8 +301,8 @@ environments $PATH variable.
 <p>
 
 Edit->'File System" may alter the type of filesystem used to make the root
-filesystem.&nbsp;&nbsp;  
+filesystem.&nbsp;&nbsp;Because the filesystem is 
-Because the filesystem is created on a loop device, some 
+created on a loop device, some 
 filesystem types may complain or not be created at all.</p>
 
 <p><IMG ALT="" SRC="images/replacements.jpg" align="center"></p>
@@ -307,8 +317,8 @@ an editor of your choice.
 
 <p>
 
-Create->Replacements creates special replacement files.&nbsp;&nbsp; 
+Create->Replacements creates special replacement 
-Presently it creates 
+files.&nbsp;&nbsp; Presently it creates 
 an fstab configuration file as Replacements/etc/fstab.new in 
 $HOME/.gbootroot/yard/.</p>
 
@@ -331,8 +341,8 @@ filesystem.</P>
 (Explanation from the first gbootroot.)<br>
 "You can use a bzip2 compressed filesystem, this program is easy to use, and 
 it provides a framework showing a simple initrd method which you can freely 
-modify.&nbsp;&nbsp;   
+modify.&nbsp;&nbsp;I wrote this program as an extension to BootRoot 
-I wrote this program as an extension to BootRoot which was written 
+which was written 
 as a solution to help oster at EE (www.experts-exchange.com) create separate 
 boot and root floppies for an emergency system for his customers."</P>
 
@@ -361,28 +371,31 @@ $HOME/.gbootroot/root_filesystems. </p>
 
 <p>
  
-3.&nbsp;&nbsp; Run gbootroot.&nbsp;&nbsp;  
+3.&nbsp;&nbsp;Run 
-Click on the Advanced Root Section, click on
+gbootroot.&nbsp;&nbsp;Click on the Advanced Root Section, click on
 the UML button. &nbsp;&nbsp;Select root_fs_tomrtbt_1.7.205, and click on the Submit
 button.</p>
 
 <p>
 
-4.&nbsp;&nbsp; Click on the Advanced Boot Section.&nbsp;&nbsp;
+4.&nbsp;&nbsp;Click on the Advanced Boot 
-Root_fs_tomrtbt is about 16M, so add ramdisk_size=16384 to
+Section.&nbsp;&nbsp;Root_fs_tomrtbt is about 16M, so add ramdisk_size=16384 to
-the 'append=' entry.  &nbsp;&nbsp;
+the 'append=' entry.&nbsp;&nbsp;From the main box choose '2 disk compression', and
-From the main box choose '2 disk compression', and
 press on the Root Filesystem button and select root_fs_tomrtbt_1.7.205.bz2.
 </p> 
 
-5.&nbsp;&nbsp; Click the Submit button on the main box.&nbsp;&nbsp;  
+5.&nbsp;&nbsp;Click the Submit button on the main 
-Have two floppy disks ready.
+box.&nbsp;&nbsp;Have two floppy disks ready.
 
 <p>
 
 6.&nbsp;&nbsp;When you see Lilo you may access the menu using [Ctrl] and 
 [Tab] to see the available images. 
 
+<p>
+
+7.
+
 <P><b>My root filesystem doesn't start in single mode when started like
 this:&nbsp;&nbsp&quot;bootdisk 1?&quot;</b></P>
 
@@ -397,9 +410,9 @@ Why on the subject, it should be pointed at the setting up init and its
 runlevels is one of the
 most challenging areas of creating a bootable root_fs.&nbsp;&nbspOften 
 your creation will only work with "single" until all the conflicts
-are resolved.&nbsp;&nbsp Things are complicated even futher by the fact that
+are resolved.&nbsp;&nbsp;Things are complicated even futher by the fact that
 devices can now be set up in two majors ways: tty? or ttys/? (devfs).
-&nbsp;&nbsp Fortunately, user-mode-linux comes in very handy for hunting
+&nbsp;&nbsp;Fortunately, user-mode-linux comes in very handy for hunting
 down all the bugs.
 
 
@@ -431,11 +444,13 @@ zeroing block 1600 at end of filesystem."</p>
 
 I understand Theodore Ts'o reasoning for doing this, but I strongly believe 
 that the old behavior was very useful for people creating 
-mini-distributions so I have issued Feature Request (#) at (here).&nbsp;&nbsp;
+mini-distributions so I have issued Feature Request (#) at 
-It should be noted that fdformat is an unacceptable solution because it tends
+(here).&nbsp;&nbsp;It should 
+be noted that fdformat is an unacceptable solution because it tends
 to be machine specific, and the original mke2fs behavior made floppies that
-worked everywhere.&nbsp;&nbsp;
+worked 
-Feel free to add your comments to the Feature Request.&nbsp;&nbsp; Thanks.</p>
+everywhere.&nbsp;&nbsp;Feel free 
+to add your comments to the Feature Request.&nbsp;&nbsp;Thanks.</p>
 
 <p>
 
@@ -450,7 +465,8 @@ This is because of the way Gtk works.&nbsp;&nbsp; There are two adjustments,
 step and page increments.&nbsp;&nbsp;When you press your first mouse button the step 
 has been set to 282 so that a person can easily switch between 1440 and 1722.  
 &nbsp;&nbsp;When you use your second mouse button the page is set at 360.  You can go 
-down to zero by pressing your third mouse button on the down arrow.&nbsp;&nbsp;  Now 
+down to zero by pressing your third mouse button on the 
+down arrow.&nbsp;&nbsp;Now 
 page up with the second button to 1440 and step with the first button to 
 1722.&nbsp;&nbsp;Pretty cool, eh?</p>