From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from list by lists.gnu.org with archive (Exim 4.71) id 1ZvCRt-0003Pm-CA for mharc-grub-devel@gnu.org; Sat, 07 Nov 2015 17:59:05 -0500 Received: from eggs.gnu.org ([2001:4830:134:3::10]:52589) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZvCRq-0003O0-Ey for grub-devel@gnu.org; Sat, 07 Nov 2015 17:59:03 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ZvCRm-0008DT-EL for grub-devel@gnu.org; Sat, 07 Nov 2015 17:59:02 -0500 Received: from mout.gmx.net ([212.227.15.15]:49413) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZvCRm-0008DI-3s for grub-devel@gnu.org; Sat, 07 Nov 2015 17:58:58 -0500 Received: from [192.168.43.166] ([80.215.130.76]) by mail.gmx.com (mrgmx002) with ESMTPSA (Nemesis) id 0MA8hF-1ZkWGP3nlR-00BKHf for ; Sat, 07 Nov 2015 23:58:57 +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> <563E564F.6000207@gmx.fr> <563E5A64.80601@gmail.com> From: "Arbiel (gmx)" X-Enigmail-Draft-Status: N1110 Message-ID: <563E822F.3040503@gmx.fr> Date: Sat, 7 Nov 2015 23:58:55 +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: <563E5A64.80601@gmail.com> Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="ktUr3NOLrGh20jiDkkouGwcdFqFcfirXr" X-Provags-ID: V03:K0:oM5FHcN8af++nCSqtlliQUDq8KHAkBHrIVxIoKVwwlgLN88IvZb gsgrKlg0J7tSKhK3vjs4f7WIu/b7Vnj+8yJ3q6Z02ZQLKjs/QMlK1M0hEKLz8hbOpJr6C42 jaBRqq2wMNm6DNUoDLBoNhSxEwiNgnYr496/ltfUV/QDnCdnMsxld/g1dJhLyI7yKfNnKdL zuRp+V/Ojf8J/ifKEW8TQ== X-UI-Out-Filterresults: notjunk:1;V01:K0:vRi5ZIEwy1E=:DibKC1jrmjWudBW/T2RfL/ TLMiddykbe2R6ylkKIf8xPOCRi11s13qLFtgvlq3j+CC/UOJXizdimdTI1sDk9nTgb6bI42qg sQcoNGPq4DRpkz8V9n86hT8IenoeUFf2KBvLP1kmbBJJ6OTfYFWk42AhLCsjXnvrmGJQsRTa9 RcRsGULpmkUnmAw9z2rgV1o/1MSyJWe7H3rNP2Y2+THWvlANbROvia97jLb9hAmZXh6j+gjjV rm25KyyOzQnur6qJg1w8hMsyhEoq+Ly6VLogOCllpcParUjPDImVrPtNwVCLO1Skwv3oT8Ohv cQ/GQNndjqMDmmk5Gy/DH5PpWBNHMYtYotlPi6rGaQJlrqEaEcB4YWtgbi1lyKO5eoeagCpVR 9iUW0nO3B3liIs1+YvE5fQf+GvQvSg0DzYjCebzE2djAV0K3T4b/pyPGyPee7ot4CDhROOxPZ VahG0uYFxGuxrigjvux+rsNI9Uj9CO0lWn6knKi2tOgAkgeKbO4kk2jGIoMTQCVQWwkvzUIn1 Lc/x8m4affJpxtldUNA3lUP7M1qYXTycO3wd58sMCPKmpQvM0zI5zWx4UVMbaBc61aFX7SbCN iOSpwdjlmbO6Zs5sEppMmZ+2K96dDkaEpJgxa41qQ3c//fWP+JDkWlfBiQvi/RJ2KkNmijArW 9V/CCtXNCxzw6DkJDClebd+qEnXBNQmdhZUgdAgsb6tjAzoQrdT3atsfkcpFPAMuU7sAP2q1V vvWfL+2S9ACZuVmgOw3I0V1yZn60KswOeGDkQQjDG/XprOtDAl4nwzrMUkw= X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 212.227.15.15 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 22:59:03 -0000 This is an OpenPGP/MIME signed message (RFC 4880 and 3156) --ktUr3NOLrGh20jiDkkouGwcdFqFcfirXr Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Le 07/11/2015 21:09, Andrei Borzenkov a =C3=A9crit : > 07.11.2015 22:51, Arbiel (gmx) =C3=90=C2=BF=C3=90=C2=B8=C3=91=CB=86=C3=90= =C2=B5=C3=91=E2=80=9A: >> 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 > > I do not not think any of them need to be documented in user manual. > Features are of interest to developers to ensure backward > compatibility; users start off with a given version and need not > usually care if it works in earlier ones. $boot_once is internal > implementation variable that is of no interest to anyone and its > purpose is obvious by reading script. > > It's fine to describe them in developers documentation of course, but > so far nobody volunteered to maintain it. > >> $match >> >> As the names suggest, these variables could be distribution specific >> (Ubuntu). What do you think ? >> >> undocumented command parameter : --hint (command search), and some oth= er >> --hint.something which I haven't been able to localise just now. >> > > Which command? search. And I just read in a grub.cfg file, not one of mine the line search --no-floppy --fs-uuid --set=3Droot --hint-bios=3Dhd0,gpt6 --hint-e= fi=3Dhd0,gpt6 --hint-baremetal=3Dahci0,gpt6 427b86fb-cc66-46be-ad68-ade8= 6794af55 which shows some "--hint" parameters. What do they all mean ? > >> I found in my grub.cfg file a "hwmatch" command which is not defifed a= s >> a function. Is this a undocumented grub command ? Its result may well >> the $match variable. >> > > Both are Ubuntu (or may be Debian) specific. > > > _______________________________________________ > Grub-devel mailing list > Grub-devel@gnu.org > https://lists.gnu.org/mailman/listinfo/grub-devel --ktUr3NOLrGh20jiDkkouGwcdFqFcfirXr 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+gi8ACgkQG6j+1Sdg4KtMkAD/bMtlNkn/J0TrXyFhggEgrLYp H9IsLeLzGvP6TiINoTwBAIEpHhUtC3/Niam34gdig6ewC4l0r+U8TImjmKwo3OfT =bnk/ -----END PGP SIGNATURE----- --ktUr3NOLrGh20jiDkkouGwcdFqFcfirXr--