about summary refs log tree commit diff
path: root/doc/manual/command-ref/nix-store.xml
diff options
context:
space:
mode:
authorAntoine Eiche <lewo@abesis.fr>2018-09-29T07·42+0200
committerAntoine Eiche <lewo@abesis.fr>2018-10-20T07·48+0200
commit73c2ae43f08ca35cbb8f86ec7c2efc15ad8686b9 (patch)
treef9e9e24a187bced536401bcffed46d6791267147 /doc/manual/command-ref/nix-store.xml
parent9617a043541d77d79e4f20f9676aae63de72f45d (diff)
Add --graphml option to the nix-store --query command
This prints the references graph of the store paths in the graphML
format [1]. The graphML format is supported by several graph tools
such as the Python Networkx library or the Apache Thinkerpop project.

[1] http://graphml.graphdrawing.org
Diffstat (limited to 'doc/manual/command-ref/nix-store.xml')
-rw-r--r--doc/manual/command-ref/nix-store.xml12
1 files changed, 12 insertions, 0 deletions
diff --git a/doc/manual/command-ref/nix-store.xml b/doc/manual/command-ref/nix-store.xml
index c827d85b3815..41a04f265d7c 100644
--- a/doc/manual/command-ref/nix-store.xml
+++ b/doc/manual/command-ref/nix-store.xml
@@ -679,6 +679,18 @@ query is applied to the target of the symlink.</para>
 
   </varlistentry>
 
+  <varlistentry><term><option>--graphml</option></term>
+
+    <listitem><para>Prints the references graph of the store paths
+    <replaceable>paths</replaceable> in the <link
+    xlink:href="http://graphml.graphdrawing.org/">GraphML</link> file format.
+    This can be used to visualise dependency graphs. To obtain a
+    build-time dependency graph, apply this to a store derivation. To
+    obtain a runtime dependency graph, apply it to an output
+    path.</para></listitem>
+
+  </varlistentry>
+
   <varlistentry><term><option>--binding</option> <replaceable>name</replaceable></term>
     <term><option>-b</option> <replaceable>name</replaceable></term>