lix/src/nix/store-dump-path.md

R""(

# Examples

* To get a NAR containing the GNU Hello package:

  ```console
  # nix store dump-path nixpkgs#hello > hello.nar
  ```

* To get a NAR from the binary cache https://cache.nixos.org/:

  ```console
  # nix store dump-path --store https://cache.nixos.org/ \
      /nix/store/7crrmih8c52r8fbnqb933dxrsp44md93-glibc-2.25 > glibc.nar
  ```

# Description

This command generates a NAR file containing the serialisation of the
store path [*installable*](./nix.md#installables). The NAR is written to standard output.

)""
Add 'nix store' NAR-related manpages 2020-12-09 19:06:19 +00:00			`R""(`

			`# Examples`

			`* To get a NAR containing the GNU Hello package:`

			```console
			`# nix store dump-path nixpkgs#hello > hello.nar`
			```

			`* To get a NAR from the binary cache https://cache.nixos.org/:`

			```console
			`# nix store dump-path --store https://cache.nixos.org/ \`
			`/nix/store/7crrmih8c52r8fbnqb933dxrsp44md93-glibc-2.25 > glibc.nar`
			```

			`# Description`

			`This command generates a NAR file containing the serialisation of the`
clarify definition of "installable" the term was hard to discover, as its definition and explanation were in a very long document lacking an overview section. search did not help because it occurs so often. - clarify wording in the definition - add an overview of installable types - add "installable" to glossary - link to definition from occurrences of the term - be more precise about where store derivation outputs are processed - installable Nix expressions must evaluate to a derivation Co-authored-by: Adam Joseph <54836058+amjoseph-nixpkgs@users.noreply.github.com> 2022-12-01 00:57:02 +00:00			`store path [installable](./nix.md#installables). The NAR is written to standard output.`
Add 'nix store' NAR-related manpages 2020-12-09 19:06:19 +00:00
			`)""`