* [PATCH] docs: Group usage of user-space utilities into single chapter
@ 2023-07-26 18:47 Glenn Washburn
2023-08-03 0:36 ` Oskari Pirhonen
0 siblings, 1 reply; 3+ messages in thread
From: Glenn Washburn @ 2023-07-26 18:47 UTC (permalink / raw)
To: grub-devel, Daniel Kiper; +Cc: Glenn Washburn
Signed-off-by: Glenn Washburn <development@efficientek.com>
---
docs/grub.texi | 42 +++++++++++++++++++++++++-----------------
1 file changed, 25 insertions(+), 17 deletions(-)
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. This change will not hamper
bootability on other machines.
+@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
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
@node Invoking grub-mkconfig
-@chapter Invoking grub-mkconfig
+@section Invoking grub-mkconfig
The program @command{grub-mkconfig} generates a configuration file for GRUB
(@pxref{Simple configuration}).
@@ -7127,7 +7135,7 @@ it to standard output.
@node Invoking grub-mkpasswd-pbkdf2
-@chapter Invoking grub-mkpasswd-pbkdf2
+@section Invoking grub-mkpasswd-pbkdf2
The program @command{grub-mkpasswd-pbkdf2} generates password hashes for
GRUB (@pxref{Security}).
@@ -7155,7 +7163,7 @@ Length of the salt. Defaults to 64.
@node Invoking grub-mkrelpath
-@chapter Invoking grub-mkrelpath
+@section Invoking grub-mkrelpath
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.
@node Invoking grub-mkrescue
-@chapter Invoking grub-mkrescue
+@section Invoking grub-mkrescue
The program @command{grub-mkrescue} generates a bootable GRUB rescue image
(@pxref{Making a GRUB bootable CD-ROM}).
@@ -7240,7 +7248,7 @@ built-in default.
@node Invoking grub-mount
-@chapter Invoking grub-mount
+@section Invoking grub-mount
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 system
@@ -7327,7 +7335,7 @@ Print verbose messages.
@node Invoking grub-probe
-@chapter Invoking grub-probe
+@section Invoking grub-probe
The program @command{grub-probe} probes device information for a given path
or device.
@@ -7413,7 +7421,7 @@ Print verbose messages.
@node Invoking grub-script-check
-@chapter Invoking grub-script-check
+@section Invoking grub-script-check
The program @command{grub-script-check} takes a GRUB script file
(@pxref{Shell-like scripting}) and checks it for syntax errors, similar to
--
2.34.1
^ permalink raw reply related [flat|nested] 3+ messages in thread
* Re: [PATCH] docs: Group usage of user-space utilities into single chapter
2023-07-26 18:47 [PATCH] docs: Group usage of user-space utilities into single chapter Glenn Washburn
@ 2023-08-03 0:36 ` Oskari Pirhonen
2023-08-11 15:57 ` Daniel Kiper
0 siblings, 1 reply; 3+ messages in thread
From: Oskari Pirhonen @ 2023-08-03 0:36 UTC (permalink / raw)
To: Glenn Washburn; +Cc: grub-devel, Daniel Kiper
[-- Attachment #1: Type: text/plain, Size: 5068 bytes --]
On Wed, Jul 26, 2023 at 13:47:24 -0500, Glenn Washburn wrote:
> Signed-off-by: Glenn Washburn <development@efficientek.com>
I really like this.
Reviewed-by: Oskari Pirhonen <xxc3ncoredxx@gmail.com>
- Oskari
> ---
> docs/grub.texi | 42 +++++++++++++++++++++++++-----------------
> 1 file changed, 25 insertions(+), 17 deletions(-)
>
> 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. This change will not hamper
> bootability on other machines.
>
>
> +@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
>
> 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
>
> @node Invoking grub-mkconfig
> -@chapter Invoking grub-mkconfig
> +@section Invoking grub-mkconfig
>
> The program @command{grub-mkconfig} generates a configuration file for GRUB
> (@pxref{Simple configuration}).
> @@ -7127,7 +7135,7 @@ it to standard output.
>
>
> @node Invoking grub-mkpasswd-pbkdf2
> -@chapter Invoking grub-mkpasswd-pbkdf2
> +@section Invoking grub-mkpasswd-pbkdf2
>
> The program @command{grub-mkpasswd-pbkdf2} generates password hashes for
> GRUB (@pxref{Security}).
> @@ -7155,7 +7163,7 @@ Length of the salt. Defaults to 64.
>
>
> @node Invoking grub-mkrelpath
> -@chapter Invoking grub-mkrelpath
> +@section Invoking grub-mkrelpath
>
> 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.
>
>
> @node Invoking grub-mkrescue
> -@chapter Invoking grub-mkrescue
> +@section Invoking grub-mkrescue
>
> The program @command{grub-mkrescue} generates a bootable GRUB rescue image
> (@pxref{Making a GRUB bootable CD-ROM}).
> @@ -7240,7 +7248,7 @@ built-in default.
>
>
> @node Invoking grub-mount
> -@chapter Invoking grub-mount
> +@section Invoking grub-mount
>
> 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 system
> @@ -7327,7 +7335,7 @@ Print verbose messages.
>
>
> @node Invoking grub-probe
> -@chapter Invoking grub-probe
> +@section Invoking grub-probe
>
> The program @command{grub-probe} probes device information for a given path
> or device.
> @@ -7413,7 +7421,7 @@ Print verbose messages.
>
>
> @node Invoking grub-script-check
> -@chapter Invoking grub-script-check
> +@section Invoking grub-script-check
>
> The program @command{grub-script-check} takes a GRUB script file
> (@pxref{Shell-like scripting}) and checks it for syntax errors, similar to
> --
> 2.34.1
>
>
> _______________________________________________
> Grub-devel mailing list
> Grub-devel@gnu.org
> https://lists.gnu.org/mailman/listinfo/grub-devel
[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 228 bytes --]
^ permalink raw reply [flat|nested] 3+ messages in thread
* Re: [PATCH] docs: Group usage of user-space utilities into single chapter
2023-08-03 0:36 ` Oskari Pirhonen
@ 2023-08-11 15:57 ` Daniel Kiper
0 siblings, 0 replies; 3+ messages in thread
From: Daniel Kiper @ 2023-08-11 15:57 UTC (permalink / raw)
To: Glenn Washburn, grub-devel
On Wed, Aug 02, 2023 at 07:36:22PM -0500, Oskari Pirhonen wrote:
> On Wed, Jul 26, 2023 at 13:47:24 -0500, Glenn Washburn wrote:
> > Signed-off-by: Glenn Washburn <development@efficientek.com>
>
> I really like this.
>
> Reviewed-by: Oskari Pirhonen <xxc3ncoredxx@gmail.com>
Reviewed-by: Daniel Kiper <daniel.kiper@oracle.com>
Daniel
_______________________________________________
Grub-devel mailing list
Grub-devel@gnu.org
https://lists.gnu.org/mailman/listinfo/grub-devel
^ permalink raw reply [flat|nested] 3+ messages in thread
end of thread, other threads:[~2023-08-11 15:57 UTC | newest]
Thread overview: 3+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2023-07-26 18:47 [PATCH] docs: Group usage of user-space utilities into single chapter Glenn Washburn
2023-08-03 0:36 ` Oskari Pirhonen
2023-08-11 15:57 ` Daniel Kiper
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.