about summary refs log tree commit diff
path: root/src/nix-env/help.txt
diff options
context:
space:
mode:
authorEelco Dolstra <e.dolstra@tudelft.nl>2005-10-06T14·44+0000
committerEelco Dolstra <e.dolstra@tudelft.nl>2005-10-06T14·44+0000
commitb87b9c0d1fcbce045f05379d0efe9ae14d0f87e6 (patch)
treed9c7f0206d5652c0c5c5cca3f77ebdc0b8385887 /src/nix-env/help.txt
parent0e0041b2b674e94ae7846474c536ad49239f9e36 (diff)
* New query option: `--compare-versions' or `-c' to compare installed
  versions to available versions, or vice versa.

  For example, the following compares installed versions to available
  versions:

    $ nix-env -qc
    autoconf-2.59            = 2.59
    automake-1.9.4           < 1.9.6
    f-spot-0.0.10            - ?
    firefox-1.0.4            < 1.0.7
    ...

  I.e., there are newer versions available (in the current default Nix
  expression) for Automake and Firefox, but not for Autoconf, and
  F-Spot is missing altogether.

  Conversely, the available versions can be compared to the installed
  versions:

    $ nix-env -qac
    autoconf-2.59                  = 2.59
    automake-1.9.6                 > 1.9.4
    bash-3.0                       - ?
    firefox-1.0.7                  > 1.0.4
    ...

  Note that bash is available but no version of it is installed.

  If multiple versions are available for comparison, then the highest
  is used.  E.g., if Subversion 1.2.0 is installed, and Subversion
  1.1.4 and 1.2.3 are available, then `nix-env -qc' will print `<
  1.2.3', not `> 1.1.4'.

  If higher versions are available, the version column is printed in
  red (using ANSI escape codes).

Diffstat (limited to 'src/nix-env/help.txt')
-rw-r--r--src/nix-env/help.txt6
1 files changed, 4 insertions, 2 deletions
diff --git a/src/nix-env/help.txt b/src/nix-env/help.txt
index 4fc1602840c4..6ca5b3a3b862 100644
--- a/src/nix-env/help.txt
+++ b/src/nix-env/help.txt
@@ -36,10 +36,12 @@ Upgrade flags:
 
 Query types:
 
-  --name: print derivation names (default)
+  --status / -s: print installed/present status
+  --no-name: hide derivation names
+  --system: print the platform type of the derivation 
+  --compare-versions / -c: compare version to available or installed
   --drv-path: print path of derivation
   --out-path: print path of derivation output
-  --status / -s: print installed/present status
 
 Query sources: