From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from list by lists.gnu.org with archive (Exim 4.71) id 1Zv9Wj-0004D8-15 for mharc-grub-devel@gnu.org; Sat, 07 Nov 2015 14:51:53 -0500 Received: from eggs.gnu.org ([2001:4830:134:3::10]:33095) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Zv9Wg-0004CF-3L for grub-devel@gnu.org; Sat, 07 Nov 2015 14:51:51 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Zv9Wc-0005l9-TJ for grub-devel@gnu.org; Sat, 07 Nov 2015 14:51:50 -0500 Received: from mout.gmx.net ([212.227.17.21]:55680) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Zv9Wc-0005k3-KB for grub-devel@gnu.org; Sat, 07 Nov 2015 14:51:46 -0500 Received: from [192.168.43.166] ([80.215.130.76]) by mail.gmx.com (mrgmx101) with ESMTPSA (Nemesis) id 0MWwp6-1ZyOdZ2C1M-00W0s6 for ; Sat, 07 Nov 2015 20:51:45 +0100 Subject: Re: [PATCH] doc: document config_directory and config_file variables To: The development of GNU GRUB References: <1446891714-10249-1-git-send-email-arvidjaar@gmail.com> From: "Arbiel (gmx)" X-Enigmail-Draft-Status: N1110 Message-ID: <563E564F.6000207@gmx.fr> Date: Sat, 7 Nov 2015 20:51:43 +0100 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:38.0) Gecko/20100101 Thunderbird/38.3.0 MIME-Version: 1.0 In-Reply-To: <1446891714-10249-1-git-send-email-arvidjaar@gmail.com> Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="MbiqTCBocCjWdVJnqs3ln7wnewhaij4RC" X-Provags-ID: V03:K0:+Yh89uLZbixBWVOxEv12XziVPUkvZUqXQr9O68wI4ibuyVeInGN 4h2ow3UZUqu177jfXNeHcYwLQ8LXlJm2QzkN6jVj+WnCr70O9sdNdyXbxiO3+BIkxpKNpYN Ki9T54sz5JK65BO68XfxxNy3VT+EiBHO2I/rZtVCS6u7t93mtNKGrrzGH03alz41vOxg6uW kJdX0L+vYWBRDDmMInJRA== X-UI-Out-Filterresults: notjunk:1;V01:K0:cSDFprGFjX8=:PfoARdF1X1i0hCSZ2I6z71 BEVrffuJ9d3gRjaHGVYavs9TOaNjIuVrMcGXKk8M5jZ3GO8zF8L1kI22v92Fmqzw/bXOq7jJO IfiWsXqFFQSvB7dcu6dc/e3odFdxScSYaZmPblHUMaPe+ox9/0fadOhJGUFqLrtWOiHqC/OEi iCpfCS8iAvomWVmjE36PnwJRd4EwUkWxVOJx1/pzpjn3Z8W8hz/CfB9S14Xk/kBXIFCziKFD0 rkz0Bg73TTxOrdAwOWvY4FU55YB2zPTssM7lXiTr6PCCtfgXAh8TEBdQ6VzhLgWTZsxTUmGCh HND8yZ5SUpkUhI3/svvR4OBYeyRyG0gQ5EVbiCUYRQiV2tzaEuZtBFJ56aYvWHbd7QzRdDwL0 GT0HLre52+UimKWNU/3wkaV0V6XcwrbdPsgGO5joPk7psZkh/LkO7aD+0bJbPsk6apUu2wBwM e0EOq9a5peH7+LtqYjh2/4/i0GMoZVUJXbqSjwc7Guet2YLfoJC2VRjYJSx/LpkMhk0LrEXxe yOFgwNLKFDKfo3NQ6qB2hgHV/rjUO8XstZE6MuMwVx7xhy+SBTO7eOfIO1Q2BCm53QPKToyIX 5eMQdLFf8Y95jpuBxTjFMIgtQsltkeBfMM4EyhLUIqFAM7/FCde422kagwAzmkAoYVlw0sWo9 XcyXrT8vkMkCP91eqh+Ocaq/K6+baIEMzMnLL0dQYnddliDmQtTie7YMazTQNtR7GHfSS1gOq GrdZY+yKbFWBZwNwV+pRWJawLK0JlbeEEu1LxbSMtEPF6HVICAg2Oaq61Ho= X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 212.227.17.21 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: Sat, 07 Nov 2015 19:51:51 -0000 This is an OpenPGP/MIME signed message (RFC 4880 and 3156) --MbiqTCBocCjWdVJnqs3ln7wnewhaij4RC Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Hi There seems to be other variables and command parameters which lack documentation. Here is a list of such variables found in my grub.cfg files (I have discarded "save_env"ed variables, obviously environment variables) and which are not set in the environment block ${feature_menuentry_id} ${boot_once} $feature_all_video_module $feature_default_font_path $feature_platform_search_hint $feature_timeout_style $match As the names suggest, these variables could be distribution specific (Ubuntu). What do you think ? undocumented command parameter : --hint (command search), and some other --hint.something which I haven't been able to localise just now. I found in my grub.cfg file a "hwmatch" command which is not defifed as a function. Is this a undocumented grub command ? Its result may well the $match variable. Le 07/11/2015 11:21, Andrey Borzenkov a =C3=A9crit : > People are using this variable and it should be documented. > > --- > docs/grub.texi | 18 ++++++++++++++++++ > 1 file changed, 18 insertions(+) > > diff --git a/docs/grub.texi b/docs/grub.texi > index b9f41a7..db765a3 100644 > --- a/docs/grub.texi > +++ b/docs/grub.texi > @@ -3038,6 +3038,8 @@ These variables have special meaning to GRUB. > * cmdpath:: > * color_highlight:: > * color_normal:: > +* config_directory:: > +* config_file:: > * debug:: > * default:: > * fallback:: > @@ -3180,6 +3182,22 @@ matching colors of first half. > to support whole rgb24 palette but currently there is no compelling re= ason > to go beyond the current 16 colors. > =20 > + > +@node config_directory > +@subsection config_directory > + > +This variable is automatically set by GRUB to the directory part of > +current configuration file name (@pxref{config_file}). > + > + > +@node config_file > +@subsection config_file > + > +This variable is automatically set by GRUB to the name of configuratio= n file that is being > +processed by commands @command{configfile} (@pxref{configfile}) or @co= mmand{normal} > +(@pxref{normal}). It is restored to the previous value when command c= ompletes. > + > + > @node debug > @subsection debug > =20 --MbiqTCBocCjWdVJnqs3ln7wnewhaij4RC Content-Type: application/pgp-signature; name="signature.asc" Content-Description: OpenPGP digital signature Content-Disposition: attachment; filename="signature.asc" -----BEGIN PGP SIGNATURE----- Version: GnuPG v2.0.22 (GNU/Linux) iF4EAREIAAYFAlY+VlAACgkQG6j+1Sdg4KvMEAD9Ek0NY9Do/MLr8SOLRl6ipztZ vxtkX8YYCOODL+u/XB0A/2KRnAOyHznAkpn4A80iAJucezHxT/ygnLInLrgBj46O =Fst6 -----END PGP SIGNATURE----- --MbiqTCBocCjWdVJnqs3ln7wnewhaij4RC--