nixos/nix
1
1
Fork 0
mirror of https://github.com/NixOS/nix.git synced 2025-12-13 12:31:04 +01:00
Code Activity

Document and test -- separator behavior with installables

Browse source 
Clarifies that the first positional argument is always treated as the
installable, even after --. Adds tests to prevent accidental change.

Addresses https://github.com/NixOS/nix/issues/13994
This commit is contained in:
Robert Hensing 2025-11-26 22:19:29 +01:00
parent aa0265f77e
commit 38bb7f532c
2 changed files with 44 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

10
src/nix/run.md
View file

@ -33,6 +33,16 @@ R""(
# nix run nixpkgs#vim -- --help
```
* Run the default app from the current directory with arguments:
```console
# nix run . -- arg1 arg2
```
Note: The first positional argument is always treated as the *installable*,
even after `--`. To pass arguments to the default installable, specify it
explicitly: `nix run . -- arg1 arg2` or `nix run -- . arg1 arg2`.
# Description
`nix run` builds and runs [*installable*](./nix.md#installables), which must evaluate to an