[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
32/64: Simplify quick start section
From: |
Ludovic Courtès |
Subject: |
32/64: Simplify quick start section |
Date: |
Mon, 05 Jan 2015 16:39:01 +0000 |
civodul pushed a commit to branch nix
in repository guix.
commit e0a947cde6d11b5182500f024719b04b8997189a
Author: Eelco Dolstra <address@hidden>
Date: Tue Apr 8 16:28:39 2014 +0200
Simplify quick start section
---
doc/manual/quick-start.xml | 57 ++++++++-----------------------------------
1 files changed, 11 insertions(+), 46 deletions(-)
diff --git a/doc/manual/quick-start.xml b/doc/manual/quick-start.xml
index 779b9b9..1707990 100644
--- a/doc/manual/quick-start.xml
+++ b/doc/manual/quick-start.xml
@@ -11,56 +11,22 @@ to the following chapters.</para>
<orderedlist>
-<listitem><para>Download a source tarball or RPM or Debian/Ubuntu
-package from <link xlink:href='http://nixos.org/'/>. Build source
-distributions using the regular sequence:
+<listitem><para>Install Nix by running the following:
<screen>
-$ tar xvfj nix-<replaceable>version</replaceable>.tar.bz2
-$ cd nix-<replaceable>version</replaceable>
-$ ./configure
-$ make
-$ make install <lineannotation>(as root)</lineannotation></screen>
-
-This will install the Nix binaries in <filename>/usr/local</filename>
-and keep the Nix store and other state in <filename>/nix</filename>.
-You can change the former by specifying
-<option>--prefix=<replaceable>path</replaceable></option>. The
-location of the store can be changed using
-<option>--with-store-dir=<replaceable>path</replaceable></option>.
-However, you shouldn't change the store location, if at all possible,
-since that will make it impossible to use pre-built binaries from the
-Nixpkgs channel and other channels. The location of the state can be
-changed using
-<option>--localstatedir=<replaceable>path</replaceable>.</option></para></listitem>
-
-<listitem><para>You should add
-<filename><replaceable>prefix</replaceable>/etc/profile.d/nix.sh</filename>
-to your <filename>~/.profile</filename> (or some other login
-file).</para></listitem>
-
-<listitem><para>Subscribe to the Nix Packages channel.
+$ bash <(curl https://nixos.org/nix/install)
+</screen>
-<screen>
-$ nix-channel --add http://nixos.org/channels/nixpkgs-unstable</screen>
-
-</para></listitem>
-
-<listitem><para>Download the latest Nix expressions available in the channel.
-<screen>
-$ nix-channel --update</screen>
-
-Note that this in itself doesn't download any packages, it just
-downloads the Nix expressions that build them and stores them
-somewhere (under <filename>~/.nix-defexpr</filename>, in case you're
-curious). Also, it registers the fact that pre-built binaries are
-available remotely.</para></listitem>
+This will install Nix in <filename>/nix</filename>. The install script
+will create <filename>/nix</filename> using <command>sudo</command>,
+so make sure you have sufficient rights. (For other installation
+methods, see <xref linkend="chap-installation"/>.)</para></listitem>
<listitem><para>See what installable packages are currently available
in the channel:
<screen>
-$ nix-env -qa \*
+$ nix-env -qa
docbook-xml-4.2
firefox-1.0pre-PR-0.10.1
hello-2.1.1
@@ -72,7 +38,7 @@ libxslt-1.1.0
<listitem><para>Install some packages from the channel:
<screen>
-$ nix-env -i hello firefox <replaceable>...</replaceable> </screen>
+$ nix-env -i hello <replaceable>...</replaceable> </screen>
This should download pre-built packages; it should not build them
locally (if it does, something went wrong).</para></listitem>
@@ -84,8 +50,7 @@ $ which hello
/home/eelco/.nix-profile/bin/hello
$ hello
Hello, world!
-$ firefox
-<lineannotation>(read Slashdot or something)</lineannotation></screen>
+</screen>
</para></listitem>
@@ -99,7 +64,7 @@ $ nix-env -e hello</screen>
<listitem><para>To keep up-to-date with the channel, do:
<screen>
-$ nix-channel --update
+$ nix-channel --update nixpkgs
$ nix-env -u '*'</screen>
The latter command will upgrade each installed package for which there
- 35/64: Don't barf when installing as root, (continued)
- 35/64: Don't barf when installing as root, Ludovic Courtès, 2015/01/05
- 31/64: Remove redundant stuff, Ludovic Courtès, 2015/01/05
- 24/64: Show position info in Boolean operations, Ludovic Courtès, 2015/01/05
- 38/64: Fix test evaluation, Ludovic Courtès, 2015/01/05
- 34/64: Add docbook icons to the distribution, Ludovic Courtès, 2015/01/05
- 37/64: Bump date, Ludovic Courtès, 2015/01/05
- 39/64: nix-env: Minor change to '--delete-generations Nd' semantics, Ludovic Courtès, 2015/01/05
- 33/64: If a .drv cannot be parsed, show its path, Ludovic Courtès, 2015/01/05
- 40/64: trunk -> master, Ludovic Courtès, 2015/01/05
- 17/64: Pass position information to primop calls, Ludovic Courtès, 2015/01/05
- 32/64: Simplify quick start section,
Ludovic Courtès <=
- 43/64: Set build-max-jobs to the number of available cores by default, Ludovic Courtès, 2015/01/05
- 41/64: doc fix: swap 'import' and 'export', Ludovic Courtès, 2015/01/05
- 28/64: Ensure that systemd units to into lib, not lib64, Ludovic Courtès, 2015/01/05
- 36/64: Bump version to 1.8, Ludovic Courtès, 2015/01/05
- 44/64: Install an Upstart service, Ludovic Courtès, 2015/01/05
- 45/64: Set up directories and permissions for multi-user install automatically, Ludovic Courtès, 2015/01/05
- 46/64: Simplify multi-user installation instructions, Ludovic Courtès, 2015/01/05
- 49/64: Add ubuntu 14.04, Ludovic Courtès, 2015/01/05
- 48/64: Don't install Upstart job on Fedora, Ludovic Courtès, 2015/01/05
- 51/64: Really fix the RPM builds, Ludovic Courtès, 2015/01/05