From 3c7ec8fc1b1fe3c3bf48b957c2aafa6c3ea6d846 Mon Sep 17 00:00:00 2001 From: Peter Simons Date: Thu, 1 Dec 2011 08:02:37 +0000 Subject: [PATCH] doc/manual/nix-env.xml: stripped trailing whitespace --- doc/manual/nix-env.xml | 200 ++++++++++++++++++++--------------------- 1 file changed, 100 insertions(+), 100 deletions(-) diff --git a/doc/manual/nix-env.xml b/doc/manual/nix-env.xml index 403ab26782..a6b5964086 100644 --- a/doc/manual/nix-env.xml +++ b/doc/manual/nix-env.xml @@ -2,7 +2,7 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude" xml:id="sec-nix-env"> - + nix-env 1 @@ -60,7 +60,7 @@ environments. nix-env takes exactly one operation flag which indicates the subcommand to be performed. These are documented below. - + @@ -78,19 +78,19 @@ linkend="sec-common-options" />. - + Specifies the Nix expression (designated below as the active Nix expression) used by the , , and operations to obtain derivations. The default is ~/.nix-defexpr. - + - + - + Specifies the profile to be used by those operations that operate on a profile (designated below as the active profile). A profile is sequence of @@ -98,11 +98,11 @@ linkend="sec-common-options" />. which is the current generation. The default profile is the target of the symbolic link ~/.nix-profile (see below). - + - + - + For the , , , and @@ -117,23 +117,23 @@ linkend="sec-common-options" />. substitute is available). - + system - + By default, operations such as only include derivations matching the current platform. This option allows you to use derivations for the specified platform system. The special value * causes derivations for any platform to be included. - + - + @@ -170,25 +170,25 @@ linkend="sec-common-options" />. this directory. - + ~/.nix-profile - + A symbolic link to the user's current profile. By default, this symlink points to prefix/var/nix/profiles/default. The PATH environment variable should include ~/.nix-profile/bin for the user environment to be visible to the user. - + - + - + @@ -214,7 +214,7 @@ linkend="sec-common-options" />. Description - + The install operation creates a new user environment, based on the current generation of the active profile, to which a set of store paths described by args is added. The @@ -306,20 +306,20 @@ number of possible ways: - + Do not remove derivations with a name matching one of the derivations being installed. Usually, trying to have two versions of the same package installed in the same generation of a profile will lead to an error in building the generation, due to file name clashes between the two versions. However, this is not the case for all packages. - + - + Examples @@ -327,7 +327,7 @@ number of possible ways: active Nix expression: -$ nix-env --install gcc-3.3.2 +$ nix-env --install gcc-3.3.2 installing `gcc-3.3.2' uninstalling `gcc-3.1' @@ -408,15 +408,15 @@ the following paths will be substituted: /nix/store/8zbipvm4gp9jfqh9nnk1n3bary1a37gs-perl-XML-Parser-2.34 /nix/store/b8a2bg7gnyvvvjjibp4axg9x1hzkw36c-mono-1.1.4 ... - + - + - + Operation <option>--upgrade</option> @@ -442,7 +442,7 @@ the following paths will be substituted: Description - + The upgrade operation creates a new user environment, based on the current generation of the active profile, in which all store paths are replaced for which there are newer versions in the set of paths @@ -459,47 +459,47 @@ the same symbolic name, only the one with the highest version is installed. - + Flags - + Only upgrade a derivation to newer versions. This is the default. - + - + In addition to upgrading to newer versions, also “upgrade” to derivations that have the same version. Version are not a unique identification of a derivation, so there may be many derivations that have the same version. This flag may be useful to force “synchronisation” between the installed and available derivations. - + - + Only “upgrade” to derivations that have the same version. This may not seem very useful, but it actually is, e.g., when there is a new release of Nixpkgs and you want to replace installed applications with the same versions built against newer dependencies (to reduce the number of dependencies floating around on your system). - + - + In addition to upgrading to newer versions, also “upgrade” to derivations that have the same or a lower version. I.e., derivations may actually be downgraded depending on what is available in the active Nix expression. - + @@ -523,10 +523,10 @@ $ nix-env --upgrade pan $ nix-env -u '*' (try to upgrade everything) upgrading `hello-2.1.2' to `hello-2.1.3' -upgrading `mozilla-1.2' to `mozilla-1.4' +upgrading `mozilla-1.2' to `mozilla-1.4' - + Versions The upgrade operation determines whether a derivation @@ -570,14 +570,14 @@ lexicographically (i.e., using case-sensitive string comparison). 2.3a < 2.3c 2.3pre1 < 2.3c 2.3pre1 < 2.3q - + - + - + @@ -596,14 +596,14 @@ lexicographically (i.e., using case-sensitive string comparison). Description - + The uninstall operation creates a new user environment, based on the current generation of the active profile, from which the store paths designated by the symbolic names names are removed. - + Examples @@ -611,11 +611,11 @@ $ nix-env --uninstall gcc $ nix-env -e '*' (remove everything) - + - + Operation <option>--set-flag</option> @@ -632,7 +632,7 @@ $ nix-env -e '*' (remove everything) Description - + The operation allows meta attributes of installed packages to be modified. There are several attributes that can be usefully modified, because they affect the behaviour of @@ -670,7 +670,7 @@ script: - + Examples To prevent the currently installed Firefox from being upgraded: @@ -716,13 +716,13 @@ $ nix-env --set-flag priority 10 gcc - + - + - + Operation <option>--query</option> Synopsis @@ -738,9 +738,9 @@ $ nix-env --set-flag priority 10 gcc - + - + @@ -785,7 +785,7 @@ $ nix-env --set-flag priority 10 gcc - + names @@ -793,7 +793,7 @@ $ nix-env --set-flag priority 10 gcc Description - + The query operation displays information about either the store paths that are installed in the current generation of the active profile (), or the derivations that are @@ -817,23 +817,23 @@ operates. - + The query operates on the store paths that are installed in the current generation of the active profile. This is the default. - + - + The query operates on the derivations that are available in the active Nix expression. - + - + @@ -874,7 +874,7 @@ user environment elements, etc. --> - + Print the status of the derivation. The status consists of three characters. The first is I or -, indicating @@ -888,7 +888,7 @@ user environment elements, etc. --> third is S or -, indicating whether a substitute is available for the derivation. - + @@ -901,17 +901,17 @@ user environment elements, etc. --> nix-env --install. - + - + Suppress printing of the name attribute of each derivation. - + / - + Compare installed versions to available versions, or vice versa (if is given). This is useful for quickly seeing whether upgrades for installed @@ -926,21 +926,21 @@ user environment elements, etc. --> or installed. - + = version At most the same version of the package is available or installed. - + > version Only older versions of the package are available or installed. - + - ? No version of the package is available or @@ -951,45 +951,45 @@ user environment elements, etc. --> - + - + Print the system attribute of the derivation. - + - + Print the path of the store derivation. - + - + Print the output path of the derivation. - + - + Print a short (one-line) description of the derivation, if available. The description is taken from the meta.description attribute of the derivation. - + - + Print all of the meta-attributes of the derivation. This option is only available with . - + @@ -1023,7 +1023,7 @@ IP- ORBit2-2.8.3 (installed and by definition present)(show available derivations in the Nix expression foo.nix) -$ nix-env -f ./foo.nix -qa '*' +$ nix-env -f ./foo.nix -qa '*' foo-1.2.3 $ nix-env -qc '*' (compare installed versions to what’s available) @@ -1034,7 +1034,7 @@ firefox-1.0.4 < 1.0.7 (a more recent version is availab ... (show info about a specific package, in XML) -$ nix-env -qa --xml --description firefox +$ nix-env -qa --xml --description firefox - - + + @@ -1067,25 +1067,25 @@ $ nix-env -qa --xml --description firefox Description - + This operation makes path the current profile for the user. That is, the symlink ~/.nix-profile is made to point to path. - + Examples $ nix-env -S ~/my-profile - + - + Operation <option>--list-generations</option> @@ -1101,7 +1101,7 @@ $ nix-env -S ~/my-profile Description - + This operation print a list of all the currently existing generations for the active profile. These may be switched to using the operation. It also prints @@ -1121,11 +1121,11 @@ $ nix-env --list-generations 98 2004-02-06 16:24:33 (current) - + - + Operation <option>--delete-generations</option> @@ -1142,7 +1142,7 @@ $ nix-env --list-generations Description - + This operation deletes the specified generations of the current profile. The generations can be a list of generation numbers, or the special value old to delete all non-current @@ -1150,7 +1150,7 @@ generations. Periodically deleting old generations is important to make garbage collection effective. - + Examples @@ -1159,11 +1159,11 @@ $ nix-env --delete-generations 3 4 8 $ nix-env -p other_profile --delete-generations old - + - + Operation <option>--switch-generation</option> @@ -1183,7 +1183,7 @@ $ nix-env -p other_profile --delete-generations old Description - + This operation makes generation number generation the current generation of the active profile. That is, if the @@ -1207,11 +1207,11 @@ $ nix-env -G 42 switching from generation 50 to 42 - + - + Operation <option>--rollback</option> @@ -1226,7 +1226,7 @@ switching from generation 50 to 42 Description - + This operation switches to the “previous” generation of the active profile, that is, the highest numbered generation lower than the current generation, if it exists. It is just a convenience @@ -1246,9 +1246,9 @@ $ nix-env --rolback error: no generation older than the current (91) exists - + - +