aboutsummaryrefslogtreecommitdiff
path: root/doc/manual/src
diff options
context:
space:
mode:
Diffstat (limited to 'doc/manual/src')
-rw-r--r--doc/manual/src/command-ref/conf-file.md.tmp52
-rw-r--r--doc/manual/src/command-ref/nix.md3021
-rw-r--r--doc/manual/src/expressions/builtins.md.tmp16
3 files changed, 3089 insertions, 0 deletions
diff --git a/doc/manual/src/command-ref/conf-file.md.tmp b/doc/manual/src/command-ref/conf-file.md.tmp
new file mode 100644
index 000000000..93d52069b
--- /dev/null
+++ b/doc/manual/src/command-ref/conf-file.md.tmp
@@ -0,0 +1,52 @@
+# Name
+
+`nix.conf` - Nix configuration file
+
+# Description
+
+By default Nix reads settings from the following places:
+
+ - The system-wide configuration file `sysconfdir/nix/nix.conf` (i.e.
+ `/etc/nix/nix.conf` on most systems), or `$NIX_CONF_DIR/nix.conf` if
+ `NIX_CONF_DIR` is set. Values loaded in this file are not forwarded
+ to the Nix daemon. The client assumes that the daemon has already
+ loaded them.
+
+ - If `NIX_USER_CONF_FILES` is set, then each path separated by `:`
+ will be loaded in reverse order.
+
+ Otherwise it will look for `nix/nix.conf` files in `XDG_CONFIG_DIRS`
+ and `XDG_CONFIG_HOME`. If these are unset, it will look in
+ `$HOME/.config/nix.conf`.
+
+ - If `NIX_CONFIG` is set, its contents is treated as the contents of
+ a configuration file.
+
+The configuration files consist of `name = value` pairs, one per
+line. Other files can be included with a line like `include path`,
+where *path* is interpreted relative to the current conf file and a
+missing file is an error unless `!include` is used instead. Comments
+start with a `#` character. Here is an example configuration file:
+
+ keep-outputs = true # Nice for developers
+ keep-derivations = true # Idem
+
+You can override settings on the command line using the `--option`
+flag, e.g. `--option keep-outputs false`. Every configuration setting
+also has a corresponding command line flag, e.g. `--max-jobs 16`; for
+Boolean settings, there are two flags to enable or disable the setting
+(e.g. `--keep-failed` and `--no-keep-failed`).
+
+A configuration setting usually overrides any previous value. However,
+you can prefix the name of the setting by `extra-` to *append* to the
+previous value. For instance,
+
+ substituters = a b
+ extra-substituters = c d
+
+defines the `substituters` setting to be `a b c d`. This is also
+available as a command line flag (e.g. `--extra-substituters`).
+
+The following settings are currently available:
+
+EvalCommand::getEvalState()0
diff --git a/doc/manual/src/command-ref/nix.md b/doc/manual/src/command-ref/nix.md
new file mode 100644
index 000000000..acc7da3a6
--- /dev/null
+++ b/doc/manual/src/command-ref/nix.md
@@ -0,0 +1,3021 @@
+# Name
+
+`nix` - a tool for reproducible and declarative configuration management
+
+# Synopsis
+
+`nix` [*flags*...] *subcommand*
+
+# Flags
+
+ - `--debug`
+ enable debug output
+
+ - `--help`
+ show usage information
+
+ - `--help-config`
+ show configuration options
+
+ - `--log-format` *format*
+ format of log output; `raw`, `internal-json`, `bar` or `bar-with-logs`
+
+ - `--no-net`
+ disable substituters and consider all previously downloaded files up-to-date
+
+ - `--option` *name* *value*
+ set a Nix configuration option (overriding `nix.conf`)
+
+ - `--print-build-logs` / `L`
+ print full build logs on stderr
+
+ - `--quiet`
+ decrease verbosity level
+
+ - `--refresh`
+ consider all previously downloaded files out-of-date
+
+ - `--verbose` / `v`
+ increase verbosity level
+
+ - `--version`
+ show version information
+
+# Subcommand `nix add-to-store`
+
+## Name
+
+`nix add-to-store` - add a path to the Nix store
+
+## Synopsis
+
+`nix add-to-store` [*flags*...] *path*
+
+## Description
+
+
+Copy the file or directory *path* to the Nix store, and
+print the resulting store path on standard output.
+
+
+
+## Flags
+
+ - `--dry-run`
+ show what this command would do without doing it
+
+ - `--flat`
+ add flat file to the Nix store
+
+ - `--name` / `n` *name*
+ name component of the store path
+
+# Subcommand `nix build`
+
+## Name
+
+`nix build` - build a derivation or fetch a store path
+
+## Synopsis
+
+`nix build` [*flags*...] *installables*...
+
+## Flags
+
+ - `--arg` *name* *expr*
+ argument to be passed to Nix functions
+
+ - `--argstr` *name* *string*
+ string-valued argument to be passed to Nix functions
+
+ - `--commit-lock-file`
+ commit changes to the lock file
+
+ - `--derivation`
+ operate on the store derivation rather than its outputs
+
+ - `--dry-run`
+ show what this command would do without doing it
+
+ - `--expr` *expr*
+ evaluate attributes from *expr*
+
+ - `--file` / `f` *file*
+ evaluate *file* rather than the default
+
+ - `--impure`
+ allow access to mutable paths and repositories
+
+ - `--include` / `I` *path*
+ add a path to the list of locations used to look up `<...>` file names
+
+ - `--inputs-from` *flake-url*
+ use the inputs of the specified flake as registry entries
+
+ - `--no-link`
+ do not create a symlink to the build result
+
+ - `--no-registries`
+ don't use flake registries
+
+ - `--no-update-lock-file`
+ do not allow any updates to the lock file
+
+ - `--no-write-lock-file`
+ do not write the newly generated lock file
+
+ - `--out-link` / `o` *path*
+ path of the symlink to the build result
+
+ - `--override-flake` *original-ref* *resolved-ref*
+ override a flake registry value
+
+ - `--override-input` *input-path* *flake-url*
+ override a specific flake input (e.g. `dwarffs/nixpkgs`)
+
+ - `--profile` *path*
+ profile to update
+
+ - `--rebuild`
+ rebuild an already built package and compare the result to the existing store paths
+
+ - `--recreate-lock-file`
+ recreate lock file from scratch
+
+ - `--update-input` *input-path*
+ update a specific flake input
+
+## Examples
+
+To build and run GNU Hello from NixOS 17.03:
+
+```console
+nix build -f channel:nixos-17.03 hello; ./result/bin/hello
+```
+
+To build the build.x86_64-linux attribute from release.nix:
+
+```console
+nix build -f release.nix build.x86_64-linux
+```
+
+To make a profile point at GNU Hello:
+
+```console
+nix build --profile /tmp/profile nixpkgs#hello
+```
+
+# Subcommand `nix bundle`
+
+## Name
+
+`nix bundle` - bundle an application so that it works outside of the Nix store
+
+## Synopsis
+
+`nix bundle` [*flags*...] *installable*
+
+## Flags
+
+ - `--arg` *name* *expr*
+ argument to be passed to Nix functions
+
+ - `--argstr` *name* *string*
+ string-valued argument to be passed to Nix functions
+
+ - `--bundler` *flake-url*
+ use custom bundler
+
+ - `--commit-lock-file`
+ commit changes to the lock file
+
+ - `--derivation`
+ operate on the store derivation rather than its outputs
+
+ - `--expr` *expr*
+ evaluate attributes from *expr*
+
+ - `--file` / `f` *file*
+ evaluate *file* rather than the default
+
+ - `--impure`
+ allow access to mutable paths and repositories
+
+ - `--include` / `I` *path*
+ add a path to the list of locations used to look up `<...>` file names
+
+ - `--inputs-from` *flake-url*
+ use the inputs of the specified flake as registry entries
+
+ - `--no-registries`
+ don't use flake registries
+
+ - `--no-update-lock-file`
+ do not allow any updates to the lock file
+
+ - `--no-write-lock-file`
+ do not write the newly generated lock file
+
+ - `--out-link` / `o` *path*
+ path of the symlink to the build result
+
+ - `--override-flake` *original-ref* *resolved-ref*
+ override a flake registry value
+
+ - `--override-input` *input-path* *flake-url*
+ override a specific flake input (e.g. `dwarffs/nixpkgs`)
+
+ - `--recreate-lock-file`
+ recreate lock file from scratch
+
+ - `--update-input` *input-path*
+ update a specific flake input
+
+## Examples
+
+To bundle Hello:
+
+```console
+nix bundle hello
+```
+
+# Subcommand `nix cat-nar`
+
+## Name
+
+`nix cat-nar` - print the contents of a file inside a NAR file on stdout
+
+## Synopsis
+
+`nix cat-nar` [*flags*...] *nar* *path*
+
+# Subcommand `nix cat-store`
+
+## Name
+
+`nix cat-store` - print the contents of a file in the Nix store on stdout
+
+## Synopsis
+
+`nix cat-store` [*flags*...] *path*
+
+# Subcommand `nix copy`
+
+## Name
+
+`nix copy` - copy paths between Nix stores
+
+## Synopsis
+
+`nix copy` [*flags*...] *installables*...
+
+## Flags
+
+ - `--all`
+ apply operation to the entire store
+
+ - `--arg` *name* *expr*
+ argument to be passed to Nix functions
+
+ - `--argstr` *name* *string*
+ string-valued argument to be passed to Nix functions
+
+ - `--commit-lock-file`
+ commit changes to the lock file
+
+ - `--derivation`
+ operate on the store derivation rather than its outputs
+
+ - `--expr` *expr*
+ evaluate attributes from *expr*
+
+ - `--file` / `f` *file*
+ evaluate *file* rather than the default
+
+ - `--from` *store-uri*
+ URI of the source Nix store
+
+ - `--impure`
+ allow access to mutable paths and repositories
+
+ - `--include` / `I` *path*
+ add a path to the list of locations used to look up `<...>` file names
+
+ - `--inputs-from` *flake-url*
+ use the inputs of the specified flake as registry entries
+
+ - `--no-check-sigs`
+ do not require that paths are signed by trusted keys
+
+ - `--no-recursive`
+ apply operation to specified paths only
+
+ - `--no-registries`
+ don't use flake registries
+
+ - `--no-update-lock-file`
+ do not allow any updates to the lock file
+
+ - `--no-write-lock-file`
+ do not write the newly generated lock file
+
+ - `--override-flake` *original-ref* *resolved-ref*
+ override a flake registry value
+
+ - `--override-input` *input-path* *flake-url*
+ override a specific flake input (e.g. `dwarffs/nixpkgs`)
+
+ - `--recreate-lock-file`
+ recreate lock file from scratch
+
+ - `--substitute-on-destination` / `s`
+ whether to try substitutes on the destination store (only supported by SSH)
+
+ - `--to` *store-uri*
+ URI of the destination Nix store
+
+ - `--update-input` *input-path*
+ update a specific flake input
+
+## Examples
+
+To copy Firefox from the local store to a binary cache in file:///tmp/cache:
+
+```console
+nix copy --to file:///tmp/cache $(type -p firefox)
+```
+
+To copy the entire current NixOS system closure to another machine via SSH:
+
+```console
+nix copy --to ssh://server /run/current-system
+```
+
+To copy a closure from another machine via SSH:
+
+```console
+nix copy --from ssh://server /nix/store/a6cnl93nk1wxnq84brbbwr6hxw9gp2w9-blender-2.79-rc2
+```
+
+To copy Hello to an S3 binary cache:
+
+```console
+nix copy --to s3://my-bucket?region=eu-west-1 nixpkgs#hello
+```
+
+To copy Hello to an S3-compatible binary cache:
+
+```console
+nix copy --to s3://my-bucket?region=eu-west-1&endpoint=example.com nixpkgs#hello
+```
+
+# Subcommand `nix copy-sigs`
+
+## Name
+
+`nix copy-sigs` - copy path signatures from substituters (like binary caches)
+
+## Synopsis
+
+`nix copy-sigs` [*flags*...] *installables*...
+
+## Flags
+
+ - `--all`
+ apply operation to the entire store
+
+ - `--arg` *name* *expr*
+ argument to be passed to Nix functions
+
+ - `--argstr` *name* *string*
+ string-valued argument to be passed to Nix functions
+
+ - `--commit-lock-file`
+ commit changes to the lock file
+
+ - `--derivation`
+ operate on the store derivation rather than its outputs
+
+ - `--expr` *expr*
+ evaluate attributes from *expr*
+
+ - `--file` / `f` *file*
+ evaluate *file* rather than the default
+
+ - `--impure`
+ allow access to mutable paths and repositories
+
+ - `--include` / `I` *path*
+ add a path to the list of locations used to look up `<...>` file names
+
+ - `--inputs-from` *flake-url*
+ use the inputs of the specified flake as registry entries
+
+ - `--no-registries`
+ don't use flake registries
+
+ - `--no-update-lock-file`
+ do not allow any updates to the lock file
+
+ - `--no-write-lock-file`
+ do not write the newly generated lock file
+
+ - `--override-flake` *original-ref* *resolved-ref*
+ override a flake registry value
+
+ - `--override-input` *input-path* *flake-url*
+ override a specific flake input (e.g. `dwarffs/nixpkgs`)
+
+ - `--recreate-lock-file`
+ recreate lock file from scratch
+
+ - `--recursive` / `r`
+ apply operation to closure of the specified paths
+
+ - `--substituter` / `s` *store-uri*
+ use signatures from specified store
+
+ - `--update-input` *input-path*
+ update a specific flake input
+
+# Subcommand `nix describe-stores`
+
+## Name
+
+`nix describe-stores` - show registered store types and their available options
+
+## Synopsis
+
+`nix describe-stores` [*flags*...]
+
+## Flags
+
+ - `--json`
+ produce JSON output
+
+# Subcommand `nix develop`
+
+## Name
+
+`nix develop` - run a bash shell that provides the build environment of a derivation
+
+## Synopsis
+
+`nix develop` [*flags*...] *installable*
+
+## Flags
+
+ - `--arg` *name* *expr*
+ argument to be passed to Nix functions
+
+ - `--argstr` *name* *string*
+ string-valued argument to be passed to Nix functions
+
+ - `--build`
+ run the build phase
+
+ - `--check`
+ run the check phase
+
+ - `--command` / `c` *command* *args*
+ command and arguments to be executed instead of an interactive shell
+
+ - `--commit-lock-file`
+ commit changes to the lock file
+
+ - `--configure`
+ run the configure phase
+
+ - `--derivation`
+ operate on the store derivation rather than its outputs
+
+ - `--expr` *expr*
+ evaluate attributes from *expr*
+
+ - `--file` / `f` *file*
+ evaluate *file* rather than the default
+
+ - `--ignore-environment` / `i`
+ clear the entire environment (except those specified with --keep)
+
+ - `--impure`
+ allow access to mutable paths and repositories
+
+ - `--include` / `I` *path*
+ add a path to the list of locations used to look up `<...>` file names
+
+ - `--inputs-from` *flake-url*
+ use the inputs of the specified flake as registry entries
+
+ - `--install`
+ run the install phase
+
+ - `--installcheck`
+ run the installcheck phase
+
+ - `--keep` / `k` *name*
+ keep specified environment variable
+
+ - `--no-registries`
+ don't use flake registries
+
+ - `--no-update-lock-file`
+ do not allow any updates to the lock file
+
+ - `--no-write-lock-file`
+ do not write the newly generated lock file
+
+ - `--override-flake` *original-ref* *resolved-ref*
+ override a flake registry value
+
+ - `--override-input` *input-path* *flake-url*
+ override a specific flake input (e.g. `dwarffs/nixpkgs`)
+
+ - `--phase` *phase-name*
+ phase to run (e.g. `build` or `configure`)
+
+ - `--profile` *path*
+ profile to update
+
+ - `--recreate-lock-file`
+ recreate lock file from scratch
+
+ - `--redirect` *installable* *outputs-dir*
+ redirect a store path to a mutable location
+
+ - `--unset` / `u` *name*
+ unset specified environment variable
+
+ - `--update-input` *input-path*
+ update a specific flake input
+
+## Examples
+
+To get the build environment of GNU hello:
+
+```console
+nix develop nixpkgs#hello
+```
+
+To get the build environment of the default package of flake in the current directory:
+
+```console
+nix develop
+```
+
+To store the build environment in a profile:
+
+```console
+nix develop --profile /tmp/my-shell nixpkgs#hello
+```
+
+To use a build environment previously recorded in a profile:
+
+```console
+nix develop /tmp/my-shell
+```
+
+To replace all occurences of a store path with a writable directory:
+
+```console
+nix develop --redirect nixpkgs#glibc.dev ~/my-glibc/outputs/dev
+```
+
+# Subcommand `nix diff-closures`
+
+## Name
+
+`nix diff-closures` - show what packages and versions were added and removed between two closures
+
+## Synopsis
+
+`nix diff-closures` [*flags*...] *before* *after*
+
+## Flags
+
+ - `--arg` *name* *expr*
+ argument to be passed to Nix functions
+
+ - `--argstr` *name* *string*
+ string-valued argument to be passed to Nix functions
+
+ - `--commit-lock-file`
+ commit changes to the lock file
+
+ - `--derivation`
+ operate on the store derivation rather than its outputs
+
+ - `--expr` *expr*
+ evaluate attributes from *expr*
+
+ - `--file` / `f` *file*
+ evaluate *file* rather than the default
+
+ - `--impure`
+ allow access to mutable paths and repositories
+
+ - `--include` / `I` *path*
+ add a path to the list of locations used to look up `<...>` file names
+
+ - `--inputs-from` *flake-url*
+ use the inputs of the specified flake as registry entries
+
+ - `--no-registries`
+ don't use flake registries
+
+ - `--no-update-lock-file`
+ do not allow any updates to the lock file
+
+ - `--no-write-lock-file`
+ do not write the newly generated lock file
+
+ - `--override-flake` *original-ref* *resolved-ref*
+ override a flake registry value
+
+ - `--override-input` *input-path* *flake-url*
+ override a specific flake input (e.g. `dwarffs/nixpkgs`)
+
+ - `--recreate-lock-file`
+ recreate lock file from scratch
+
+ - `--update-input` *input-path*
+ update a specific flake input
+
+## Examples
+
+To show what got added and removed between two versions of the NixOS system profile:
+
+```console
+nix diff-closures /nix/var/nix/profiles/system-655-link /nix/var/nix/profiles/system-658-link
+```
+
+# Subcommand `nix doctor`
+
+## Name
+
+`nix doctor` - check your system for potential problems and print a PASS or FAIL for each check
+
+## Synopsis
+
+`nix doctor` [*flags*...]
+
+# Subcommand `nix dump-path`
+
+## Name
+
+`nix dump-path` - dump a store path to stdout (in NAR format)
+
+## Synopsis
+
+`nix dump-path` [*flags*...] *installables*...
+
+## Flags
+
+ - `--arg` *name* *expr*
+ argument to be passed to Nix functions
+
+ - `--argstr` *name* *string*
+ string-valued argument to be passed to Nix functions
+
+ - `--commit-lock-file`
+ commit changes to the lock file
+
+ - `--derivation`
+ operate on the store derivation rather than its outputs
+
+ - `--expr` *expr*
+ evaluate attributes from *expr*
+
+ - `--file` / `f` *file*
+ evaluate *file* rather than the default
+
+ - `--impure`
+ allow access to mutable paths and repositories
+
+ - `--include` / `I` *path*
+ add a path to the list of locations used to look up `<...>` file names
+
+ - `--inputs-from` *flake-url*
+ use the inputs of the specified flake as registry entries
+
+ - `--no-registries`
+ don't use flake registries
+
+ - `--no-update-lock-file`
+ do not allow any updates to the lock file
+
+ - `--no-write-lock-file`
+ do not write the newly generated lock file
+
+ - `--override-flake` *original-ref* *resolved-ref*
+ override a flake registry value
+
+ - `--override-input` *input-path* *flake-url*
+ override a specific flake input (e.g. `dwarffs/nixpkgs`)
+
+ - `--recreate-lock-file`
+ recreate lock file from scratch
+
+ - `--update-input` *input-path*
+ update a specific flake input
+
+## Examples
+
+To get a NAR from the binary cache https://cache.nixos.org/:
+
+```console
+nix dump-path --store https://cache.nixos.org/ /nix/store/7crrmih8c52r8fbnqb933dxrsp44md93-glibc-2.25
+```
+
+# Subcommand `nix edit`
+
+## Name
+
+`nix edit` - open the Nix expression of a Nix package in $EDITOR
+
+## Synopsis
+
+`nix edit` [*flags*...] *installable*
+
+## Flags
+
+ - `--arg` *name* *expr*
+ argument to be passed to Nix functions
+
+ - `--argstr` *name* *string*
+ string-valued argument to be passed to Nix functions
+
+ - `--commit-lock-file`
+ commit changes to the lock file
+
+ - `--derivation`
+ operate on the store derivation rather than its outputs
+
+ - `--expr` *expr*
+ evaluate attributes from *expr*
+
+ - `--file` / `f` *file*
+ evaluate *file* rather than the default
+
+ - `--impure`
+ allow access to mutable paths and repositories
+
+ - `--include` / `I` *path*
+ add a path to the list of locations used to look up `<...>` file names
+
+ - `--inputs-from` *flake-url*
+ use the inputs of the specified flake as registry entries
+
+ - `--no-registries`
+ don't use flake registries
+
+ - `--no-update-lock-file`
+ do not allow any updates to the lock file
+
+ - `--no-write-lock-file`
+ do not write the newly generated lock file
+
+ - `--override-flake` *original-ref* *resolved-ref*
+ override a flake registry value
+
+ - `--override-input` *input-path* *flake-url*
+ override a specific flake input (e.g. `dwarffs/nixpkgs`)
+
+ - `--recreate-lock-file`
+ recreate lock file from scratch
+
+ - `--update-input` *input-path*
+ update a specific flake input
+
+## Examples
+
+To open the Nix expression of the GNU Hello package:
+
+```console
+nix edit nixpkgs#hello
+```
+
+# Subcommand `nix eval`
+
+## Name
+
+`nix eval` - evaluate a Nix expression
+
+## Synopsis
+
+`nix eval` [*flags*...] *installable*
+
+## Flags
+
+ - `--apply` *expr*
+ apply a function to each argument
+
+ - `--arg` *name* *expr*
+ argument to be passed to Nix functions
+
+ - `--argstr` *name* *string*
+ string-valued argument to be passed to Nix functions
+
+ - `--commit-lock-file`
+ commit changes to the lock file
+
+ - `--derivation`
+ operate on the store derivation rather than its outputs
+
+ - `--expr` *expr*
+ evaluate attributes from *expr*
+
+ - `--file` / `f` *file*
+ evaluate *file* rather than the default
+
+ - `--impure`
+ allow access to mutable paths and repositories
+
+ - `--include` / `I` *path*
+ add a path to the list of locations used to look up `<...>` file names
+
+ - `--inputs-from` *flake-url*
+ use the inputs of the specified flake as registry entries
+
+ - `--json`
+ produce JSON output
+
+ - `--no-registries`
+ don't use flake registries
+
+ - `--no-update-lock-file`
+ do not allow any updates to the lock file
+
+ - `--no-write-lock-file`
+ do not write the newly generated lock file
+
+ - `--override-flake` *original-ref* *resolved-ref*
+ override a flake registry value
+
+ - `--override-input` *input-path* *flake-url*
+ override a specific flake input (e.g. `dwarffs/nixpkgs`)
+
+ - `--raw`
+ print strings unquoted
+
+ - `--recreate-lock-file`
+ recreate lock file from scratch
+
+ - `--update-input` *input-path*
+ update a specific flake input
+
+## Examples
+
+To evaluate a Nix expression given on the command line:
+
+```console
+nix eval --expr '1 + 2'
+```
+
+To evaluate a Nix expression from a file or URI:
+
+```console
+nix eval -f ./my-nixpkgs hello.name
+```
+
+To get the current version of Nixpkgs:
+
+```console
+nix eval --raw nixpkgs#lib.version
+```
+
+To print the store path of the Hello package:
+
+```console
+nix eval --raw nixpkgs#hello
+```
+
+To get a list of checks in the 'nix' flake:
+
+```console
+nix eval nix#checks.x86_64-linux --apply builtins.attrNames
+```
+
+# Subcommand `nix flake`
+
+## Name
+
+`nix flake` - manage Nix flakes
+
+## Synopsis
+
+`nix flake` [*flags*...] *subcommand*
+
+# Subcommand `nix flake archive`
+
+## Name
+
+`nix flake archive` - copy a flake and all its inputs to a store
+
+## Synopsis
+
+`nix flake archive` [*flags*...] *flake-url*
+
+## Flags
+
+ - `--arg` *name* *expr*
+ argument to be passed to Nix functions
+
+ - `--argstr` *name* *string*
+ string-valued argument to be passed to Nix functions
+
+ - `--commit-lock-file`
+ commit changes to the lock file
+
+ - `--dry-run`
+ show what this command would do without doing it
+
+ - `--impure`
+ allow access to mutable paths and repositories
+
+ - `--include` / `I` *path*
+ add a path to the list of locations used to look up `<...>` file names
+
+ - `--inputs-from` *flake-url*
+ use the inputs of the specified flake as registry entries
+
+ - `--json`
+ produce JSON output
+
+ - `--no-registries`
+ don't use flake registries
+
+ - `--no-update-lock-file`
+ do not allow any updates to the lock file
+
+ - `--no-write-lock-file`
+ do not write the newly generated lock file
+
+ - `--override-flake` *original-ref* *resolved-ref*
+ override a flake registry value
+
+ - `--override-input` *input-path* *flake-url*
+ override a specific flake input (e.g. `dwarffs/nixpkgs`)
+
+ - `--recreate-lock-file`
+ recreate lock file from scratch
+
+ - `--to` *store-uri*
+ URI of the destination Nix store
+
+ - `--update-input` *input-path*
+ update a specific flake input
+
+## Examples
+
+To copy the dwarffs flake and its dependencies to a binary cache:
+
+```console
+nix flake archive --to file:///tmp/my-cache dwarffs
+```
+
+To fetch the dwarffs flake and its dependencies to the local Nix store:
+
+```console
+nix flake archive dwarffs
+```
+
+To print the store paths of the flake sources of NixOps without fetching them:
+
+```console
+nix flake archive --json --dry-run nixops
+```
+
+# Subcommand `nix flake check`
+
+## Name
+
+`nix flake check` - check whether the flake evaluates and run its tests
+
+## Synopsis
+
+`nix flake check` [*flags*...] *flake-url*
+
+## Flags
+
+ - `--arg` *name* *expr*
+ argument to be passed to Nix functions
+
+ - `--argstr` *name* *string*
+ string-valued argument to be passed to Nix functions
+
+ - `--commit-lock-file`
+ commit changes to the lock file
+
+ - `--impure`
+ allow access to mutable paths and repositories
+
+ - `--include` / `I` *path*
+ add a path to the list of locations used to look up `<...>` file names
+
+ - `--inputs-from` *flake-url*
+ use the inputs of the specified flake as registry entries
+
+ - `--no-build`
+ do not build checks
+
+ - `--no-registries`
+ don't use flake registries
+
+ - `--no-update-lock-file`
+ do not allow any updates to the lock file
+
+ - `--no-write-lock-file`
+ do not write the newly generated lock file
+
+ - `--override-flake` *original-ref* *resolved-ref*
+ override a flake registry value
+
+ - `--override-input` *input-path* *flake-url*
+ override a specific flake input (e.g. `dwarffs/nixpkgs`)
+
+ - `--recreate-lock-file`
+ recreate lock file from scratch
+
+ - `--update-input` *input-path*
+ update a specific flake input
+
+# Subcommand `nix flake clone`
+
+## Name
+
+`nix flake clone` - clone flake repository
+
+## Synopsis
+
+`nix flake clone` [*flags*...] *flake-url*
+
+## Flags
+
+ - `--arg` *name* *expr*
+ argument to be passed to Nix functions
+
+ - `--argstr` *name* *string*
+ string-valued argument to be passed to Nix functions
+
+ - `--commit-lock-file`
+ commit changes to the lock file
+
+ - `--dest` / `f` *path*
+ destination path
+
+ - `--impure`
+ allow access to mutable paths and repositories
+
+ - `--include` / `I` *path*
+ add a path to the list of locations used to look up `<...>` file names
+
+ - `--inputs-from` *flake-url*
+ use the inputs of the specified flake as registry entries
+
+ - `--no-registries`
+ don't use flake registries
+
+ - `--no-update-lock-file`
+ do not allow any updates to the lock file
+
+ - `--no-write-lock-file`
+ do not write the newly generated lock file
+
+ - `--override-flake` *original-ref* *resolved-ref*
+ override a flake registry value
+
+ - `--override-input` *input-path* *flake-url*
+ override a specific flake input (e.g. `dwarffs/nixpkgs`)
+
+ - `--recreate-lock-file`
+ recreate lock file from scratch
+
+ - `--update-input` *input-path*
+ update a specific flake input
+
+# Subcommand `nix flake info`
+
+## Name
+
+`nix flake info` - list info about a given flake
+
+## Synopsis
+
+`nix flake info` [*flags*...] *flake-url*
+
+## Flags
+
+ - `--arg` *name* *expr*
+ argument to be passed to Nix functions
+
+ - `--argstr` *name* *string*
+ string-valued argument to be passed to Nix functions
+
+ - `--commit-lock-file`
+ commit changes to the lock file
+
+ - `--impure`
+ allow access to mutable paths and repositories
+
+ - `--include` / `I` *path*
+ add a path to the list of locations used to look up `<...>` file names
+
+ - `--inputs-from` *flake-url*
+ use the inputs of the specified flake as registry entries
+
+ - `--json`
+ produce JSON output
+
+ - `--no-registries`
+ don't use flake registries
+
+ - `--no-update-lock-file`
+ do not allow any updates to the lock file
+
+ - `--no-write-lock-file`
+ do not write the newly generated lock file
+
+ - `--override-flake` *original-ref* *resolved-ref*
+ override a flake registry value
+
+ - `--override-input` *input-path* *flake-url*
+ override a specific flake input (e.g. `dwarffs/nixpkgs`)
+
+ - `--recreate-lock-file`
+ recreate lock file from scratch
+
+ - `--update-input` *input-path*
+ update a specific flake input
+
+# Subcommand `nix flake init`
+
+## Name
+
+`nix flake init` - create a flake in the current directory from a template
+
+## Synopsis
+
+`nix flake init` [*flags*...]
+
+## Flags
+
+ - `--arg` *name* *expr*
+ argument to be passed to Nix functions
+
+ - `--argstr` *name* *string*
+ string-valued argument to be passed to Nix functions
+
+ - `--impure`
+ allow access to mutable paths and repositories
+
+ - `--include` / `I` *path*
+ add a path to the list of locations used to look up `<...>` file names
+
+ - `--override-flake` *original-ref* *resolved-ref*
+ override a flake registry value
+
+ - `--template` / `t` *template*
+ the template to use
+
+## Examples
+
+To create a flake using the default template:
+
+```console
+nix flake init
+```
+
+To see available templates:
+
+```console
+nix flake show templates
+```
+
+To create a flake from a specific template:
+
+```console
+nix flake init -t templates#nixos-container
+```
+
+# Subcommand `nix flake list-inputs`
+
+## Name
+
+`nix flake list-inputs` - list flake inputs
+
+## Synopsis
+
+`nix flake list-inputs` [*flags*...] *flake-url*
+
+## Flags
+
+ - `--arg` *name* *expr*
+ argument to be passed to Nix functions
+
+ - `--argstr` *name* *string*
+ string-valued argument to be passed to Nix functions
+
+ - `--commit-lock-file`
+ commit changes to the lock file
+
+ - `--impure`
+ allow access to mutable paths and repositories
+
+ - `--include` / `I` *path*
+ add a path to the list of locations used to look up `<...>` file names
+
+ - `--inputs-from` *flake-url*
+ use the inputs of the specified flake as registry entries
+
+ - `--json`
+ produce JSON output
+
+ - `--no-registries`
+ don't use flake registries
+
+ - `--no-update-lock-file`
+ do not allow any updates to the lock file
+
+ - `--no-write-lock-file`
+ do not write the newly generated lock file
+
+ - `--override-flake` *original-ref* *resolved-ref*
+ override a flake registry value
+
+ - `--override-input` *input-path* *flake-url*
+ override a specific flake input (e.g. `dwarffs/nixpkgs`)
+
+ - `--recreate-lock-file`
+ recreate lock file from scratch
+
+ - `--update-input` *input-path*
+ update a specific flake input
+
+# Subcommand `nix flake new`
+
+## Name
+
+`nix flake new` - create a flake in the specified directory from a template
+
+## Synopsis
+
+`nix flake new` [*flags*...] *dest-dir*
+
+## Flags
+
+ - `--arg` *name* *expr*
+ argument to be passed to Nix functions
+
+ - `--argstr` *name* *string*
+ string-valued argument to be passed to Nix functions
+
+ - `--impure`
+ allow access to mutable paths and repositories
+
+ - `--include` / `I` *path*
+ add a path to the list of locations used to look up `<...>` file names
+
+ - `--override-flake` *original-ref* *resolved-ref*
+ override a flake registry value
+
+ - `--template` / `t` *template*
+ the template to use
+
+# Subcommand `nix flake show`
+
+## Name
+
+`nix flake show` - show the outputs provided by a flake
+
+## Synopsis
+
+`nix flake show` [*flags*...] *flake-url*
+
+## Flags
+
+ - `--arg` *name* *expr*
+ argument to be passed to Nix functions
+
+ - `--argstr` *name* *string*
+ string-valued argument to be passed to Nix functions
+
+ - `--commit-lock-file`
+ commit changes to the lock file
+
+ - `--impure`
+ allow access to mutable paths and repositories
+
+ - `--include` / `I` *path*
+ add a path to the list of locations used to look up `<...>` file names
+
+ - `--inputs-from` *flake-url*
+ use the inputs of the specified flake as registry entries
+
+ - `--legacy`
+ show the contents of the 'legacyPackages' output
+
+ - `--no-registries`
+ don't use flake registries
+
+ - `--no-update-lock-file`
+ do not allow any updates to the lock file
+
+ - `--no-write-lock-file`
+ do not write the newly generated lock file
+
+ - `--override-flake` *original-ref* *resolved-ref*
+ override a flake registry value
+
+ - `--override-input` *input-path* *flake-url*
+ override a specific flake input (e.g. `dwarffs/nixpkgs`)
+
+ - `--recreate-lock-file`
+ recreate lock file from scratch
+
+ - `--update-input` *input-path*
+ update a specific flake input
+
+# Subcommand `nix flake update`
+
+## Name
+
+`nix flake update` - update flake lock file
+
+## Synopsis
+
+`nix flake update` [*flags*...] *flake-url*
+
+## Flags
+
+ - `--arg` *name* *expr*
+ argument to be passed to Nix functions
+
+ - `--argstr` *name* *string*
+ string-valued argument to be passed to Nix functions
+
+ - `--commit-lock-file`
+ commit changes to the lock file
+
+ - `--impure`
+ allow access to mutable paths and repositories
+
+ - `--include` / `I` *path*
+ add a path to the list of locations used to look up `<...>` file names
+
+ - `--inputs-from` *flake-url*
+ use the inputs of the specified flake as registry entries
+
+ - `--no-registries`
+ don't use flake registries
+
+ - `--no-update-lock-file`
+ do not allow any updates to the lock file
+
+ - `--no-write-lock-file`
+ do not write the newly generated lock file
+
+ - `--override-flake` *original-ref* *resolved-ref*
+ override a flake registry value
+
+ - `--override-input` *input-path* *flake-url*
+ override a specific flake input (e.g. `dwarffs/nixpkgs`)
+
+ - `--recreate-lock-file`
+ recreate lock file from scratch
+
+ - `--update-input` *input-path*
+ update a specific flake input
+
+# Subcommand `nix hash-file`
+
+## Name
+
+`nix hash-file` - print cryptographic hash of a regular file
+
+## Synopsis
+
+`nix hash-file` [*flags*...] *paths*...
+
+## Flags
+
+ - `--base16`
+ print hash in base-16
+
+ - `--base32`
+ print hash in base-32 (Nix-specific)
+
+ - `--base64`
+ print hash in base-64
+
+ - `--sri`
+ print hash in SRI format
+
+ - `--type` *hash-algo*
+ hash algorithm ('md5', 'sha1', 'sha256', or 'sha512')
+
+# Subcommand `nix hash-path`
+
+## Name
+
+`nix hash-path` - print cryptographic hash of the NAR serialisation of a path
+
+## Synopsis
+
+`nix hash-path` [*flags*...] *paths*...
+
+## Flags
+
+ - `--base16`
+ print hash in base-16
+
+ - `--base32`
+ print hash in base-32 (Nix-specific)
+
+ - `--base64`
+ print hash in base-64
+
+ - `--sri`
+ print hash in SRI format
+
+ - `--type` *hash-algo*
+ hash algorithm ('md5', 'sha1', 'sha256', or 'sha512')
+
+# Subcommand `nix log`
+
+## Name
+
+`nix log` - show the build log of the specified packages or paths, if available
+
+## Synopsis
+
+`nix log` [*flags*...] *installable*
+
+## Flags
+
+ - `--arg` *name* *expr*
+ argument to be passed to Nix functions
+
+ - `--argstr` *name* *string*
+ string-valued argument to be passed to Nix functions
+
+ - `--commit-lock-file`
+ commit changes to the lock file
+
+ - `--derivation`
+ operate on the store derivation rather than its outputs
+
+ - `--expr` *expr*
+ evaluate attributes from *expr*
+
+ - `--file` / `f` *file*
+ evaluate *file* rather than the default
+
+ - `--impure`
+ allow access to mutable paths and repositories
+
+ - `--include` / `I` *path*
+ add a path to the list of locations used to look up `<...>` file names
+
+ - `--inputs-from` *flake-url*
+ use the inputs of the specified flake as registry entries
+
+ - `--no-registries`
+ don't use flake registries
+
+ - `--no-update-lock-file`
+ do not allow any updates to the lock file
+
+ - `--no-write-lock-file`
+ do not write the newly generated lock file
+
+ - `--override-flake` *original-ref* *resolved-ref*
+ override a flake registry value
+
+ - `--override-input` *input-path* *flake-url*
+ override a specific flake input (e.g. `dwarffs/nixpkgs`)
+
+ - `--recreate-lock-file`
+ recreate lock file from scratch
+
+ - `--update-input` *input-path*
+ update a specific flake input
+
+## Examples
+
+To get the build log of GNU Hello:
+
+```console
+nix log nixpkgs#hello
+```
+
+To get the build log of a specific path:
+
+```console
+nix log /nix/store/lmngj4wcm9rkv3w4dfhzhcyij3195hiq-thunderbird-52.2.1
+```
+
+To get a build log from a specific binary cache:
+
+```console
+nix log --store https://cache.nixos.org nixpkgs#hello
+```
+
+# Subcommand `nix ls-nar`
+
+## Name
+
+`nix ls-nar` - show information about a path inside a NAR file
+
+## Synopsis
+
+`nix ls-nar` [*flags*...] *nar* *path*
+
+## Flags
+
+ - `--directory` / `d`
+ show directories rather than their contents
+
+ - `--json`
+ produce JSON output
+
+ - `--long` / `l`
+ show more file information
+
+ - `--recursive` / `R`
+ list subdirectories recursively
+
+## Examples
+
+To list a specific file in a NAR:
+
+```console
+nix ls-nar -l hello.nar /bin/hello
+```
+
+# Subcommand `nix ls-store`
+
+## Name
+
+`nix ls-store` - show information about a path in the Nix store
+
+## Synopsis
+
+`nix ls-store` [*flags*...] *path*
+
+## Flags
+
+ - `--directory` / `d`
+ show directories rather than their contents
+
+ - `--json`
+ produce JSON output
+
+ - `--long` / `l`
+ show more file information
+
+ - `--recursive` / `R`
+ list subdirectories recursively
+
+## Examples
+
+To list the contents of a store path in a binary cache:
+
+```console
+nix ls-store --store https://cache.nixos.org/ -lR /nix/store/0i2jd68mp5g6h2sa5k9c85rb80sn8hi9-hello-2.10
+```
+
+# Subcommand `nix make-content-addressable`
+
+## Name
+
+`nix make-content-addressable` - rewrite a path or closure to content-addressable form
+
+## Synopsis
+
+`nix make-content-addressable` [*flags*...] *installables*...
+
+## Flags
+
+ - `--all`
+ apply operation to the entire store
+
+ - `--arg` *name* *expr*
+ argument to be passed to Nix functions
+
+ - `--argstr` *name* *string*
+ string-valued argument to be passed to Nix functions
+
+ - `--commit-lock-file`
+ commit changes to the lock file
+
+ - `--derivation`
+ operate on the store derivation rather than its outputs
+
+ - `--expr` *expr*
+ evaluate attributes from *expr*
+
+ - `--file` / `f` *file*
+ evaluate *file* rather than the default
+
+ - `--impure`
+ allow access to mutable paths and repositories
+
+ - `--include` / `I` *path*
+ add a path to the list of locations used to look up `<...>` file names
+
+ - `--inputs-from` *flake-url*
+ use the inputs of the specified flake as registry entries
+
+ - `--json`
+ produce JSON output
+
+ - `--no-registries`
+ don't use flake registries
+
+ - `--no-update-lock-file`
+ do not allow any updates to the lock file
+
+ - `--no-write-lock-file`
+ do not write the newly generated lock file
+
+ - `--override-flake` *original-ref* *resolved-ref*
+ override a flake registry value
+
+ - `--override-input` *input-path* *flake-url*
+ override a specific flake input (e.g. `dwarffs/nixpkgs`)
+
+ - `--recreate-lock-file`
+ recreate lock file from scratch
+
+ - `--recursive` / `r`
+ apply operation to closure of the specified paths
+
+ - `--update-input` *input-path*
+ update a specific flake input
+
+## Examples
+
+To create a content-addressable representation of GNU Hello (but not its dependencies):
+
+```console
+nix make-content-addressable nixpkgs#hello
+```
+
+To compute a content-addressable representation of the current NixOS system closure:
+
+```console
+nix make-content-addressable -r /run/current-system
+```
+
+# Subcommand `nix optimise-store`
+
+## Name
+
+`nix optimise-store` - replace identical files in the store by hard links
+
+## Synopsis
+
+`nix optimise-store` [*flags*...]
+
+## Examples
+
+To optimise the Nix store:
+
+```console
+nix optimise-store
+```
+
+# Subcommand `nix path-info`
+
+## Name
+
+`nix path-info` - query information about store paths
+
+## Synopsis
+
+`nix path-info` [*flags*...] *installables*...
+
+## Flags
+
+ - `--all`
+ apply operation to the entire store
+
+ - `--arg` *name* *expr*
+ argument to be passed to Nix functions
+
+ - `--argstr` *name* *string*
+ string-valued argument to be passed to Nix functions
+
+ - `--closure-size` / `S`
+ print sum size of the NAR dumps of the closure of each path
+
+ - `--commit-lock-file`
+ commit changes to the lock file
+
+ - `--derivation`
+ operate on the store derivation rather than its outputs
+
+ - `--expr` *expr*
+ evaluate attributes from *expr*
+
+ - `--file` / `f` *file*
+ evaluate *file* rather than the default
+
+ - `--human-readable` / `h`
+ with -s and -S, print sizes like 1K 234M 5.67G etc.
+
+ - `--impure`
+ allow access to mutable paths and repositories
+
+ - `--include` / `I` *path*
+ add a path to the list of locations used to look up `<...>` file names
+
+ - `--inputs-from` *flake-url*
+ use the inputs of the specified flake as registry entries
+
+ - `--json`
+ produce JSON output
+
+ - `--no-registries`
+ don't use flake registries
+
+ - `--no-update-lock-file`
+ do not allow any updates to the lock file
+
+ - `--no-write-lock-file`
+ do not write the newly generated lock file
+
+ - `--override-flake` *original-ref* *resolved-ref*
+ override a flake registry value
+
+ - `--override-input` *input-path* *flake-url*
+ override a specific flake input (e.g. `dwarffs/nixpkgs`)
+
+ - `--recreate-lock-file`
+ recreate lock file from scratch
+
+ - `--recursive` / `r`
+ apply operation to closure of the specified paths
+
+ - `--sigs`
+ show signatures
+
+ - `--size` / `s`
+ print size of the NAR dump of each path
+
+ - `--update-input` *input-path*
+ update a specific flake input
+
+## Examples
+
+To show the closure sizes of every path in the current NixOS system closure, sorted by size:
+
+```console
+nix path-info -rS /run/current-system | sort -nk2
+```
+
+To show a package's closure size and all its dependencies with human readable sizes:
+
+```console
+nix path-info -rsSh nixpkgs#rust
+```
+
+To check the existence of a path in a binary cache:
+
+```console
+nix path-info -r /nix/store/7qvk5c91...-geeqie-1.1 --store https://cache.nixos.org/
+```
+
+To print the 10 most recently added paths (using --json and the jq(1) command):
+
+```console
+nix path-info --json --all | jq -r 'sort_by(.registrationTime)[-11:-1][].path'
+```
+
+To show the size of the entire Nix store:
+
+```console
+nix path-info --json --all | jq 'map(.narSize) | add'
+```
+
+To show every path whose closure is bigger than 1 GB, sorted by closure size:
+
+```console
+nix path-info --json --all -S | jq 'map(select(.closureSize > 1e9)) | sort_by(.closureSize) | map([.path, .closureSize])'
+```
+
+# Subcommand `nix ping-store`
+
+## Name
+
+`nix ping-store` - test whether a store can be opened
+
+## Synopsis
+
+`nix ping-store` [*flags*...]
+
+## Examples
+
+To test whether connecting to a remote Nix store via SSH works:
+
+```console
+nix ping-store --store ssh://mac1
+```
+
+# Subcommand `nix print-dev-env`
+
+## Name
+
+`nix print-dev-env` - print shell code that can be sourced by bash to reproduce the build environment of a derivation
+
+## Synopsis
+
+`nix print-dev-env` [*flags*...] *installable*
+
+## Flags
+
+ - `--arg` *name* *expr*
+ argument to be passed to Nix functions
+
+ - `--argstr` *name* *string*
+ string-valued argument to be passed to Nix functions
+
+ - `--commit-lock-file`
+ commit changes to the lock file
+
+ - `--derivation`
+ operate on the store derivation rather than its outputs
+
+ - `--expr` *expr*
+ evaluate attributes from *expr*
+
+ - `--file` / `f` *file*
+ evaluate *file* rather than the default
+
+ - `--impure`
+ allow access to mutable paths and repositories
+
+ - `--include` / `I` *path*
+ add a path to the list of locations used to look up `<...>` file names
+
+ - `--inputs-from` *flake-url*
+ use the inputs of the specified flake as registry entries
+
+ - `--no-registries`
+ don't use flake registries
+
+ - `--no-update-lock-file`
+ do not allow any updates to the lock file
+
+ - `--no-write-lock-file`
+ do not write the newly generated lock file
+
+ - `--override-flake` *original-ref* *resolved-ref*
+ override a flake registry value
+
+ - `--override-input` *input-path* *flake-url*
+ override a specific flake input (e.g. `dwarffs/nixpkgs`)
+
+ - `--profile` *path*
+ profile to update
+
+ - `--recreate-lock-file`
+ recreate lock file from scratch
+
+ - `--redirect` *installable* *outputs-dir*
+ redirect a store path to a mutable location
+
+ - `--update-input` *input-path*
+ update a specific flake input
+
+## Examples
+
+To apply the build environment of GNU hello to the current shell:
+
+```console
+. <(nix print-dev-env nixpkgs#hello)
+```
+
+# Subcommand `nix profile`
+
+## Name
+
+`nix profile` - manage Nix profiles
+
+## Synopsis
+
+`nix profile` [*flags*...] *subcommand*
+
+# Subcommand `nix profile diff-closures`
+
+## Name
+
+`nix profile diff-closures` - show the closure difference between each generation of a profile
+
+## Synopsis
+
+`nix profile diff-closures` [*flags*...]
+
+## Flags
+
+ - `--profile` *path*
+ profile to update
+
+## Examples
+
+To show what changed between each generation of the NixOS system profile:
+
+```console
+nix profile diff-closure --profile /nix/var/nix/profiles/system
+```
+
+# Subcommand `nix profile info`
+
+## Name
+
+`nix profile info` - list installed packages
+
+## Synopsis
+
+`nix profile info` [*flags*...]
+
+## Flags
+
+ - `--arg` *name* *expr*
+ argument to be passed to Nix functions
+
+ - `--argstr` *name* *string*
+ string-valued argument to be passed to Nix functions
+
+ - `--impure`
+ allow access to mutable paths and repositories
+
+ - `--include` / `I` *path*
+ add a path to the list of locations used to look up `<...>` file names
+
+ - `--override-flake` *original-ref* *resolved-ref*
+ override a flake registry value
+
+ - `--profile` *path*
+ profile to update
+
+## Examples
+
+To show what packages are installed in the default profile:
+
+```console
+nix profile info
+```
+
+# Subcommand `nix profile install`
+
+## Name
+
+`nix profile install` - install a package into a profile
+
+## Synopsis
+
+`nix profile install` [*flags*...] *installables*...
+
+## Flags
+
+ - `--arg` *name* *expr*
+ argument to be passed to Nix functions
+
+ - `--argstr` *name* *string*
+ string-valued argument to be passed to Nix functions
+
+ - `--commit-lock-file`
+ commit changes to the lock file
+
+ - `--derivation`
+ operate on the store derivation rather than its outputs
+
+ - `--expr` *expr*
+ evaluate attributes from *expr*
+
+ - `--file` / `f` *file*
+ evaluate *file* rather than the default
+
+ - `--impure`
+ allow access to mutable paths and repositories
+
+ - `--include` / `I` *path*
+ add a path to the list of locations used to look up `<...>` file names
+
+ - `--inputs-from` *flake-url*
+ use the inputs of the specified flake as registry entries
+
+ - `--no-registries`
+ don't use flake registries
+
+ - `--no-update-lock-file`
+ do not allow any updates to the lock file
+
+ - `--no-write-lock-file`
+ do not write the newly generated lock file
+
+ - `--override-flake` *original-ref* *resolved-ref*
+ override a flake registry value
+
+ - `--override-input` *input-path* *flake-url*
+ override a specific flake input (e.g. `dwarffs/nixpkgs`)
+
+ - `--profile` *path*
+ profile to update
+
+ - `--recreate-lock-file`
+ recreate lock file from scratch
+
+ - `--update-input` *input-path*
+ update a specific flake input
+
+## Examples
+
+To install a package from Nixpkgs:
+
+```console
+nix profile install nixpkgs#hello
+```
+
+To install a package from a specific branch of Nixpkgs:
+
+```console
+nix profile install nixpkgs/release-19.09#hello
+```
+
+To install a package from a specific revision of Nixpkgs:
+
+```console
+nix profile install nixpkgs/1028bb33859f8dfad7f98e1c8d185f3d1aaa7340#hello
+```
+
+# Subcommand `nix profile remove`
+
+## Name
+
+`nix profile remove` - remove packages from a profile
+
+## Synopsis
+
+`nix profile remove` [*flags*...] *elements*...
+
+## Flags
+
+ - `--arg` *name* *expr*
+ argument to be passed to Nix functions
+
+ - `--argstr` *name* *string*
+ string-valued argument to be passed to Nix functions
+
+ - `--impure`
+ allow access to mutable paths and repositories
+
+ - `--include` / `I` *path*
+ add a path to the list of locations used to look up `<...>` file names
+
+ - `--override-flake` *original-ref* *resolved-ref*
+ override a flake registry value
+
+ - `--profile` *path*
+ profile to update
+
+## Examples
+
+To remove a package by attribute path:
+
+```console
+nix profile remove packages.x86_64-linux.hello
+```
+
+To remove all packages:
+
+```console
+nix profile remove '.*'
+```
+
+To remove a package by store path:
+
+```console
+nix profile remove /nix/store/rr3y0c6zyk7kjjl8y19s4lsrhn4aiq1z-hello-2.10
+```
+
+To remove a package by position:
+
+```console
+nix profile remove 3
+```
+
+# Subcommand `nix profile upgrade`
+
+## Name
+
+`nix profile upgrade` - upgrade packages using their most recent flake
+
+## Synopsis
+
+`nix profile upgrade` [*flags*...] *elements*...
+
+## Flags
+
+ - `--arg` *name* *expr*
+ argument to be passed to Nix functions
+
+ - `--argstr` *name* *string*
+ string-valued argument to be passed to Nix functions
+
+ - `--commit-lock-file`
+ commit changes to the lock file
+
+ - `--derivation`
+ operate on the store derivation rather than its outputs
+
+ - `--expr` *expr*
+ evaluate attributes from *expr*
+
+ - `--file` / `f` *file*
+ evaluate *file* rather than the default
+
+ - `--impure`
+ allow access to mutable paths and repositories
+
+ - `--include` / `I` *path*
+ add a path to the list of locations used to look up `<...>` file names
+
+ - `--inputs-from` *flake-url*
+ use the inputs of the specified flake as registry entries
+
+ - `--no-registries`
+ don't use flake registries
+
+ - `--no-update-lock-file`
+ do not allow any updates to the lock file
+
+ - `--no-write-lock-file`
+ do not write the newly generated lock file
+
+ - `--override-flake` *original-ref* *resolved-ref*
+ override a flake registry value
+
+ - `--override-input` *input-path* *flake-url*
+ override a specific flake input (e.g. `dwarffs/nixpkgs`)
+
+ - `--profile` *path*
+ profile to update
+
+ - `--recreate-lock-file`
+ recreate lock file from scratch
+
+ - `--update-input` *input-path*
+ update a specific flake input
+
+## Examples
+
+To upgrade all packages that were installed using a mutable flake reference:
+
+```console
+nix profile upgrade '.*'
+```
+
+To upgrade a specific package:
+
+```console
+nix profile upgrade packages.x86_64-linux.hello
+```
+
+# Subcommand `nix registry`
+
+## Name
+
+`nix registry` - manage the flake registry
+
+## Synopsis
+
+`nix registry` [*flags*...] *subcommand*
+
+# Subcommand `nix registry add`
+
+## Name
+
+`nix registry add` - add/replace flake in user flake registry
+
+## Synopsis
+
+`nix registry add` [*flags*...] *from-url* *to-url*
+
+## Flags
+
+ - `--arg` *name* *expr*
+ argument to be passed to Nix functions
+
+ - `--argstr` *name* *string*
+ string-valued argument to be passed to Nix functions
+
+ - `--impure`
+ allow access to mutable paths and repositories
+
+ - `--include` / `I` *path*
+ add a path to the list of locations used to look up `<...>` file names
+
+ - `--override-flake` *original-ref* *resolved-ref*
+ override a flake registry value
+
+# Subcommand `nix registry list`
+
+## Name
+
+`nix registry list` - list available Nix flakes
+
+## Synopsis
+
+`nix registry list` [*flags*...]
+
+# Subcommand `nix registry pin`
+
+## Name
+
+`nix registry pin` - pin a flake to its current version in user flake registry
+
+## Synopsis
+
+`nix registry pin` [*flags*...] *url*
+
+## Flags
+
+ - `--arg` *name* *expr*
+ argument to be passed to Nix functions
+
+ - `--argstr` *name* *string*
+ string-valued argument to be passed to Nix functions
+
+ - `--impure`
+ allow access to mutable paths and repositories
+
+ - `--include` / `I` *path*
+ add a path to the list of locations used to look up `<...>` file names
+
+ - `--override-flake` *original-ref* *resolved-ref*
+ override a flake registry value
+
+# Subcommand `nix registry remove`
+
+## Name
+
+`nix registry remove` - remove flake from user flake registry
+
+## Synopsis
+
+`nix registry remove` [*flags*...] *url*
+
+## Flags
+
+ - `--arg` *name* *expr*
+ argument to be passed to Nix functions
+
+ - `--argstr` *name* *string*
+ string-valued argument to be passed to Nix functions
+
+ - `--impure`
+ allow access to mutable paths and repositories
+
+ - `--include` / `I` *path*
+ add a path to the list of locations used to look up `<...>` file names
+
+ - `--override-flake` *original-ref* *resolved-ref*
+ override a flake registry value
+
+# Subcommand `nix repl`
+
+## Name
+
+`nix repl` - start an interactive environment for evaluating Nix expressions
+
+## Synopsis
+
+`nix repl` [*flags*...] *files*...
+
+## Flags
+
+ - `--arg` *name* *expr*
+ argument to be passed to Nix functions
+
+ - `--argstr` *name* *string*
+ string-valued argument to be passed to Nix functions
+
+ - `--impure`
+ allow access to mutable paths and repositories
+
+ - `--include` / `I` *path*
+ add a path to the list of locations used to look up `<...>` file names
+
+ - `--override-flake` *original-ref* *resolved-ref*
+ override a flake registry value
+
+## Examples
+
+Display all special commands within the REPL:
+
+```console
+nix repl
+nix-repl> :?
+```
+
+# Subcommand `nix run`
+
+## Name
+
+`nix run` - run a Nix application
+
+## Synopsis
+
+`nix run` [*flags*...] *installable* *args*...
+
+## Flags
+
+ - `--arg` *name* *expr*
+ argument to be passed to Nix functions
+
+ - `--argstr` *name* *string*
+ string-valued argument to be passed to Nix functions
+
+ - `--commit-lock-file`
+ commit changes to the lock file
+
+ - `--derivation`
+ operate on the store derivation rather than its outputs
+
+ - `--expr` *expr*
+ evaluate attributes from *expr*
+
+ - `--file` / `f` *file*
+ evaluate *file* rather than the default
+
+ - `--impure`
+ allow access to mutable paths and repositories
+
+ - `--include` / `I` *path*
+ add a path to the list of locations used to look up `<...>` file names
+
+ - `--inputs-from` *flake-url*
+ use the inputs of the specified flake as registry entries
+
+ - `--no-registries`
+ don't use flake registries
+
+ - `--no-update-lock-file`
+ do not allow any updates to the lock file
+
+ - `--no-write-lock-file`
+ do not write the newly generated lock file
+
+ - `--override-flake` *original-ref* *resolved-ref*
+ override a flake registry value
+
+ - `--override-input` *input-path* *flake-url*
+ override a specific flake input (e.g. `dwarffs/nixpkgs`)
+
+ - `--recreate-lock-file`
+ recreate lock file from scratch
+
+ - `--update-input` *input-path*
+ update a specific flake input
+
+## Examples
+
+To run Blender:
+
+```console
+nix run blender-bin
+```
+
+To run vim from nixpkgs:
+
+```console
+nix run nixpkgs#vim
+```
+
+To run vim from nixpkgs with arguments:
+
+```console
+nix run nixpkgs#vim -- --help
+```
+
+# Subcommand `nix search`
+
+## Name
+
+`nix search` - query available packages
+
+## Synopsis
+
+`nix search` [*flags*...] *installable* *regex*...
+
+## Flags
+
+ - `--arg` *name* *expr*
+ argument to be passed to Nix functions
+
+ - `--argstr` *name* *string*
+ string-valued argument to be passed to Nix functions
+
+ - `--commit-lock-file`
+ commit changes to the lock file
+
+ - `--derivation`
+ operate on the store derivation rather than its outputs
+
+ - `--expr` *expr*
+ evaluate attributes from *expr*
+
+ - `--file` / `f` *file*
+ evaluate *file* rather than the default
+
+ - `--impure`
+ allow access to mutable paths and repositories
+
+ - `--include` / `I` *path*
+ add a path to the list of locations used to look up `<...>` file names
+
+ - `--inputs-from` *flake-url*
+ use the inputs of the specified flake as registry entries
+
+ - `--json`
+ produce JSON output
+
+ - `--no-registries`
+ don't use flake registries
+
+ - `--no-update-lock-file`
+ do not allow any updates to the lock file
+
+ - `--no-write-lock-file`
+ do not write the newly generated lock file
+
+ - `--override-flake` *original-ref* *resolved-ref*
+ override a flake registry value
+
+ - `--override-input` *input-path* *flake-url*
+ override a specific flake input (e.g. `dwarffs/nixpkgs`)
+
+ - `--recreate-lock-file`
+ recreate lock file from scratch
+
+ - `--update-input` *input-path*
+ update a specific flake input
+
+## Examples
+
+To show all packages in the flake in the current directory:
+
+```console
+nix search
+```
+
+To show packages in the 'nixpkgs' flake containing 'blender' in its name or description:
+
+```console
+nix search nixpkgs blender
+```
+
+To search for Firefox or Chromium:
+
+```console
+nix search nixpkgs 'firefox|chromium'
+```
+
+To search for packages containing 'git' and either 'frontend' or 'gui':
+
+```console
+nix search nixpkgs git 'frontend|gui'
+```
+
+# Subcommand `nix shell`
+
+## Name
+
+`nix shell` - run a shell in which the specified packages are available
+
+## Synopsis
+
+`nix shell` [*flags*...] *installables*...
+
+## Flags
+
+ - `--arg` *name* *expr*
+ argument to be passed to Nix functions
+
+ - `--argstr` *name* *string*
+ string-valued argument to be passed to Nix functions
+
+ - `--command` / `c` *command* *args*
+ command and arguments to be executed; defaults to '$SHELL'
+
+ - `--commit-lock-file`
+ commit changes to the lock file
+
+ - `--derivation`
+ operate on the store derivation rather than its outputs
+
+ - `--expr` *expr*
+ evaluate attributes from *expr*
+
+ - `--file` / `f` *file*
+ evaluate *file* rather than the default
+
+ - `--ignore-environment` / `i`
+ clear the entire environment (except those specified with --keep)
+
+ - `--impure`
+ allow access to mutable paths and repositories
+
+ - `--include` / `I` *path*
+ add a path to the list of locations used to look up `<...>` file names
+
+ - `--inputs-from` *flake-url*
+ use the inputs of the specified flake as registry entries
+
+ - `--keep` / `k` *name*
+ keep specified environment variable
+
+ - `--no-registries`
+ don't use flake registries
+
+ - `--no-update-lock-file`
+ do not allow any updates to the lock file
+
+ - `--no-write-lock-file`
+ do not write the newly generated lock file
+
+ - `--override-flake` *original-ref* *resolved-ref*
+ override a flake registry value
+
+ - `--override-input` *input-path* *flake-url*
+ override a specific flake input (e.g. `dwarffs/nixpkgs`)
+
+ - `--recreate-lock-file`
+ recreate lock file from scratch
+
+ - `--unset` / `u` *name*
+ unset specified environment variable
+
+ - `--update-input` *input-path*
+ update a specific flake input
+
+## Examples
+
+To start a shell providing GNU Hello from NixOS 20.03:
+
+```console
+nix shell nixpkgs/nixos-20.03#hello
+```
+
+To start a shell providing youtube-dl from your 'nixpkgs' channel:
+
+```console
+nix shell nixpkgs#youtube-dl
+```
+
+To run GNU Hello:
+
+```console
+nix shell nixpkgs#hello -c hello --greeting 'Hi everybody!'
+```
+
+To run GNU Hello in a chroot store:
+
+```console
+nix shell --store ~/my-nix nixpkgs#hello -c hello
+```
+
+# Subcommand `nix show-config`
+
+## Name
+
+`nix show-config` - show the Nix configuration
+
+## Synopsis
+
+`nix show-config` [*flags*...]
+
+## Flags
+
+ - `--json`
+ produce JSON output
+
+# Subcommand `nix show-derivation`
+
+## Name
+
+`nix show-derivation` - show the contents of a store derivation
+
+## Synopsis
+
+`nix show-derivation` [*flags*...] *installables*...
+
+## Flags
+
+ - `--arg` *name* *expr*
+ argument to be passed to Nix functions
+
+ - `--argstr` *name* *string*
+ string-valued argument to be passed to Nix functions
+
+ - `--commit-lock-file`
+ commit changes to the lock file
+
+ - `--derivation`
+ operate on the store derivation rather than its outputs
+
+ - `--expr` *expr*
+ evaluate attributes from *expr*
+
+ - `--file` / `f` *file*
+ evaluate *file* rather than the default
+
+ - `--impure`
+ allow access to mutable paths and repositories
+
+ - `--include` / `I` *path*
+ add a path to the list of locations used to look up `<...>` file names
+
+ - `--inputs-from` *flake-url*
+ use the inputs of the specified flake as registry entries
+
+ - `--no-registries`
+ don't use flake registries
+
+ - `--no-update-lock-file`
+ do not allow any updates to the lock file
+
+ - `--no-write-lock-file`
+ do not write the newly generated lock file
+
+ - `--override-flake` *original-ref* *resolved-ref*
+ override a flake registry value
+
+ - `--override-input` *input-path* *flake-url*
+ override a specific flake input (e.g. `dwarffs/nixpkgs`)
+
+ - `--recreate-lock-file`
+ recreate lock file from scratch
+
+ - `--recursive` / `r`
+ include the dependencies of the specified derivations
+
+ - `--update-input` *input-path*
+ update a specific flake input
+
+## Examples
+
+To show the store derivation that results from evaluating the Hello package:
+
+```console
+nix show-derivation nixpkgs#hello
+```
+
+To show the full derivation graph (if available) that produced your NixOS system:
+
+```console
+nix show-derivation -r /run/current-system
+```
+
+# Subcommand `nix sign-paths`
+
+## Name
+
+`nix sign-paths` - sign the specified paths
+
+## Synopsis
+
+`nix sign-paths` [*flags*...] *installables*...
+
+## Flags
+
+ - `--all`
+ apply operation to the entire store
+
+ - `--arg` *name* *expr*
+ argument to be passed to Nix functions
+
+ - `--argstr` *name* *string*
+ string-valued argument to be passed to Nix functions
+
+ - `--commit-lock-file`
+ commit changes to the lock file
+
+ - `--derivation`
+ operate on the store derivation rather than its outputs
+
+ - `--expr` *expr*
+ evaluate attributes from *expr*
+
+ - `--file` / `f` *file*
+ evaluate *file* rather than the default
+
+ - `--impure`
+ allow access to mutable paths and repositories
+
+ - `--include` / `I` *path*
+ add a path to the list of locations used to look up `<...>` file names
+
+ - `--inputs-from` *flake-url*
+ use the inputs of the specified flake as registry entries
+
+ - `--key-file` / `k` *file*
+ file containing the secret signing key
+
+ - `--no-registries`
+ don't use flake registries
+
+ - `--no-update-lock-file`
+ do not allow any updates to the lock file
+
+ - `--no-write-lock-file`
+ do not write the newly generated lock file
+
+ - `--override-flake` *original-ref* *resolved-ref*
+ override a flake registry value
+
+ - `--override-input` *input-path* *flake-url*
+ override a specific flake input (e.g. `dwarffs/nixpkgs`)
+
+ - `--recreate-lock-file`
+ recreate lock file from scratch
+
+ - `--recursive` / `r`
+ apply operation to closure of the specified paths
+
+ - `--update-input` *input-path*
+ update a specific flake input
+
+# Subcommand `nix to-base16`
+
+## Name
+
+`nix to-base16` - convert a hash to base-16 representation
+
+## Synopsis
+
+`nix to-base16` [*flags*...] *strings*...
+
+## Flags
+
+ - `--type` *hash-algo*
+ hash algorithm ('md5', 'sha1', 'sha256', or 'sha512'). Optional as can also be gotten from SRI hash itself.
+
+# Subcommand `nix to-base32`
+
+## Name
+
+`nix to-base32` - convert a hash to base-32 representation
+
+## Synopsis
+
+`nix to-base32` [*flags*...] *strings*...
+
+## Flags
+
+ - `--type` *hash-algo*
+ hash algorithm ('md5', 'sha1', 'sha256', or 'sha512'). Optional as can also be gotten from SRI hash itself.
+
+# Subcommand `nix to-base64`
+
+## Name
+
+`nix to-base64` - convert a hash to base-64 representation
+
+## Synopsis
+
+`nix to-base64` [*flags*...] *strings*...
+
+## Flags
+
+ - `--type` *hash-algo*
+ hash algorithm ('md5', 'sha1', 'sha256', or 'sha512'). Optional as can also be gotten from SRI hash itself.
+
+# Subcommand `nix to-sri`
+
+## Name
+
+`nix to-sri` - convert a hash to SRI representation
+
+## Synopsis
+
+`nix to-sri` [*flags*...] *strings*...
+
+## Flags
+
+ - `--type` *hash-algo*
+ hash algorithm ('md5', 'sha1', 'sha256', or 'sha512'). Optional as can also be gotten from SRI hash itself.
+
+# Subcommand `nix upgrade-nix`
+
+## Name
+
+`nix upgrade-nix` - upgrade Nix to the latest stable version
+
+## Synopsis
+
+`nix upgrade-nix` [*flags*...]
+
+## Flags
+
+ - `--dry-run`
+ show what this command would do without doing it
+
+ - `--nix-store-paths-url` *url*
+ URL of the file that contains the store paths of the latest Nix release
+
+ - `--profile` / `p` *profile-dir*
+ the Nix profile to upgrade
+
+## Examples
+
+To upgrade Nix to the latest stable version:
+
+```console
+nix upgrade-nix
+```
+
+To upgrade Nix in a specific profile:
+
+```console
+nix upgrade-nix -p /nix/var/nix/profiles/per-user/alice/profile
+```
+
+# Subcommand `nix verify`
+
+## Name
+
+`nix verify` - verify the integrity of store paths
+
+## Synopsis
+
+`nix verify` [*flags*...] *installables*...
+
+## Flags
+
+ - `--all`
+ apply operation to the entire store
+
+ - `--arg` *name* *expr*
+ argument to be passed to Nix functions
+
+ - `--argstr` *name* *string*
+ string-valued argument to be passed to Nix functions
+
+ - `--commit-lock-file`
+ commit changes to the lock file
+
+ - `--derivation`
+ operate on the store derivation rather than its outputs
+
+ - `--expr` *expr*
+ evaluate attributes from *expr*
+
+ - `--file` / `f` *file*
+ evaluate *file* rather than the default
+
+ - `--impure`
+ allow access to mutable paths and repositories
+
+ - `--include` / `I` *path*
+ add a path to the list of locations used to look up `<...>` file names
+
+ - `--inputs-from` *flake-url*
+ use the inputs of the specified flake as registry entries
+
+ - `--no-contents`
+ do not verify the contents of each store path
+
+ - `--no-registries`
+ don't use flake registries
+
+ - `--no-trust`
+ do not verify whether each store path is trusted
+
+ - `--no-update-lock-file`
+ do not allow any updates to the lock file
+
+ - `--no-write-lock-file`
+ do not write the newly generated lock file
+
+ - `--override-flake` *original-ref* *resolved-ref*
+ override a flake registry value
+
+ - `--override-input` *input-path* *flake-url*
+ override a specific flake input (e.g. `dwarffs/nixpkgs`)
+
+ - `--recreate-lock-file`
+ recreate lock file from scratch
+
+ - `--recursive` / `r`
+ apply operation to closure of the specified paths
+
+ - `--sigs-needed` / `n` *N*
+ require that each path has at least N valid signatures
+
+ - `--substituter` / `s` *store-uri*
+ use signatures from specified store
+
+ - `--update-input` *input-path*
+ update a specific flake input
+
+## Examples
+
+To verify the entire Nix store:
+
+```console
+nix verify --all
+```
+
+To check whether each path in the closure of Firefox has at least 2 signatures:
+
+```console
+nix verify -r -n2 --no-contents $(type -p firefox)
+```
+
+# Subcommand `nix why-depends`
+
+## Name
+
+`nix why-depends` - show why a package has another package in its closure
+
+## Synopsis
+
+`nix why-depends` [*flags*...] *package* *dependency*
+
+## Flags
+
+ - `--all` / `a`
+ show all edges in the dependency graph leading from 'package' to 'dependency', rather than just a shortest path
+
+ - `--arg` *name* *expr*
+ argument to be passed to Nix functions
+
+ - `--argstr` *name* *string*
+ string-valued argument to be passed to Nix functions
+
+ - `--commit-lock-file`
+ commit changes to the lock file
+
+ - `--derivation`
+ operate on the store derivation rather than its outputs
+
+ - `--expr` *expr*
+ evaluate attributes from *expr*
+
+ - `--file` / `f` *file*
+ evaluate *file* rather than the default
+
+ - `--impure`
+ allow access to mutable paths and repositories
+
+ - `--include` / `I` *path*
+ add a path to the list of locations used to look up `<...>` file names
+
+ - `--inputs-from` *flake-url*
+ use the inputs of the specified flake as registry entries
+
+ - `--no-registries`
+ don't use flake registries
+
+ - `--no-update-lock-file`
+ do not allow any updates to the lock file
+
+ - `--no-write-lock-file`
+ do not write the newly generated lock file
+
+ - `--override-flake` *original-ref* *resolved-ref*
+ override a flake registry value
+
+ - `--override-input` *input-path* *flake-url*
+ override a specific flake input (e.g. `dwarffs/nixpkgs`)
+
+ - `--recreate-lock-file`
+ recreate lock file from scratch
+
+ - `--update-input` *input-path*
+ update a specific flake input
+
+## Examples
+
+To show one path through the dependency graph leading from Hello to Glibc:
+
+```console
+nix why-depends nixpkgs#hello nixpkgs#glibc
+```
+
+To show all files and paths in the dependency graph leading from Thunderbird to libX11:
+
+```console
+nix why-depends --all nixpkgs#thunderbird nixpkgs#xorg.libX11
+```
+
+To show why Glibc depends on itself:
+
+```console
+nix why-depends nixpkgs#glibc nixpkgs#glibc
+```
+
diff --git a/doc/manual/src/expressions/builtins.md.tmp b/doc/manual/src/expressions/builtins.md.tmp
new file mode 100644
index 000000000..95a73709e
--- /dev/null
+++ b/doc/manual/src/expressions/builtins.md.tmp
@@ -0,0 +1,16 @@
+# Built-in Functions
+
+This section lists the functions built into the Nix expression
+evaluator. (The built-in function `derivation` is discussed above.)
+Some built-ins, such as `derivation`, are always in scope of every Nix
+expression; you can just access them right away. But to prevent
+polluting the namespace too much, most built-ins are not in
+scope. Instead, you can access them through the `builtins` built-in
+value, which is a set that contains all built-in functions and values.
+For instance, `derivation` is also available as `builtins.derivation`.
+
+ - `derivation` *attrs*; `builtins.derivation` *attrs*\
+
+ `derivation` is described in [its own section](derivations.md).
+
+EvalCommand::getEvalState()0