branch master updated: doc: Describe black screen issue when booting the installer.

[guix-commits]

This is an automated email from the git hooks/post-receive script.

pelzflorian pushed a commit to branch master
in repository guix.

The following commit(s) were added to refs/heads/master by this push:
     new 2890114a70 doc: Describe black screen issue when booting the installer.
2890114a70 is described below

commit 2890114a708e3a54a14ceb762f0726b013ffdc85
Author: Florian Pelz <pelzflorian@pelzflorian.de>
AuthorDate: Thu Aug 31 12:44:55 2023 +0200

    doc: Describe black screen issue when booting the installer.
    
    With suggestions by Iku-Tulo Vilutar <ikutulovilutar@gmail.com>.
    Fixes <https://issues.guix.gnu.org/65572>.
    
    * doc/guix.texi (System Installation): Add suggestion when
    booting the installer fails with a black screen.
---
 doc/guix.texi | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/doc/guix.texi b/doc/guix.texi
index 04e5875925..464060f42c 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -2402,6 +2402,16 @@ BIOS or UEFI boot menu, where you can choose to boot 
from the USB stick.
 In order to boot from Libreboot, switch to the command mode by pressing
 the @kbd{c} key and type @command{search_grub usb}.
 
+Sadly, on some machines, the installation medium cannot be properly
+booted and you only see a black screen after booting even after you
+waited for ten minutes.  This may indicate that your machine cannot run
+Guix System; perhaps you instead want to install Guix on a foreign
+distro (@pxref{Binary Installation}).  But don't give up just yet; a
+possible workaround is pressing the @kbd{e} key in the GRUB boot menu
+and appending @option{nomodeset} to the Linux bootline.
+Sometimes the black screen issue can also be resolved by connecting a
+different display.
+
 @xref{Installing Guix in a VM}, if, instead, you would like to install
 Guix System in a virtual machine (VM).