/** README.GRUB                                   **                                                               ** Original Author: Kasper Verdich Lund                          ** Date: 10/11-99      **  ** Description: ** Basic explanation of how to boot Apostle using GRUB      **                                        ** Revision History: ** First Draft 10.16.99 J Spencer Seidel  ** First version      ** 0.0.1 10-11-99 Kasper Verdich Lund - (no comments) ** 0.0.2 10-20-99 Guido de Jong **  - GRUB install elaborated to make it more fool proof ** ** This program is free software, you can redistribute it and/or ** modify it under the terms of the GNU General Public License   ** as published by the Free Software Foundation; either version  ** 2 of the License, or (at your option) any later version.      **                                                               ** This program is distributed in the hope that it will be       ** useful, but WITHOUT ANY WARRANTY; without even the implied    ** warranty or MERCHANTABILITY or FITNESS FOR A PARTICULAR       ** PURPOSE.  See the GNU General Public License for more        ** details.                                                      **                                                               ** You should have received a copy of the GNU General Public     ** License along with this program; if not, write to the         ** Free Software Foundation, Inc., 59 Temple Place, Suite 330,   ** Boston, MA 02111-1307 USA                                     **                                                               *********************************************************Apostle OS**/1. Obtaining GRUB=================You can get a copy of GRUB from http://www.gnu.org/software/grub/grub.en.html2. Compiling GRUB=================To compile GRUB, please consult the documentation which came with theGRUB sources.3. Installing GRUB==================To install GRUB onto a floppy disk, see "4. Booting Using Grub". 4. Booting Using GRUB=====================There are 2 ways to boot Apostle. If you have GRUB installed on yoursystem already, you'll find it convenient to add the Apostle Operating System to your "menu.lst" file:	# Apostle Operating System	title= Apostle Operating System	kernel= (hd0,0)/apostle/boot/apostle***NOTE***"(hd0,0)" tells grub that Apostle is located on the first partition of your first hard drive.  If Apostle is located elsewhere, it willbe necessary to change this string to reflect the location ofthe Apostle binaries.	Ex. If Apostle is located on the 2cd partition of your 	second hard drive, use "(hd1,1)"**********If you want to make a bootable floppy, you'll need 2 floppies - oneshould be FAT formatted and the other blank.  Then follow these steps:1) Build the Apostle binaries by entering the "apostle" directoryand typing "make all".2) Make sure that the binaries were created (you should see "init"and "kernel" in the apostle/boot directory).3) Create a text file called "menu.lst" and enter the followinginformation:	# Sample boot menu configuration file                                 # Boot automatically after 5 secs.        timeout= 5        # By default, boot the first entry.        default= 0        # Boot kernel called apostle        title=  Apostle Operating System        root=   (fd0)           kernel= (fd0)/apostle4) Copy "menu.lst", "init" and "kernel" onto the root directoryof your formatted floppy. Optionally you could also copy the grubbinaries onto your fotmatted floppy ("stage1" and "stage2").5) Now you must copy the grub binaries onto the blank floppy.	In Linux use: 		dd if="stage1" of="/dev/fd0" bs=512 count=1        	dd if="stage2" of="/dev/fd0" bs=512 seek=1	In DOS you can use (I haven't tested this): 		copy /B stage1+stage2 boot.sct	You must now use a utility that can copy boot.sct to	the first sectors of the blank floppy.  "rawrite" is	one such utility and is available here:		http://uranus.it.swin.edu.au/~jn/linux6) Boot your test PC using the floppy from the last step.7) Swap floppies.8) At the GRUB prompt, type the following:	grub> root = (fd0)        grub> install = /stage1 (fd0) /stage2 0x8000 p /menu.lstNow this command will give an error if you haven't copied thegrub binaries onto your formatted floppy.  In that case you haveto specify the complete path to "stage1" and "stage2".  E.g.:	grub install = (hd0,0)/apostle/grub/stage1 (fd0) \		(hd0,0)/apostle/grub/stage2 0x8000 p /menu.lst9) You're done!  Just reboot using the formatted floppy.Now, when you build a new version of the Apostle binaries, yousimply need to copy them onto the formatted floppy.  If youcopied the grub binaries to your formatted floppy, you might want to remove them.  They're not needed anymore.