grub-install documentation is truncated or too succint

Bug #1479516 reported by Etienne URBAH
6
This bug affects 1 person
Affects Status Importance Assigned to Milestone
grub2 (Ubuntu)
Won't Fix
Low
Unassigned

Bug Description

Concerning the documentation for 'grub-install' :

Inside 'grub.info.gz' :
- Thank you very much for chapter '4.1 Installing GRUB using grub-install' : This really provides useful information.
- But chapter '23 Invoking grub-install' is regrettably truncated : It mentions only options --help, --version, --boot-directory, --recheck and --no-rs-codes.

Inside the 'Manual page grub-install(8)' :
- Many options are listed, but the description is much too succinct to be useful.
- The whole text between 'grub-install [OPTION...] [OPTION] [INSTALL_DEVICE]' and '-s, --skip-fs-probe do not probe for filesystems in DEVICE' is duplicated.

Can you describe all 'grub-install' options into 'grub.info.gz' ?
Can you fully replicate this information in the 'Manual page grub-install(8)' ?
Thank you in advance.

ProblemType: Bug
DistroRelease: Ubuntu 15.04
Package: grub2-common 2.02~beta2-22ubuntu1.1
Uname: Linux 4.0.0-040000-generic x86_64
ApportVersion: 2.17.2-0ubuntu1.1
Architecture: amd64
CurrentDesktop: X-Cinnamon
Date: Wed Jul 29 21:45:12 2015
InstallationDate: Installed on 2015-07-20 (9 days ago)
InstallationMedia: Ubuntu-GNOME 15.04 "Vivid Vervet" - Release amd64 (20150422)
SourcePackage: grub2
UpgradeStatus: No upgrade log present (probably fresh install)

Revision history for this message
Etienne URBAH (eurbah) wrote :
Etienne URBAH (eurbah)
tags: added: wily
Revision history for this message
Etienne URBAH (eurbah) wrote :

This bug is still present in grub2 version 2.02~beta2-26ubuntu5 from 'Ubuntu 15.10 Wily Beta1'.

Revision history for this message
Etienne URBAH (eurbah) wrote :

This bug is still present in grub2 version 2.02~beta2-28 from 'Ubuntu 15.10 Wily Beta2'.

Revision history for this message
Etienne URBAH (eurbah) wrote :

This bug is still present in grub2 version 2.02~beta2-29ubuntu0.2 from 'Ubuntu 15.10 Wily'.

Revision history for this message
Etienne URBAH (eurbah) wrote :

This bug is still present in grub2 version 2.02~beta2-29ubuntu0.3 from 'Ubuntu 15.10 Wily'.

Revision history for this message
Etienne URBAH (eurbah) wrote :

This bug is still present in grub2 version 2.02~beta2-36 from 'Ubuntu 16.04 Xenial Beta1'.

tags: added: xenial
Revision history for this message
Etienne URBAH (eurbah) wrote :

This bug is still present in grub2 version 2.02~beta2-36ubuntu10 from 'Ubuntu 16.10 Yakkety Beta1'.

Revision history for this message
Etienne URBAH (eurbah) wrote :

This bug is still present in grub2 version 2.02~beta2-36ubuntu11 from 'Ubuntu 16.10 Yakkety'.

Revision history for this message
Etienne URBAH (eurbah) wrote :

This bug is still present in grub2 version 2.02~beta3-3ubuntu2 from 'Ubuntu 17.04 Zesty Beta2'.

Revision history for this message
Etienne URBAH (eurbah) wrote :

This bug is still present in grub2 version 2.02~beta3-4ubuntu6 from 'Kubuntu 17.10 Artful Beta1'.

Revision history for this message
Etienne URBAH (eurbah) wrote :

This bug is still present in grub2 version 2.02~beta3-4ubuntu7 from 'Ubuntu 17.10 Artful'

Revision history for this message
Etienne URBAH (eurbah) wrote :

This bug is still present in grub2 version 2.02-2ubuntu8 from 'Kubuntu 18.04 Bionic Beta1'

tags: added: bionic
Etienne URBAH (eurbah)
tags: added: artfull xenia
removed: xenial
tags: added: artful
removed: artfull
tags: added: xenial
removed: xenia
Revision history for this message
Etienne URBAH (eurbah) wrote :

This bug is still present in grub2 version 2.02+dfsg1-12ubuntu2 from 'Ubuntu 19.04 Disco Dingo'

tags: added: cosmic disco
Revision history for this message
Etienne URBAH (eurbah) wrote :

This bug is still present in grub2 version 2.04-1ubuntu6 from 'Ubuntu 19.10 Eoan Ermine Beta'

tags: added: eoan
Revision history for this message
Etienne URBAH (eurbah) wrote :

This bug is still present in grub2 version 2.04-1ubuntu22 from 'Ubuntu 20.04 Focal Fossa Beta'

tags: added: focal
Revision history for this message
Etienne URBAH (eurbah) wrote :

This bug is still present in grub2 version 2.04-1ubuntu34 from 'Ubuntu 20.10 Groovy Gorilla Beta'

tags: added: groovy
Revision history for this message
Etienne URBAH (eurbah) wrote :

This bug is still present in grub2 version 2.04-1ubuntu35.4 from 'Ubuntu 20.10 Groovy Gorilla'

Etienne URBAH (eurbah)
tags: added: jammy
Revision history for this message
Etienne URBAH (eurbah) wrote :

This bug is still present in grub2 version 2.06-2ubuntu7 from 'Ubuntu 22.04 Jammy Jellyfish'

Revision history for this message
Julian Andres Klode (juliank) wrote :

I suggest raising this upstream at https://savannah.gnu.org/bugs/?group=grub

Revision history for this message
Etienne URBAH (eurbah) wrote :
Etienne URBAH (eurbah)
tags: added: kinetic
Revision history for this message
Steve Langasek (vorlon) wrote :

I don't agree that there any deficiencies in the manpage, all of the option descriptions make sense to me. But even if they don't, this should be fixed upstream and you've already opened a bug there so I don't think it's useful to also track this issue in Ubuntu. Closing wontfix. Thanks!

Changed in grub2 (Ubuntu):
importance: Undecided → Low
status: New → Won't Fix
To post a comment you must log in.
This report contains Public information  
Everyone can see this information.

Other bug subscribers

Remote bug watches

Bug watches keep track of this bug in other bug trackers.