Nix Profile History Command

src/nix/profile-history.md

5195e00a671408ebec11fa499be981a54bf8cce6f5d911f200000003000002db

R""(

# Examples

* Show the changes between each version of your default profile:

  ```console
  # nix profile history
  Version 508 (2020-04-10):
    flake:nixpkgs#legacyPackages.x86_64-linux.awscli: ∅ -> 1.17.13

  Version 509 (2020-05-16) <- 508:
    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* `-> ∅`.

)""

Chunks

e0343a00 (1st chunk of `src/nix/profile-history.md`)

Title: Nix Profile History Command

Summary

The `nix profile history` command is used to display the changes in top-level packages between successive versions of a Nix profile. It shows when packages were added (denoted by `∅ -> version`), removed (denoted by `version -> ∅`), or upgraded (old version -> new version), along with the date of each version. This command focuses only on top-level packages; for changes involving dependencies, the `nix profile diff-closures` command is recommended.