aboutsummaryrefslogtreecommitdiff
path: root/doc/manual
diff options
context:
space:
mode:
authorEelco Dolstra <edolstra@gmail.com>2020-09-03 11:22:00 +0200
committerEelco Dolstra <edolstra@gmail.com>2020-09-03 11:22:00 +0200
commit00d25e84577659ccf0bc360c61c47b6cd25d1c26 (patch)
tree9e25d4a65da3b33023e7d4ddb3ee480f12573205 /doc/manual
parentb07167be5aeb91c06ca3487b3d18f6c8f59942a0 (diff)
Remove the --indirect flag
All GC roots are now indirect.
Diffstat (limited to 'doc/manual')
-rw-r--r--doc/manual/src/command-ref/nix-instantiate.md5
-rw-r--r--doc/manual/src/command-ref/nix-store.md34
2 files changed, 12 insertions, 27 deletions
diff --git a/doc/manual/src/command-ref/nix-instantiate.md b/doc/manual/src/command-ref/nix-instantiate.md
index 5b5ee0439..d09f5ed6a 100644
--- a/doc/manual/src/command-ref/nix-instantiate.md
+++ b/doc/manual/src/command-ref/nix-instantiate.md
@@ -12,7 +12,6 @@ Title: nix-instantiate
[`--arg` *name* *value*]
[{`--attr`| `-A`} *attrPath*]
[`--add-root` *path*]
- [`--indirect`]
[`--expr` | `-E`]
*files…*
@@ -32,8 +31,8 @@ standard input.
# Options
- - `--add-root` *path*; `--indirect`
- See the [corresponding options](nix-store.md) in `nix-store`.
+ - `--add-root` *path*
+ See the [corresponding option](nix-store.md) in `nix-store`.
- `--parse`
Just parse the input files, and print their abstract syntax trees on
diff --git a/doc/manual/src/command-ref/nix-store.md b/doc/manual/src/command-ref/nix-store.md
index 193d670c2..4680339e4 100644
--- a/doc/manual/src/command-ref/nix-store.md
+++ b/doc/manual/src/command-ref/nix-store.md
@@ -9,7 +9,6 @@ Title: nix-store
`nix-store` *operation* [*options…*] [*arguments…*]
[`--option` *name* *value*]
[`--add-root` *path*]
- [`--indirect`]
# Description
@@ -28,27 +27,12 @@ have an effect.
- `--add-root` *path*
Causes the result of a realisation (`--realise` and
`--force-realise`) to be registered as a root of the garbage
- collector. The root is stored in *path*, which must be inside a
- directory that is scanned for roots by the garbage collector
- (i.e., typically in a subdirectory of `/nix/var/nix/gcroots/`)
- *unless* the `--indirect` flag is used.
-
- If there are multiple results, then multiple symlinks will be
- created by sequentially numbering symlinks beyond the first one
- (e.g., `foo`, `foo-2`, `foo-3`, and so on).
-
- - `--indirect`
- In conjunction with `--add-root`, this option allows roots to be
- stored *outside* of the GC roots directory. This is useful for
- commands such as `nix-build` that place a symlink to the build
- result in the current directory; such a build result should not be
- garbage-collected unless the symlink is removed.
-
- The `--indirect` flag causes a uniquely named symlink to *path* to
- be stored in `/nix/var/nix/gcroots/auto/`. For instance,
+ collector. *path* will be created as a symlink to the resulting
+ store path. In addition, a uniquely named symlink to *path* will
+ be created in `/nix/var/nix/gcroots/auto/`. For instance,
```console
- $ nix-store --add-root /home/eelco/bla/result --indirect -r ...
+ $ nix-store --add-root /home/eelco/bla/result -r ...
$ ls -l /nix/var/nix/gcroots/auto
lrwxrwxrwx 1 ... 2005-03-13 21:10 dn54lcypm8f8... -> /home/eelco/bla/result
@@ -63,11 +47,13 @@ have an effect.
> **Warning**
>
- > Note that it is not possible to move or rename indirect GC roots,
- > since the symlink in the `auto` directory will still point to the
- > old location.
+ > Note that it is not possible to move or rename GC roots, since
+ > the symlink in the `auto` directory will still point to the old
+ > location.
-<!-- end list -->
+ If there are multiple results, then multiple symlinks will be
+ created by sequentially numbering symlinks beyond the first one
+ (e.g., `foo`, `foo-2`, `foo-3`, and so on).
# Operation `--realise`