aboutsummaryrefslogtreecommitdiff
path: root/src/nix/registry-list.md
diff options
context:
space:
mode:
authorEelco Dolstra <edolstra@gmail.com>2020-12-08 22:57:14 +0100
committerEelco Dolstra <edolstra@gmail.com>2020-12-21 13:32:27 +0100
commite90e74523238f37748d9f406732919374d7ee561 (patch)
treed7be371a9ab3a1c9ca2c0eb3c45527e0ee95de98 /src/nix/registry-list.md
parent42cc98f8d66627ff7e396fb809034d3389b3bd0a (diff)
Add 'nix registry' manpages
This also documents the registry format and matching/unification semantics (though not quite correctly).
Diffstat (limited to 'src/nix/registry-list.md')
-rw-r--r--src/nix/registry-list.md29
1 files changed, 29 insertions, 0 deletions
diff --git a/src/nix/registry-list.md b/src/nix/registry-list.md
new file mode 100644
index 000000000..30b6e29d8
--- /dev/null
+++ b/src/nix/registry-list.md
@@ -0,0 +1,29 @@
+R""(
+
+# Examples
+
+* Show the contents of all registries:
+
+ ```console
+ # nix registry list
+ user flake:dwarffs github:edolstra/dwarffs/d181d714fd36eb06f4992a1997cd5601e26db8f5
+ system flake:nixpkgs path:/nix/store/fxl9mrm5xvzam0lxi9ygdmksskx4qq8s-source?lastModified=1605220118&narHash=sha256-Und10ixH1WuW0XHYMxxuHRohKYb45R%2fT8CwZuLd2D2Q=&rev=3090c65041104931adda7625d37fa874b2b5c124
+ global flake:blender-bin github:edolstra/nix-warez?dir=blender
+ global flake:dwarffs github:edolstra/dwarffs
+ …
+ ```
+
+# Description
+
+This command displays the contents of all registries on standard
+output. Each line represents one registry entry in the format *type*
+*from* *to*, where *type* denotes the registry containing the entry:
+
+* `flags`: entries specified on the command line using `--override-flake`.
+* `user`: the user registry.
+* `system`: the system registry.
+* `global`: the global registry.
+
+See the [`nix registry` manual page](./nix3-registry.md) for more details.
+
+)""