Re: grub-mkimage and other utils documentation

[Bruce Dubbs]

Andrey Borzenkov wrote:
> I started to clean --pubkey in docs, hit grub-mkimage reference, hit
> "grub-install is just a shell script" ... it really needs cleanup. Is
> grub-install terse description intentional? If not, I'm going to
> actually document all utilities and all options not defined as hidden.
> We probably need to mention common options between various utilities
> as well.
>
> Or should some tools be skipped? I'm fine to document them in
> grub-devel though, but I'd like to have them documented /somewhere/.

Things that can be run by a user or admin should be in the main 
documentation.  Those things run by a developer for 
building/testing/debugging, etc should be in grub-devel.

I'd put any program that is installed in the file system
/{,usr/}{,s}bin  directories in the category of admin.

  -- Bruce