[Bug 1333801] [NEW] create a manpage for grub-install

[Karl-Philipp Richter]

Public bug reported:

The manpage of grub-install 2.02~beta2-9 is not yet ready to provide the
information which is necessary to use the program, assuming that one
should be able to work with the program after reading the manpage (`info
grub-install` provides some more information but it's still rather
incomplete). The review should include the resolution of the following
issues:

  * There's a difference between installing on a HDD with a msdos partition table and a GPT -> document or add hint that there's none (in case I experienced errornous error messages)
  * There's a different between BIOS and EFI installation -> document
  * Document all arguments which are supported for legacy reasons (some of them do something, e.g. `--root-directory` break the installation) (see also https://answers.launchpad.net/ubuntu/+source/grub2/+question/246173)
  * some arguments seem to require environment variables to be set (maybe only legacy arguments) -> document
  * some arguments seem to require flags on partitions to be set, e.g. `bios_boot` -> document

** Affects: grub2 (Ubuntu)
     Importance: Undecided
         Status: New

-- 
You received this bug notification because you are a member of Ubuntu
Foundations Bugs, which is subscribed to grub2 in Ubuntu.
https://bugs.launchpad.net/bugs/1333801

Title:
  create a manpage for grub-install

Status in “grub2” package in Ubuntu:
  New

Bug description:
  The manpage of grub-install 2.02~beta2-9 is not yet ready to provide
  the information which is necessary to use the program, assuming that
  one should be able to work with the program after reading the manpage
  (`info grub-install` provides some more information but it's still
  rather incomplete). The review should include the resolution of the
  following issues:

    * There's a difference between installing on a HDD with a msdos partition table and a GPT -> document or add hint that there's none (in case I experienced errornous error messages)
    * There's a different between BIOS and EFI installation -> document
    * Document all arguments which are supported for legacy reasons (some of them do something, e.g. `--root-directory` break the installation) (see also https://answers.launchpad.net/ubuntu/+source/grub2/+question/246173)
    * some arguments seem to require environment variables to be set (maybe only legacy arguments) -> document
    * some arguments seem to require flags on partitions to be set, e.g. `bios_boot` -> document

To manage notifications about this bug go to:
https://bugs.launchpad.net/ubuntu/+source/grub2/+bug/1333801/+subscriptions