nix run: Tweak docs

1 files changed, 9 insertions, 5 deletions

diff --git a/src/nix/run.md b/src/nix/run.md
index 697db9a96..cd3b978c0 100644
--- a/src/nix/run.md
+++ b/src/nix/run.md
@@ -43,11 +43,15 @@ program specified by the app definition.
 
 If *installable* evaluates to a derivation, it will try to execute the
 program `<out>/bin/<name>`, where *out* is the primary output store
-path of the derivation and *name* is the `meta.mainProgram` attribute
-of the derivation if it exists, and otherwise the `pname` attribute of
-the derivation or the name part of the value of the `name` attribute of
-the derivation (e.g. if `name` is set to `hello-1.10`, it will run
-`$out/bin/hello`).
+path of the derivation, and *name* is the first of the following that
+exists:
+
+* The `meta.mainProgram` attribute of the derivation.
+* The `pname` attribute of the derivation.
+* The name part of the value of the `name` attribute of the derivation.
+
+For instance, if `name` is set to `hello-1.10`, `nix run` will run
+`$out/bin/hello`.
 
 # Flake output attributes