From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from list by lists.gnu.org with archive (Exim 4.71) id 1Tx3k3-0000kz-HX for mharc-grub-devel@gnu.org; Sun, 20 Jan 2013 17:51:55 -0500 Received: from eggs.gnu.org ([208.118.235.92]:36262) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Tx3k1-0000kg-2j for grub-devel@gnu.org; Sun, 20 Jan 2013 17:51:54 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Tx3jy-0007G1-Lb for grub-devel@gnu.org; Sun, 20 Jan 2013 17:51:52 -0500 Received: from mail-ee0-f44.google.com ([74.125.83.44]:53541) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Tx3jy-0007Fd-AJ for grub-devel@gnu.org; Sun, 20 Jan 2013 17:51:50 -0500 Received: by mail-ee0-f44.google.com with SMTP id l10so2659645eei.31 for ; Sun, 20 Jan 2013 14:51:49 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=x-received:message-id:date:from:user-agent:mime-version:to:subject :references:in-reply-to:x-enigmail-version:content-type; bh=bjNtOo1Kla2WzZfU6GVRWVWBfsGShwSX+0wSgI03ZvE=; b=D2KNnrtcqKawxvDxbVTExLvanD6wn8RnTOZbk88Ebk2FPYVPw81Eh1F1c4PpQaxTQw Bq2odfmo9HWwdXkjHm94C162GbgnuTgAR7EUY0I5l8YwNzwowMjIx92xaPiq1qVIDbgd 9bdyEun/MP0/unWSIs68ka2Ys3AJ5XXsbtP2FsRaAMcuX8jmgw6vb4eCJuoRzwZIWu8U MEVSYlEqWBNPcwNojQbe8GKNNLRYDw9R0ZYG/sLBmh6fgLh8W5lpclHWIfhbvTlat+jU iFmflnYNZRHgoc+lhvqLt2MI4X4wGShNZm91Acku1WXPzTbd4mXdKXJXvh8GtHwIg/aq o0nA== X-Received: by 10.14.221.9 with SMTP id q9mr53735532eep.3.1358722309278; Sun, 20 Jan 2013 14:51:49 -0800 (PST) Received: from debian.x201.phnet (90-165.78-83.cust.bluewin.ch. [83.78.165.90]) by mx.google.com with ESMTPS id z8sm19575570eeo.11.2013.01.20.14.51.47 (version=TLSv1 cipher=ECDHE-RSA-RC4-SHA bits=128/128); Sun, 20 Jan 2013 14:51:48 -0800 (PST) Message-ID: <50FC7502.2070006@gmail.com> Date: Sun, 20 Jan 2013 23:51:46 +0100 From: =?UTF-8?B?VmxhZGltaXIgJ8+GLWNvZGVyL3BoY29kZXInIFNlcmJpbmVua28=?= User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:10.0.11) Gecko/20121122 Icedove/10.0.11 MIME-Version: 1.0 To: The development of GNU GRUB Subject: Re: [PATCH] Document menuentry --id option References: <1347987201.1612.5.camel@opensuse.site> In-Reply-To: <1347987201.1612.5.camel@opensuse.site> X-Enigmail-Version: 1.4.1 Content-Type: multipart/signed; micalg=pgp-sha512; protocol="application/pgp-signature"; boundary="------------enigC8FB19544DC63F183E6F8700" X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [fuzzy] X-Received-From: 74.125.83.44 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: Sun, 20 Jan 2013 22:51:55 -0000 This is an OpenPGP/MIME signed message (RFC 2440 and 3156) --------------enigC8FB19544DC63F183E6F8700 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable On 18.09.2012 18:53, Andrey Borzenkov wrote: >=20 > =3D=3D=3D 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 > =20 > * util/grub-mkconfig_lib.in (grub_tab): New variable. >=20 > =3D=3D=3D 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 execu= ted in > the body. > =20 > -@item menuentry @var{title} [@option{--class=3Dclass} @dots{}] [@optio= n{--users=3Dusers}] [@option{--unrestricted}] [@option{--hotkey=3Dkey}] @= { @var{command}; @dots{} @} > +@item menuentry @var{title} [@option{--class=3Dclass} @dots{}] [@optio= n{--users=3Dusers}] [@option{--unrestricted}] [@option{--hotkey=3Dkey}] [= @option{--id=3Did}] @{ @var{command}; @dots{} @} > @xref{menuentry}. > @end table > =20 > @@ -3114,11 +3114,12 @@ > =20 > @deffn Command menuentry @var{title} @ > [@option{--class=3Dclass} @dots{}] [@option{--users=3Dusers}] @ > - [@option{--unrestricted}] [@option{--hotkey=3Dkey}] @ > + [@option{--unrestricted}] [@option{--hotkey=3Dkey}] [@option{--id=3Di= d}] @ > @{ @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 var= iable > -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 It's better to not mention the possible usage of title for this at all. Ehile it's kept for backward compatibility it has problems when language or disk name changes and hence discouraged. > last command in the list returned successfully and a kernel was loaded= it > will execute the @command{boot} command. > =20 > @@ -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{backspac= e}, > @samp{tab}, or @samp{delete}. > + > +The @option{--id} may be used to associate unique identifier with a me= nu entry. > +@var{id} is arbitrary string. It has to be [a-zA-Z_][0-9a-zA-Z_]* (while arbitrary string would work it's not a good idea. > @end deffn > =20 > =20 > @@ -3143,7 +3147,7 @@ > =20 > @deffn Command submenu @var{title} @ > [@option{--class=3Dclass} @dots{}] [@option{--users=3Dusers}] @ > - [@option{--unrestricted}] [@option{--hotkey=3Dkey}] @ > + [@option{--unrestricted}] [@option{--hotkey=3Dkey}] [@option{--id=3Di= d}] @ > @{ @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 showin= g all >=20 --=20 Regards Vladimir '=CF=86-coder/phcoder' Serbinenko --------------enigC8FB19544DC63F183E6F8700 Content-Type: application/pgp-signature; name="signature.asc" Content-Description: OpenPGP digital signature Content-Disposition: attachment; filename="signature.asc" -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.12 (GNU/Linux) Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/ iF4EAREKAAYFAlD8dQIACgkQNak7dOguQglB6wD+Mf+9ESqLQy+5rrEz6+cMssCi eL5KECE4it4w8Rrieq8A/0ahS723Der944bfl+kun5Wa1rWPUIxqL7nICCx0VeJS =nJA+ -----END PGP SIGNATURE----- --------------enigC8FB19544DC63F183E6F8700--