Subject: [bug#41541] [PATCH 1/8] system: Add 'hurd' field to <operating-system>.

From: Ludovic Courtès <[email-masked]>
Date: Sat, 06 Jun 2020 12:45:07 +0200

Hi!

"Jan (janneke) Nieuwenhuizen" <[email-masked]> skribis:

> * gnu/system.scm (<operating-system>)[hurd]: New field.
> * doc/guix.texi (operating-system Reference): Document 'hurd'.
> ---
>  doc/guix.texi  | 13 ++++++++++---
>  gnu/system.scm |  3 +++
>  2 files changed, 13 insertions(+), 3 deletions(-)
>
> diff --git a/doc/guix.texi b/doc/guix.texi
> index 056bf011f6..4776eacacd 100644
> --- a/doc/guix.texi
> +++ b/doc/guix.texi
> @@ -11484,9 +11484,16 @@ configuration (@pxref{Using the Configuration System}).
>  
>  @table @asis
>  @item @code{kernel} (default: @code{linux-libre})
> -The package object of the operating system kernel to use@footnote{Currently
> -only the Linux-libre kernel is supported.  In the future, it will be
> -possible to use the GNU@tie{}Hurd.}.
> +The package object of the operating system kernel to
> +use@footnote{Currently only the Linux-libre kernel is fully supported.
> +Using GNU@tie{}mach in combination with a @code{hurd} is experimental

Using GNU@tie{}Mach with the GNU@tie{}Hurd is experimental

> +and only available when building a vm-image.}.
> +
> +@cindex hurd
> +@item @code{hurd} (default: @code{#f})
> +The hurd to be started by the kernel.  This is required to build an
> +experimental vm-image for the Hurd and requires using @code{kernel}
> +GNU@tie{}mach as well as other specific operating system overrides.

To show that this field is not specific to disk/VM images, how about
something along these lines:

  When this field is set, produce a GNU/Hurd operating system.  In that
  case, @code{kernel} must also be set to the @code{gnumach}
  package---the microkernel the Hurd runs on.

  @quotation Warning
  This feature is experimental and only supported for disk images.
  @end quotation

Ludo’.