reword documentation on nix-store --import

- add links to definitions of terms
- one sentence per line
- be more specific about which store is used for the import
- clearly distinguish store paths and store objects
- make a recommendation to use `nix-copy-closure` for efficient SSH transfers
This commit is contained in:
Valentin Gagarin 2024-05-15 01:21:45 +02:00
parent 05ad4e8806
commit 6907eaad4f

View file

@ -8,11 +8,13 @@
# Description # Description
The operation `--import` reads a serialisation of a set of store paths The operation `--import` reads a serialisation of a set of [store objects](@docroot@/glossary.md#gloss-store-object) produced by [`nix-store --export`](./export.md) from standard input, and adds those store objects to the specified [Nix store](@docroot@/store/index.md).
produced by `nix-store --export` from standard input and adds those Paths that already exist in the target Nix store are ignored.
store paths to the Nix store. Paths that already exist in the Nix store If a path [refers](@docroot@/glossary.md#gloss-reference) to another path that doesnt exist in the target Nix store, the import fails.
are ignored. If a path refers to another path that doesnt exist in the
Nix store, the import fails. > **Note**
>
> For efficient transfer of closures to remote machines over SSH, use [`nix-copy-closure`](@docroot@/command-ref/nix-copy-closure.md).
{{#include ./opt-common.md}} {{#include ./opt-common.md}}