02/02: doc: Refine wording of binary installation introductory text.

[guix-commits]

apteryx pushed a commit to branch master
in repository guix.

commit ec9c8b0c1a0982e97375df0ae44af4fdc72c3757
Author: Maxim Cournoyer <maxim.cournoyer@gmail.com>
AuthorDate: Wed Feb 21 11:55:25 2024 -0500

    doc: Refine wording of binary installation introductory text.
    
    * doc/guix.texi (Binary Installation): Mention the requirement to use a
    Hurd or Linux kernel for the binary installation.
    
    Suggested-by: Matt <matt@excalamus.com>
    Change-Id: Ibc0552f59be4fdaaf8d44a5222e6feb925d3f06f
---
 doc/guix.texi | 15 +++++++++------
 1 file changed, 9 insertions(+), 6 deletions(-)

diff --git a/doc/guix.texi b/doc/guix.texi
index 9966a8e697..34aa3545da 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -732,14 +732,17 @@ ready to use it.
 
 @cindex installing Guix from binaries
 @cindex installer script
-This section describes how to install Guix on an arbitrary system from a
-self-contained tarball providing binaries for Guix and for all its
-dependencies.  This is often quicker than installing from source, which
-is described in the next sections.  The only requirement is to have
-GNU@tie{}tar and Xz.
+This section describes how to install Guix from a self-contained tarball
+providing binaries for Guix and for all its dependencies.  This is often
+quicker than installing from source, which is described in the next
+sections.  Binary installation requires a system using a Hurd or Linux
+kernel; the GNU@tie{}tar and Xz commands must also be available.
+
+@quotation Important
+This section only applies to systems without Guix.  Following it for
+existing Guix installations will overwrite important system files.
 
 @c Note duplicated from the ``Installation'' node.
-@quotation Note
 We recommend the use of this
 @uref{https://git.savannah.gnu.org/cgit/guix.git/plain/etc/guix-install.sh,
 shell installer script}.  The script automates the download, installation, and