Received: from list by lists.gnu.org with archive (Exim 4.90_1) id 1qRMKO-0004ne-PW for mharc-grub-devel@gnu.org; Wed, 02 Aug 2023 20:36:32 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qRMKM-0004nL-Iv for grub-devel@gnu.org; Wed, 02 Aug 2023 20:36:30 -0400 Received: from mail-yb1-xb2d.google.com ([2607:f8b0:4864:20::b2d]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1qRMKK-0005HE-Aa for grub-devel@gnu.org; Wed, 02 Aug 2023 20:36:29 -0400 Received: by mail-yb1-xb2d.google.com with SMTP id 3f1490d57ef6-d13e0bfbbcfso666856276.0 for ; Wed, 02 Aug 2023 17:36:27 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20221208; t=1691022987; x=1691627787; h=in-reply-to:content-disposition:mime-version:references :mail-followup-to:message-id:subject:cc:to:from:date:from:to:cc :subject:date:message-id:reply-to; bh=cbrNoRdDnR2eZFYXkLSmQm09IpuWl98qZcG0q29PTzM=; b=EOws4O8LHLBBSimkO7XaQQE+bo/bo7fGJP4SUO9kRPqUxB4JmBhHcU2Y+erGfkPpzz HlqjEE1nk5MXD9LbOk8qQylx+Q4i9th5CadFgUWRElElEnlxl9ETHzqG1canSE6/Bfq8 0JHA3vFRjO0zPUsUsgMmwN074SE1sO+TkTPQqtQpPlRMqjNaoyYeTgySXKb2pYUsrm5F chpgLNLhh7MLKeUl7phwvL0ERpvIPbXsgNXj+oYxaeoS89Fsg9/NBa/rzhBA0++llwve CyatMVs56er9XvKHXPMr/JuU3lfMz2Ofhe3DRdZ258R9tFhHk9LhmxYkWPNeUl2Xhsyd kQ5w== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1691022987; x=1691627787; h=in-reply-to:content-disposition:mime-version:references :mail-followup-to:message-id:subject:cc:to:from:date :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=cbrNoRdDnR2eZFYXkLSmQm09IpuWl98qZcG0q29PTzM=; b=JKUuLhl1aKMQjVP2mlYTWKa4u1wPSHo69Tp2mAQwFDDVEaxEf+QiQr4Fai7JOHeba0 kQAR+LOc4EJcpVmt6uJj1OfuHjQtIGqU/m8P1qD6Lc5r5po4P+GAJqRH0BeFdSxpJ4mV kRlpeNJNmH/e6HggJKlaXLyvykY6R5VoPf880FbBvsB5OHDJNSawD8qSY/ia6+HrjtjS wx/pi4eQ9H2NrAFwIhqg54aLLnNG41U5FQErY0krOClDI4stK+Mec2vyDav9+Orl72dT gWEraBvgd0fm76EukFw/DC2UMnRw6YAC/NpwTH3nO0j5Y5tTXkAR8DUGXC2lUwq7cXqy cBNw== X-Gm-Message-State: ABy/qLbVCVAZsi6OuoygJCbDHU8BUSqTXE73cO1FtARVCghztT2x46py n7IMg5W3K18q7oGmCNbUYkV4DhDEAo97gg== X-Google-Smtp-Source: APBJJlGqkYi2b7WX8pVw4vX1palm0PLfGec4+wRk2LDTuPRZpjt2iEyUZAwAAVg7/xCYO60TawM6YQ== X-Received: by 2002:a05:6902:1885:b0:cb7:a41e:be58 with SMTP id cj5-20020a056902188500b00cb7a41ebe58mr22208362ybb.23.1691022986891; Wed, 02 Aug 2023 17:36:26 -0700 (PDT) Received: from dj3ntoo ([2607:fb90:8a00:9934:c0ca:305c:eb69:3157]) by smtp.gmail.com with ESMTPSA id z13-20020a25ad8d000000b00d0c698ed6b6sm4176852ybi.41.2023.08.02.17.36.24 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 02 Aug 2023 17:36:25 -0700 (PDT) Date: Wed, 2 Aug 2023 19:36:22 -0500 From: Oskari Pirhonen To: Glenn Washburn Cc: grub-devel@gnu.org, Daniel Kiper Subject: Re: [PATCH] docs: Group usage of user-space utilities into single chapter Message-ID: Mail-Followup-To: Glenn Washburn , grub-devel@gnu.org, Daniel Kiper References: <20230726184724.1286479-1-development@efficientek.com> MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="E0D73HyXmtsMwEPU" Content-Disposition: inline In-Reply-To: <20230726184724.1286479-1-development@efficientek.com> Received-SPF: pass client-ip=2607:f8b0:4864:20::b2d; envelope-from=xxc3ncoredxx@gmail.com; helo=mail-yb1-xb2d.google.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: grub-devel@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: The development of GNU GRUB List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 03 Aug 2023 00:36:30 -0000 --E0D73HyXmtsMwEPU Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Wed, Jul 26, 2023 at 13:47:24 -0500, Glenn Washburn wrote: > Signed-off-by: Glenn Washburn I really like this. Reviewed-by: Oskari Pirhonen - Oskari > --- > docs/grub.texi | 42 +++++++++++++++++++++++++----------------- > 1 file changed, 25 insertions(+), 17 deletions(-) >=20 > diff --git a/docs/grub.texi b/docs/grub.texi > index fe94ef9e94fc..dae10621b99f 100644 > --- a/docs/grub.texi > +++ b/docs/grub.texi > @@ -104,15 +104,7 @@ This edition documents version @value{VERSION}. > * Platform-specific operations:: Platform-specific operations > * Supported kernels:: Supported kernels > * Troubleshooting:: Error messages produced by GRUB > -* Invoking grub-install:: How to use the GRUB installer > -* Invoking grub-mkconfig:: Generate a GRUB configuration file > -* Invoking grub-mkpasswd-pbkdf2:: > - Generate GRUB password hashes > -* Invoking grub-mkrelpath:: Make system path relative to its root > -* Invoking grub-mkrescue:: Make a GRUB rescue image > -* Invoking grub-mount:: Mount a file system using GRUB > -* Invoking grub-probe:: Probe device information for GRUB > -* Invoking grub-script-check:: Check GRUB script file for syntax errors > +* User-space utilities:: Usage of user-space utilities > * Obtaining and Building GRUB:: How to obtain and build GRUB > * Reporting bugs:: Where you should send a bug report > * Future:: Some future plans on GRUB > @@ -7034,8 +7026,24 @@ entry which claims partition start at block 0. Thi= s change will not hamper > bootability on other machines. > =20 > =20 > +@node User-space utilities > +@chapter User-space utilities > + > +@menu > +* Invoking grub-install:: How to use the GRUB installer > +* Invoking grub-mkconfig:: Generate a GRUB configuration file > +* Invoking grub-mkpasswd-pbkdf2:: > + Generate GRUB password hashes > +* Invoking grub-mkrelpath:: Make system path relative to its root > +* Invoking grub-mkrescue:: Make a GRUB rescue image > +* Invoking grub-mount:: Mount a file system using GRUB > +* Invoking grub-probe:: Probe device information for GRUB > +* Invoking grub-script-check:: Check GRUB script file for syntax errors > +@end menu > + > + > @node Invoking grub-install > -@chapter Invoking grub-install > +@section Invoking grub-install > =20 > The program @command{grub-install} generates a GRUB core image using > @command{grub-mkimage} and installs it on your system. You must specify= the > @@ -7101,7 +7109,7 @@ outside of the MBR. Disable the Reed-Solomon codes= with this option. > @end table > =20 > @node Invoking grub-mkconfig > -@chapter Invoking grub-mkconfig > +@section Invoking grub-mkconfig > =20 > The program @command{grub-mkconfig} generates a configuration file for G= RUB > (@pxref{Simple configuration}). > @@ -7127,7 +7135,7 @@ it to standard output. > =20 > =20 > @node Invoking grub-mkpasswd-pbkdf2 > -@chapter Invoking grub-mkpasswd-pbkdf2 > +@section Invoking grub-mkpasswd-pbkdf2 > =20 > The program @command{grub-mkpasswd-pbkdf2} generates password hashes for > GRUB (@pxref{Security}). > @@ -7155,7 +7163,7 @@ Length of the salt. Defaults to 64. > =20 > =20 > @node Invoking grub-mkrelpath > -@chapter Invoking grub-mkrelpath > +@section Invoking grub-mkrelpath > =20 > The program @command{grub-mkrelpath} makes a file system path relative to > the root of its containing file system. For instance, if @file{/usr} is= a > @@ -7182,7 +7190,7 @@ Print the version number of GRUB and exit. > =20 > =20 > @node Invoking grub-mkrescue > -@chapter Invoking grub-mkrescue > +@section Invoking grub-mkrescue > =20 > The program @command{grub-mkrescue} generates a bootable GRUB rescue ima= ge > (@pxref{Making a GRUB bootable CD-ROM}). > @@ -7240,7 +7248,7 @@ built-in default. > =20 > =20 > @node Invoking grub-mount > -@chapter Invoking grub-mount > +@section Invoking grub-mount > =20 > The program @command{grub-mount} performs a read-only mount of any file > system or file system image that GRUB understands, using GRUB's file sys= tem > @@ -7327,7 +7335,7 @@ Print verbose messages. > =20 > =20 > @node Invoking grub-probe > -@chapter Invoking grub-probe > +@section Invoking grub-probe > =20 > The program @command{grub-probe} probes device information for a given p= ath > or device. > @@ -7413,7 +7421,7 @@ Print verbose messages. > =20 > =20 > @node Invoking grub-script-check > -@chapter Invoking grub-script-check > +@section Invoking grub-script-check > =20 > The program @command{grub-script-check} takes a GRUB script file > (@pxref{Shell-like scripting}) and checks it for syntax errors, similar = to > --=20 > 2.34.1 >=20 >=20 > _______________________________________________ > Grub-devel mailing list > Grub-devel@gnu.org > https://lists.gnu.org/mailman/listinfo/grub-devel --E0D73HyXmtsMwEPU Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iHUEABYIAB0WIQQfOU+JeXjo4uxN6vCp8he9GGIfEQUCZMr2ggAKCRCp8he9GGIf EVBbAP9e+EgoHGnnPJs8oETiOmJu6ze8fMw3iiMSHg4QFCZEygEA/+zmOagomVHb cA/yZ0d0O6uLbvqV3sD6XDYr+tDuKgQ= =jYZV -----END PGP SIGNATURE----- --E0D73HyXmtsMwEPU--