I took the freedom to slightly amend the text (see diff below), tweaked the commit log, and pushed it.
Thanks! Ludo’.
diff --git a/doc/guix.texi b/doc/guix.texi index 36337f1..ed2b81b 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -1644,27 +1644,27 @@ debugging information''), which roughly means that code is compiled with @defvr {Scheme Variable} glib-or-gtk-build-system This variable is exported by @code{(guix build-system glib-or-gtk)}. It -is intended for use with packages making use of -@url{https://developer.gnome.org/glib/stable, glib} or -@url{https://developer.gnome.org/gtk3/stable, gtk+}. +is intended for use with packages making use of GLib or GTK+. -This build-system adds the following two phases to the ones defined by -the @code{gnu-build-system}: +This build system adds the following two phases to the ones defined by +@var{gnu-build-system}: @table @code @item glib-or-gtk-wrap The phase @code{glib-or-gtk-wrap} ensures that programs found under -@file{bin/} are able to find @code{glib} schemas and @code{gtk+} -libraries. This is achieved by appropriately setting the environment -variables @code{XDG_DATA_DIRS} and @code{GTK_PATH}; and by wrapping the -programs in suitable launch scripts. +@file{bin/} are able to find GLib's ``schemas'' and +@uref{https://developer.gnome.org/gtk3/stable/gtk-running.html, GTK+ +modules}. This is achieved by wrapping the programs in launch scripts +that appropriately set the @code{XDG_DATA_DIRS} and @code{GTK_PATH} +environment variables. @item glib-or-gtk-compile-schemas -The phase @code{glib-or-gtk-compile-schemas} makes sure that all -@code{glib} schemas are compiled. Compilation is performed by the -program @code{glib-compile-schemas}. It is provided by the package +The phase @code{glib-or-gtk-compile-schemas} makes sure that all GLib's +@uref{https://developer.gnome.org/gio/stable/glib-compile-schemas.html, +GSettings schemas} are compiled. Compilation is performed by the +@command{glib-compile-schemas} program. It is provided by the package @code{glib:bin} which is automatically imported by the build system. -The @code{glib} package providing @code{glib-compile-schemas} can be +The @code{glib} package providing @command{glib-compile-schemas} can be specified with the @code{#:glib} parameter. @end table