lix/src/nix/derivation-add.md

R""(

**Note:** this command's interface is based heavily around [*installables*](./nix.md#installables), which you may want to read about first (`nix --help`).

# Description

This command reads from standard input a JSON representation of a
[store derivation] to which an [*installable*](./nix.md#installables) evaluates.

Store derivations are used internally by Nix. They are store paths with
extension `.drv` that represent the build-time dependency graph to which
a Nix expression evaluates.

[store derivation]: ../../glossary.md#gloss-store-derivation

The JSON format is documented under the [`derivation show`] command.

[`derivation show`]: ./nix3-derivation-show.md

)""
Create `nix derivation add` command Also refine `nix derivation show`'s docs very slightly. 2023-02-17 23:37:35 +00:00			`R""(`

docs: guide to installables docs in installable commands' docs The installables syntax is not documented in any of the man pages or docbook pages for any of those individual commands. And while these commands really should at least peripherally individually document how installables work, in the meantime we can at least direct people to the right place. This commit also clarifies the unexpected fact that `nix profile remove` and `nix profile upgrade` do not take installables. Change-Id: I3b1453cb197a613bbab639c66a466365c3592c6d 2024-04-29 13:39:10 +00:00			Note: this command's interface is based heavily around [installables](./nix.md#installables), which you may want to read about first (`nix --help`).

Create `nix derivation add` command Also refine `nix derivation show`'s docs very slightly. 2023-02-17 23:37:35 +00:00			`# Description`

			`This command reads from standard input a JSON representation of a`
			`[store derivation] to which an [installable](./nix.md#installables) evaluates.`

			`Store derivations are used internally by Nix. They are store paths with`
			extension `.drv` that represent the build-time dependency graph to which
			`a Nix expression evaluates.`

			`[store derivation]: ../../glossary.md#gloss-store-derivation`

			The JSON format is documented under the [`derivation show`] command.

			[`derivation show`]: ./nix3-derivation-show.md

			`)""`