.\" -*- mode: troff; coding: utf-8 -*-
.TH "nix3-profile-history" "1" ""
.PP
\fBWarning\fR: This program is \fBexperimental\fR and its interface is subject to change.
.SH Name
\fCnix profile history\fR - show all versions of a profile
.SH Synopsis
\fCnix profile history\fR [\fIoption\fR\[u2026]] 
.SH Examples
.IP "\(bu" 2
Show the changes between each version of your default profile:
.LP
.EX
# 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
.EE
.SH 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 \fB\fCnix profile
diff-closures\fR\fR (\fI./nix3-profile-diff-closures.md\fR).
.PP
The addition of a package to a profile is denoted by the string \fC∅ ->\fR
\fIversion\fR, whereas the removal is denoted by \fIversion\fR \fC-> ∅\fR.
.SH Options
.IP "\(bu" 2
\fC--profile\fR \fIpath\fR
.br
The profile to update.
.LP
\fBCommon evaluation options:\fR
.IP "\(bu" 2
\fC--arg\fR \fIname\fR \fIexpr\fR
.br
Pass the value \fIexpr\fR as the argument \fIname\fR to Nix functions.
.IP "\(bu" 2
\fC--argstr\fR \fIname\fR \fIstring\fR
.br
Pass the string \fIstring\fR as the argument \fIname\fR to Nix functions.
.IP "\(bu" 2
\fC--eval-store\fR \fIstore-url\fR
.br
The Nix store to use for evaluations.
.IP "\(bu" 2
\fC--impure\fR
.br
Allow access to mutable paths and repositories.
.IP "\(bu" 2
\fC--include\fR / \fC-I\fR \fIpath\fR
.br
Add \fIpath\fR to the list of locations used to look up \fC<...>\fR file names.
.IP "\(bu" 2
\fC--override-flake\fR \fIoriginal-ref\fR \fIresolved-ref\fR
.br
Override the flake registries, redirecting \fIoriginal-ref\fR to \fIresolved-ref\fR.