diff options
author | Eelco Dolstra <eelco.dolstra@logicblox.com> | 2014-11-24T13·53+0100 |
---|---|---|
committer | Eelco Dolstra <eelco.dolstra@logicblox.com> | 2014-11-24T15·50+0100 |
commit | 2b74354e5226cda44aa23e8868aaecba6f6250d8 (patch) | |
tree | cd80fcff91a0bb380b43990d292bb02ff468b25a /doc/manual/quick-start | |
parent | 5e04992d1fad02b298e83f184480b6788bc200d6 (diff) |
Combine introduction / quick start parts
Diffstat (limited to 'doc/manual/quick-start')
-rw-r--r-- | doc/manual/quick-start/getting-started.xml | 108 | ||||
-rw-r--r-- | doc/manual/quick-start/quick-start.xml | 17 |
2 files changed, 0 insertions, 125 deletions
diff --git a/doc/manual/quick-start/getting-started.xml b/doc/manual/quick-start/getting-started.xml deleted file mode 100644 index 3dc79b9b52d5..000000000000 --- a/doc/manual/quick-start/getting-started.xml +++ /dev/null @@ -1,108 +0,0 @@ -<chapter xmlns="http://docbook.org/ns/docbook" - xmlns:xlink="http://www.w3.org/1999/xlink" - xmlns:xi="http://www.w3.org/2001/XInclude" - version="5.0" - xml:id="ch-getting-started-nix"> - -<title>Getting Started with Nix</title> - -<para>This tutorial takes you through the basic tasks you might perform when you start using Nix.</para> -<procedure> - -<step><para>Install single-user Nix by running the following: - -<screen> -$ curl https://nixos.org/nix/install | sh -</screen> - -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></step> - -<step><para>See what installable packages are currently available -in the channel: - -<screen> -$ nix-env -qa -docbook-xml-4.2 -firefox-1.0pre-PR-0.10.1 -hello-2.1.1 -libxslt-1.1.0 -<replaceable>...</replaceable></screen> - -</para></step> - -<step><para>Install some packages from the channel: - -<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></step> - -<step><para>Test that they work: - -<screen> -$ which hello -/home/eelco/.nix-profile/bin/hello -$ hello -Hello, world! -</screen> - -</para></step> - -<step><para>Uninstall a package: - -<screen> -$ nix-env -e hello</screen> - -</para></step> - -<step><para>To keep up-to-date with the channel, do: - -<screen> -$ nix-channel --update nixpkgs -$ nix-env -u '*'</screen> - -The latter command will upgrade each installed package for which there -is a “newer” version (as determined by comparing the version -numbers).</para></step> - -<step><para>You can also install specific packages directly from -your web browser. For instance, you can go to <link -xlink:href="http://hydra.nixos.org/jobset/nixpkgs/trunk/channel/latest" -/> and click on any link for the individual packages for your -platform. Associate <literal>application/nix-package</literal> with -the program <command>nix-install-package</command>. A window should -appear asking you whether it’s okay to install the package. Say -<literal>Y</literal>. The package and all its dependencies will be -installed.</para></step> - -<step><para>If you're unhappy with the result of a -<command>nix-env</command> action (e.g., an upgraded package turned -out not to work properly), you can go back: - -<screen> -$ nix-env --rollback</screen> - -</para></step> - -<step><para>You should periodically run the Nix garbage collector -to get rid of unused packages, since uninstalls or upgrades don't -actually delete them: - -<screen> -$ nix-collect-garbage -d</screen> - -<!-- -The first command deletes old “generations” of your profile (making -rollbacks impossible, but also making the packages in those old -generations available for garbage collection), while the second -command actually deletes them.--> - -</para></step> - -</procedure> - -</chapter> diff --git a/doc/manual/quick-start/quick-start.xml b/doc/manual/quick-start/quick-start.xml deleted file mode 100644 index b4757cb22043..000000000000 --- a/doc/manual/quick-start/quick-start.xml +++ /dev/null @@ -1,17 +0,0 @@ -<part xmlns="http://docbook.org/ns/docbook" - xmlns:xlink="http://www.w3.org/1999/xlink" - xmlns:xi="http://www.w3.org/2001/XInclude" - version="5.0" - xml:id="chap-quick-start"> - -<title>Quick-Start</title> - -<partintro> -<para>This section is for impatient people who don't like reading -documentation. For more in-depth information you are kindly referred -to subsequent chapters.</para> -</partintro> - -<xi:include href="getting-started.xml" /> - -</part> |