From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from list by lists.gnu.org with archive (Exim 4.71) id 1TE13H-0001fO-0S for mharc-grub-devel@gnu.org; Tue, 18 Sep 2012 12:53:35 -0400 Received: from eggs.gnu.org ([208.118.235.92]:60044) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TE13A-0001W2-TV for grub-devel@gnu.org; Tue, 18 Sep 2012 12:53:33 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1TE139-0000aB-Ko for grub-devel@gnu.org; Tue, 18 Sep 2012 12:53:28 -0400 Received: from mail-lpp01m010-f41.google.com ([209.85.215.41]:58940) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TE139-0000Zv-D4 for grub-devel@gnu.org; Tue, 18 Sep 2012 12:53:27 -0400 Received: by lahd3 with SMTP id d3so44411lah.0 for ; Tue, 18 Sep 2012 09:53:26 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=message-id:subject:from:to:date:content-type:x-mailer:mime-version; bh=Dx9/Zz8gfn46F6gxwHdtwyiLQsmzfaJ9nNR7FMTvS3g=; b=pKcGEgkMipixzX3mA294UtZwSc4kf79vZ1k8VYRxgetvQYfs35C54G4rX/I/PqvqJP 4GKdGFyN3qCaHOLJEYSSIkA7BoRfljaEqV11gN1UB0M9v5Ee+tV4UhoqA7t0OFi0mvtH V8gjKWPYDiCy+oI8jgu5x4WWcwp5bTUpQW/0ui2Aw/oiyDL8BVs3To50x3q2P79jy1SP PqIB6BIaxj0KRBgxiylgVYQPZdwbwFd5CRwyN6GwZCy514M5noHHG4VbvpfvJjvwNGtf stIdi/OJ8YtP9mnZZBysHkf/yd+HoJNTBDtJ7ewFirf2fd8x4NAw4ZGc2MsZn+P+fJXO b8pg== Received: by 10.152.105.206 with SMTP id go14mr328197lab.37.1347987205838; Tue, 18 Sep 2012 09:53:25 -0700 (PDT) Received: from [192.168.10.142] (ppp83-237-0-137.pppoe.mtu-net.ru. [83.237.0.137]) by mx.google.com with ESMTPS id c6sm132796lbn.1.2012.09.18.09.53.22 (version=SSLv3 cipher=OTHER); Tue, 18 Sep 2012 09:53:24 -0700 (PDT) Message-ID: <1347987201.1612.5.camel@opensuse.site> Subject: [PATCH] Document menuentry --id option From: Andrey Borzenkov To: grub-devel@gnu.org Date: Tue, 18 Sep 2012 20:53:21 +0400 Content-Type: multipart/mixed; boundary="=-+PrpmhLHF/Wz+EOIK+Fo" X-Mailer: Evolution 3.4.4 Mime-Version: 1.0 X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 209.85.215.41 X-BeenThere: grub-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list Reply-To: The development of GNU GRUB List-Id: The development of GNU GRUB List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 18 Sep 2012 16:53:33 -0000 --=-+PrpmhLHF/Wz+EOIK+Fo Content-Type: text/plain Content-Transfer-Encoding: 7bit Document "menuentry --id" option. -andrey --=-+PrpmhLHF/Wz+EOIK+Fo Content-Disposition: attachment; filename="menuentry-id.patch" Content-Type: text/x-patch; name="menuentry-id.patch"; charset="UTF-8" Content-Transfer-Encoding: 7bit === modified file 'ChangeLog' --- old/ChangeLog 2012-09-18 11:04:06 +0000 +++ new/ChangeLog 2012-09-18 16:28:12 +0000 @@ -1,3 +1,7 @@ +2012-09-18 Andrey Borzenkov + + * docs/grub.texi: Document menuentry --id option. + 2012-09-18 Vladimir Serbinenko * util/grub-mkconfig_lib.in (grub_tab): New variable. === modified file 'docs/grub.texi' --- old/docs/grub.texi 2012-07-31 22:18:57 +0000 +++ new/docs/grub.texi 2012-09-18 16:02:26 +0000 @@ -1502,7 +1502,7 @@ exit status of a function is the exit status of the last command executed in the body. -@item menuentry @var{title} [@option{--class=class} @dots{}] [@option{--users=users}] [@option{--unrestricted}] [@option{--hotkey=key}] @{ @var{command}; @dots{} @} +@item menuentry @var{title} [@option{--class=class} @dots{}] [@option{--users=users}] [@option{--unrestricted}] [@option{--hotkey=key}] [@option{--id=id}] @{ @var{command}; @dots{} @} @xref{menuentry}. @end table @@ -3114,11 +3114,12 @@ @deffn Command menuentry @var{title} @ [@option{--class=class} @dots{}] [@option{--users=users}] @ - [@option{--unrestricted}] [@option{--hotkey=key}] @ + [@option{--unrestricted}] [@option{--hotkey=key}] [@option{--id=id}] @ @{ @var{command}; @dots{} @} This defines a GRUB menu entry named @var{title}. When this entry is selected from the menu, GRUB will set the @var{chosen} environment variable -to @var{title}, execute the list of commands given within braces, and if the +to value of @option{--id} or @var{title} if @option{--id} is not given, +execute the list of commands given within braces, and if the last command in the list returned successfully and a kernel was loaded it will execute the @command{boot} command. @@ -3135,6 +3136,9 @@ The @option{--hotkey} option associates a hotkey with a menu entry. @var{key} may be a single letter, or one of the aliases @samp{backspace}, @samp{tab}, or @samp{delete}. + +The @option{--id} may be used to associate unique identifier with a menu entry. +@var{id} is arbitrary string. @end deffn @@ -3143,7 +3147,7 @@ @deffn Command submenu @var{title} @ [@option{--class=class} @dots{}] [@option{--users=users}] @ - [@option{--unrestricted}] [@option{--hotkey=key}] @ + [@option{--unrestricted}] [@option{--hotkey=key}] [@option{--id=id}] @ @{ @var{menu entries} @dots{} @} This defines a submenu. An entry called @var{title} will be added to the menu; when that entry is selected, a new menu will be displayed showing all --=-+PrpmhLHF/Wz+EOIK+Fo--