From ffe2dd40f4fae2d8f0ff94063c8522efddc2a3e6 Mon Sep 17 00:00:00 2001 From: Teo Camarasu Date: Sat, 22 Feb 2025 21:42:06 +0000 Subject: [PATCH] doc: improve entry for `nix-store --query --valid-derivers` Let's use similar terminology and formatting to the other entries, and make it a bit clearer. The information here is based on the changelog entry from when this feature was added. Change-Id: Ia859c710588180ca827c665a70650eb4db5a1c45 --- doc/manual/src/command-ref/nix-store/query.md | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/doc/manual/src/command-ref/nix-store/query.md b/doc/manual/src/command-ref/nix-store/query.md index 37f1b63a9..0041e6a94 100644 --- a/doc/manual/src/command-ref/nix-store/query.md +++ b/doc/manual/src/command-ref/nix-store/query.md @@ -93,9 +93,12 @@ symlink. [deriver]: ../../glossary.md#gloss-deriver - `--valid-derivers`\ - Prints a set of derivation files (`.drv`) which are supposed produce - said paths when realized. Might print nothing, for example for source paths - or paths subsituted from a binary cache. + Prints the set of all [derivers](../../glossary.md#gloss-deriver) that can be + used to build the store paths *paths*. + This differs from `--deriver`, which prints the deriver that actually + produced *paths*. + No deriver may be returned if is not present in the store, + eg, if *paths* were substituted from a binary cache. - `--graph`\ Prints the references graph of the store paths *paths* in the format