Re: [PATCH] document GRUB_DISABLE_SUBMENU

[Andrey Borzenkov <arvidjaar@gmail.com>]

[-- Attachment #1: Type: text/plain, Size: 2394 bytes --]

В Mon, 04 Nov 2013 17:09:15 +0100
Vladimir 'φ-coder/phcoder' Serbinenko <phcoder@gmail.com> пишет:

> On 04.11.2013 15:27, Andrey Borzenkov wrote:
> > В Mon, 04 Nov 2013 14:15:40 +0100
> > Vladimir 'φ-coder/phcoder' Serbinenko <phcoder@gmail.com> пишет:
> >> Could you add that toggling this requires changing default/GRUB_DEFAULT
> >> and saved default?
> >>
> >>
> > 
> > Like this?
> > 
> I think it should be "will" not "may". And also explicit mention of
> default, fallback, GRUB_DEFAULT and grub-reboot/grub-set-default with
> links would be helpful


Default won't need to be changed if it already refers to top-level menu
entry by ID or title (which does not change). Below is the best I could
come up with without making it exceedingly large.

From: Andrey Borzenkov <arvidjaar@gmail.com>
To: grub-devel@gnu.org
Subject: [PATCH] document GRUB_DISABLE_SUBMENU

Signed-off-by: Andrey Borzenkov <arvidjaar@gmail.com>

---
 docs/grub.texi | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/docs/grub.texi b/docs/grub.texi
index ead8fbd..58e04e2 100644
--- a/docs/grub.texi
+++ b/docs/grub.texi
@@ -1450,6 +1450,18 @@ Normally, @command{grub-mkconfig} will try to use the external
 systems installed on the same system and generate appropriate menu entries
 for them.  Set this option to @samp{true} to disable this.
 
+@item GRUB_DISABLE_SUBMENU
+Normally, @command{grub-mkconfig} will generate top level menu entry for
+the kernel with highest version number and put all other found kernels
+or alternative menu entries for recovery mode in submenu. For entries returned
+by @command{os-prober} first entry will be put on top level and all others
+in submenu. If this option is set to @samp{y}, flat menu with all entries
+on top level will be generated instead. Changing this option will require
+changing existing values of @samp{GRUB_DEFAULT}, @samp{fallback} (@pxref{fallback})
+and @samp{default} (@pxref{default}) environment variables as well as saved
+default entry using @command{grub-set-default} and value used with
+@command{grub-reboot}.
+
 @item GRUB_ENABLE_CRYPTODISK
 If set to @samp{y}, @command{grub-mkconfig} and @command{grub-install} will
 check for encrypted disks and generate additional commands needed to access
-- 
tg: (9612ebc..) u/grub_disable_submenu (depends on: master)

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 198 bytes --]