Subject: bug#65572: [PATCH v3] doc: Describe black screen issue when booting the installer.

From: Csepp <[email-masked]>
Date: Fri, 01 Sep 2023 14:28:49 +0200

Florian Pelz <[email-masked]> writes:

> With suggestions by Iku-Tulo Vilutar <[email-masked]>.
> Fixes <https://issues.guix.gnu.org/65572>.
>
> * doc/guix.texi (System Installation): Add suggestion when
> booting the installer fails with a black screen.
> ---
> changes:
>  - tell users to wait 10 minutes, not 2
>  - don't suggest video=uvesafb which is without effect
>  - more positive wording (don't give up just yet)
>
>  doc/guix.texi | 10 ++++++++++
>  1 file changed, 10 insertions(+)
>

There was a thread about having a dedicated "safe video" option in the
GRUB menu, like a lot of distros do.  I still think we should do that as
well, because having to edit the kernel boot arguments is much more
difficult, and because the user wouldn't have to go consult the manual
to know that there is such an option, it would be right in front of
them.
But of course documenting the workaround like this is the next best
thing.