aboutsummaryrefslogtreecommitdiff
path: root/src/nix/profile-history.md
diff options
context:
space:
mode:
authorEelco Dolstra <edolstra@gmail.com>2021-01-12 23:51:07 +0100
committerEelco Dolstra <edolstra@gmail.com>2021-01-12 23:53:53 +0100
commit2f463e90ed077e066455a9ef6e024b18fd61c4de (patch)
tree084202dcb864fad2a0e2e681f4d16923bb32b0b0 /src/nix/profile-history.md
parent29007f8bc6ea42ae1f8311f00c0b5e14f04ec9e5 (diff)
Add 'nix profile history' command
Replaces 'nix-env --list-generations'. Similar to 'nix profile diff-closures' but shows only the changes in top-level packages.
Diffstat (limited to 'src/nix/profile-history.md')
-rw-r--r--src/nix/profile-history.md26
1 files changed, 26 insertions, 0 deletions
diff --git a/src/nix/profile-history.md b/src/nix/profile-history.md
new file mode 100644
index 000000000..d0fe40c82
--- /dev/null
+++ b/src/nix/profile-history.md
@@ -0,0 +1,26 @@
+R""(
+
+# Examples
+
+* Show the changes between each version of your default profile:
+
+ ```console
+ # nix profile history
+ Version 508 -> 509:
+ flake:nixpkgs#legacyPackages.x86_64-linux.awscli: ∅ -> 1.17.13
+
+ Version 509 -> 510:
+ flake:nixpkgs#legacyPackages.x86_64-linux.awscli: 1.17.13 -> 1.18.211
+ ```
+
+# Description
+
+This command shows what packages were added, removed or upgraded
+between subsequent versions of a profile. It only shows top-level
+packages, not dependencies; for that, use [`nix profile
+diff-closures`](./nix3-profile-diff-closures.md).
+
+The addition of a package to a profile is denoted by the string `∅ ->`
+*version*, whereas the removal is denoted by *version* `-> ∅`.
+
+)""