All of lore.kernel.org
 help / color / mirror / Atom feed
* [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.