GRUB documentation

[Jeremy Dawson]

Dear GRUB maintainers,

In the man page I have it says

grub-install copies GRUB images into the DIR/boot directory specfied by
      --root-directory, and uses the grub shell to install grub into 
the boot
      sector.

(the man page version is grub-install (GNU GRUB 0.97)      April 2006   
)              

In the info pages (at 
http://www.gnu.org/software/grub/manual/html_node/Installing-GRUB-using-grub_002dinstall.html#Installing-GRUB-using-grub_002dinstall

it says

ou need to run grub-install like this:

    # grub-install --root-directory=/boot /dev/hda

This would seem to suggest that images get installed in /boot/boot .  Is 
this they way it is meant to be ?

Thanks,

Jeremy Dawson

PS I think one of my main difficulties with the GRUB documentation 
(which could be easily fixed) is that the word "install" is used for two 
totally different things, and is often ambiguous

Thus, in the man page

grub-install copies GRUB images into the DIR/boot directory specfied by
      --root-directory, ...(A)

and uses the grub shell to install grub into the boot sector. ...(B)


But in the info pages 
(http://www.gnu.org/software/grub/manual/html_node/Installation.html#Installation)

In order to install GRUB as your boot loader, you need to first install 
the GRUB system and utilities under your UNIX-like operating system (see 
Obtaining and Building GRUB 
<http://www.gnu.org/software/grub/manual/html_node/Obtaining-and-Building-GRUB.html#Obtaining-and-Building-GRUB>). 
You can do this either from the source tarball, or as a package for your 
OS.

(this is (A), as I understand it)

After you have done that, you need to install the boot loader on a drive 
(floppy or hard disk)

(this is (B), as I understand it)

But then it goes on to say
There are two ways of doing that - either using the utility grub-install 
(see Invoking grub-install 
<http://www.gnu.org/software/grub/manual/html_node/Invoking-grub_002dinstall.html#Invoking-grub_002dinstall>) 
on a UNIX-like OS

but according to the man page, grub-install does (A) and (B)

regards,

Jeremy Dawson