Bug#345931: Quote from documentation

[Kapil Hari Paranjape]

Hello,

On reading of this problem in using the grub "shell" setup command
instead of "grub-install" I looked through the documentation since I
was sure that it had asked me to copy the files.

Sure enough, under the node "Installation" in the grub info there is
the following paragraph:

           GRUB comes with boot images, which are normally put in
           the directory `/usr/lib/grub/i386-pc'. If you do not use
           grub-install, then you need to copy the files `stage1',
           `stage2', and `*stage1_5' to the directory `/boot/grub',
           ...

Unfortunately, this is from the info file which is in the package
"grub-doc". On the other hand the grub "shell" command has little to
hint about what needs to be done.

	grub> help setup

	setup: setup [--prefix=DIR] [--stage2=STAGE2_FILE] [--force-lba] INSTALL_DEVICE [IMAGE_DEVICE]
	    Set up the installation of GRUB automatically. This command uses
	    the more flexible command "install" in the backend and installs
	    GRUB into the device INSTALL_DEVICE. If IMAGE_DEVICE is
	    specified, then find the GRUB images in the device IMAGE_DEVICE,
	    otherwise use the current "root device", which can be set by the
	    command "root". If you know that your BIOS should support LBA but
	    GRUB doesn't work in LBA mode, specify the option `--force-lba'.
	    If you install GRUB under the grub shell and you cannot unmount
	    the partition where GRUB images reside, specify the option
	    `--stage2' to tell GRUB the file name under your OS.

Perhaps we could add some suitable text here which would resolve this
bug. For example, we could append the following:

	    WARNING: In order for this to work GRUB needs to find the images
	    "stage1" and "stage2" (or "stage1_5") corresponding to its
	    current version in the locations specified by INSTALL_DEVICE
	    (or IMAGE_DEVICE if specified or STAGE2_FILE if specified).

Regards,

Kapil.
--

-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: Digital signature
Url : http://lists.alioth.debian.org/pipermail/pkg-grub-devel/attachments/20060922/4d1aa1da/attachment-0001.pgp