01/05: doc: Add note about <https://bugs.gnu.org/35541>.

[guix-commits]

civodul pushed a commit to branch version-1.0.0
in repository guix.

commit 542e7fb57fe5626970e9321cd23645270a427388
Author: Ludovic Courtès <address@hidden>
Date:   Sat May 4 22:16:53 2019 +0200

    doc: Add note about <https://bugs.gnu.org/35541>.
    
    * doc/guix.texi (Guided Graphical Installation): Add node about
    <https://bugs.gnu.org/35541>.
    (System Installation): Refer to it.
---
 doc/guix.texi | 56 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 56 insertions(+)

diff --git a/doc/guix.texi b/doc/guix.texi
index 7cda06d..a9ca02f 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -1774,6 +1774,11 @@ on a machine.  Guix, as a package manager, can
 also be installed on top of a running GNU/Linux system,
 @pxref{Installation}.
 
address@hidden Important Note
address@hidden Graphical Installation}, on how to work around a bug that affects
+the graphical installer in version 1.0.0.
address@hidden quotation
+
 @ifinfo
 @quotation Note
 @c This paragraph is for people reading this from tty2 of the
@@ -1992,6 +1997,57 @@ dependencies of your system configuration can be 
downloaded.  See the
 The graphical installer is a text-based user interface.  It will guide you,
 with dialog boxes, through the steps needed to install address@hidden System.
 
address@hidden Important Note
+Due to a @uref{https://issues.guix.info/issue/35541, bug}, the graphical
+installer of Guix 1.0.0 may produce a system configuration where essential
+commands such as @command{ls} or @command{grep} are missing; as a side effect,
+it also prevents logging in into Xfce.  A new release will be published in the
+coming weeks.  Here is how you can work around it in the meantime on your
+freshly installed system:
+
address@hidden
address@hidden
+Install packages that provide those commands, along with the text editor of
+your choice (for example, @code{emacs} or @code{vim}):
+
address@hidden
+guix install coreutils findutils grep procps sed emacs vim
address@hidden example
+
+At this point, the essential commands you would expect are available.
+
address@hidden
+Open your configuration file with your editor of choice, for example
address@hidden, running as root:
+
address@hidden
+sudo emacs /etc/config.scm
address@hidden example
+
address@hidden
+Change the @code{packages} field to add the ``base packages'' to the list of
+globally-installed packages, such that your configuration looks like this:
+
address@hidden
+(operating-system
+  ;; ... snip ...
+  (packages (append (list (specification->package "nss-certs"))
+                    %base-packages))
+  ;; ... snip ...
+  )
address@hidden lisp
+
address@hidden
+Reconfigure the system so that your new configuration is in effect:
+
address@hidden
+guix pull && sudo guix system reconfigure /etc/config.scm
address@hidden example
address@hidden itemize
+
+We apologize for this embarrassing mistake.
address@hidden quotation
+
 The first dialog boxes allow you to set up the system as you use it during the
 installation: you can choose the language, keyboard layout, and set up
 networking, which will be used during the installation.  The image below shows