From 070e07ed5aeac9918b9ec4cb6944f31b2b1aeeae Mon Sep 17 00:00:00 2001 From: Eelco Dolstra Date: Fri, 29 Sep 2006 11:03:16 +0000 Subject: [PATCH] * Manual. --- doc/manual/installation.xml | 14 ++++++++++++++ doc/manual/nix-collect-garbage.xml | 28 ++++++++++++++++++++++++---- doc/manual/package-management.xml | 24 ++++++++++++++++++++++-- doc/manual/quick-start.xml | 10 ++++++++++ 4 files changed, 70 insertions(+), 6 deletions(-) diff --git a/doc/manual/installation.xml b/doc/manual/installation.xml index ef056058d..093ac745f 100644 --- a/doc/manual/installation.xml +++ b/doc/manual/installation.xml @@ -148,6 +148,20 @@ $ rm -rf /nix/var +
Upgrading Nix through Nix + +You can install the latest stable version of Nix through Nix +itself by subscribing to the channel , +or the latest unstable version by subscribing to the channel. +You can also do a one-click +installation by clicking on the package links at . + +
+ +
Permissions All Nix operations must be performed under the user ID that owns diff --git a/doc/manual/nix-collect-garbage.xml b/doc/manual/nix-collect-garbage.xml index 73739182d..9dd9b664d 100644 --- a/doc/manual/nix-collect-garbage.xml +++ b/doc/manual/nix-collect-garbage.xml @@ -9,6 +9,8 @@ nix-collect-garbage + + @@ -20,10 +22,28 @@ Description -The command nix-collect-garbage is an -obsolete wrapper around nix-store ---gc. +The command nix-collect-garbage is mostly an +alias of nix-store +--gc, that is, it deletes all unreachable paths in +the Nix store to clean up your system. However, it provides an +additional option () +that deletes all old generations of all profiles in +/nix/var/nix/profiles by invoking +nix-env --delete-generations old on all profiles. +Of course, this makes rollbacks to previous configurations +impossible. + + + +Example + +To delete from the Nix store everything that is not used by the +current generations of each profile, do + + +$ nix-collect-garbage -d + + diff --git a/doc/manual/package-management.xml b/doc/manual/package-management.xml index 2b2e04c11..f916d21f3 100644 --- a/doc/manual/package-management.xml +++ b/doc/manual/package-management.xml @@ -44,7 +44,7 @@ xlink:href='http://nix.cs.uu.nl/dist/nix' />. Packages, you can view the set of available components in the release: -$ nix-env -qaf nixpkgs-version +$ nix-env -qaf nixpkgs-version '*' ant-blackdown-1.4.2 aterm-2.2 bash-3.0 @@ -62,7 +62,7 @@ available components, i.e., whether they are installed into the user environment and/or present in the system: -$ nix-env -qasf nixpkgs-version +$ nix-env -qasf nixpkgs-version '*' ... -PS bash-3.0 --S binutils-2.15 @@ -382,6 +382,19 @@ $ nix-store --gc --print-dead Likewise, the option will show the paths that won’t be deleted. +There is also a convenient little utility +nix-collect-garbage, which when invoked with the + () switch deletes all +old generations of all profiles in +/nix/var/nix/profiles. So + + +$ nix-collect-garbage -d + +is a quick and easy way to clean up your system. + + +
Garbage collector roots @@ -463,4 +476,11 @@ available in the subscribed channels.
+
One-click installations + +TODO + +
+ + diff --git a/doc/manual/quick-start.xml b/doc/manual/quick-start.xml index a89ac9336..c4065ace1 100644 --- a/doc/manual/quick-start.xml +++ b/doc/manual/quick-start.xml @@ -96,6 +96,16 @@ The latter command will upgrade each installed component for which there is a “newer” version (as determined by comparing the version numbers). +You can also install specific packages directly from +your web browser. For instance, you can go to +and click on any link for the individual packages for your platform. +Associate application/nix-package with the program +/nix/bin/nix-install-package. A window should +appear asking you whether it’s okay to install the package. Say +Y. The package and all its dependencies will be +installed. + If you're unhappy with the result of a nix-env action (e.g., an upgraded component turned out not to work properly), you can go back: