[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
01/01: doc: Recommend using the installer script.
From: |
guix-commits |
Subject: |
01/01: doc: Recommend using the installer script. |
Date: |
Tue, 8 Jan 2019 12:49:20 -0500 (EST) |
rekado pushed a commit to branch master
in repository guix.
commit 6df4d8338d2bf94ab729e3b12e42ace0a06687ae
Author: Ricardo Wurmus <address@hidden>
Date: Tue Jan 8 18:47:38 2019 +0100
doc: Recommend using the installer script.
* doc/guix.texi (Installation): Make it clear that the installer script is
the
recommended, easy way to install Guix.
---
doc/guix.texi | 46 +++++++++++++++++++++++++---------------------
1 file changed, 25 insertions(+), 21 deletions(-)
diff --git a/doc/guix.texi b/doc/guix.texi
index fcb5b8c..9665416 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -25,7 +25,7 @@ Copyright @copyright{} 2015, 2016 Mathieu address@hidden
Copyright @copyright{} 2014 Pierre-Antoine address@hidden
Copyright @copyright{} 2015 Taylan Ulrich Bayırlı/address@hidden
Copyright @copyright{} 2015, 2016, 2017 Leo address@hidden
-Copyright @copyright{} 2015, 2016, 2017, 2018 Ricardo address@hidden
+Copyright @copyright{} 2015, 2016, 2017, 2018, 2019 Ricardo address@hidden
Copyright @copyright{} 2016 Ben address@hidden
Copyright @copyright{} 2016, 2017, 2018 Chris address@hidden
Copyright @copyright{} 2016, 2017, 2018 Efraim address@hidden
@@ -394,29 +394,34 @@ garbage collection of packages (@pxref{Features}).
@chapter Installation
@cindex installing Guix
address@hidden official website
-GNU Guix is available for download from its website at
address@hidden://www.gnu.org/software/guix/}. This section describes the
-software requirements of Guix, as well as how to install it and get
-ready to use it.
-Note that this section is concerned with the installation of the package
-manager, which can be done on top of a running GNU/Linux system. If,
-instead, you want to install the complete GNU operating system,
address@hidden Installation}.
address@hidden Note
+We recommend the use of this
address@hidden://git.savannah.gnu.org/cgit/guix.git/plain/etc/guix-install.sh,
+shell installer script} to install Guix on top of a running GNU/Linux system,
+thereafter called a @dfn{foreign address@hidden section is concerned
+with the installation of the package manager, which can be done on top of a
+running GNU/Linux system. If, instead, you want to install the complete GNU
+operating system, @pxref{System Installation}.} The script automates the
+download, installation, and initial configuration of Guix. It should be run
+as the root user.
address@hidden quotation
@cindex foreign distro
@cindex directories related to foreign distro
-
-When installed on a running GNU/Linux system---thereafter called a
address@hidden address@hidden complements the available tools
-without interference. Its data lives exclusively in two directories,
-usually @file{/gnu/store} and @file{/var/guix}; other files on your
-system, such as @file{/etc}, are left untouched.
+When installed on a foreign distro, address@hidden complements the available
+tools without interference. Its data lives exclusively in two directories,
+usually @file{/gnu/store} and @file{/var/guix}; other files on your system,
+such as @file{/etc}, are left untouched.
Once installed, Guix can be updated by running @command{guix pull}
(@pxref{Invoking guix pull}).
+If you prefer to perform the installation steps manually or want to tweak
+them, you may find the following subsections useful. They describe the
+software requirements of Guix, as well as how to install it manually and get
+ready to use it.
+
@menu
* Binary Installation:: Getting Guix running in no time!
* Requirements:: Software needed to build and run Guix.
@@ -437,11 +442,6 @@ dependencies. This is often quicker than installing from
source, which
is described in the next sections. The only requirement is to have
address@hidden and Xz.
-We provide a
address@hidden://git.savannah.gnu.org/cgit/guix.git/plain/etc/guix-install.sh,
-shell installer script}, which automates the download, installation, and
-initial configuration of Guix. It should be run as the root user.
-
Installing goes along these lines:
@enumerate
@@ -638,6 +638,10 @@ build procedure for Guix is the same as for other GNU
software, and is
not covered here. Please see the files @file{README} and @file{INSTALL}
in the Guix source tree for additional details.
address@hidden official website
+GNU Guix is available for download from its website at
address@hidden://www.gnu.org/software/guix/}.
+
GNU Guix depends on the following packages:
@itemize