summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorLudovic Courtès <ludo@gnu.org>2020-05-11 22:40:50 +0200
committerLudovic Courtès <ludo@gnu.org>2020-05-11 23:30:54 +0200
commitc2b2c19a7b8b75ef6dd153ca121dd8765cdcd746 (patch)
treed735dc8a1a6f180a67e4f1de4e4a3f271849694f
parent647c57207a36435fe4da20a1c8f4cd4bf7234d5b (diff)
downloadpatches-c2b2c19a7b8b75ef6dd153ca121dd8765cdcd746.tar
patches-c2b2c19a7b8b75ef6dd153ca121dd8765cdcd746.tar.gz
doc: Mention xdot.
* doc/guix.texi (Invoking guix graph): Mention xdot. Remove a couple of "| dot -Tpdf" in examples and add "| xdot". (Invoking guix system): Likewise. (Preparing to Use the Bootstrap Binaries): Likewise.
-rw-r--r--doc/guix.texi19
1 files changed, 13 insertions, 6 deletions
diff --git a/doc/guix.texi b/doc/guix.texi
index 0cba0ee1ec..8d38601201 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -10102,6 +10102,13 @@ The output looks like this:
Nice little graph, no?
+You may find it more pleasant to navigate the graph interactively with
+@command{xdot} (from the @code{xdot} package):
+
+@example
+guix graph coreutils | xdot -
+@end example
+
But there is more than one graph! The one above is concise: it is the
graph of package objects, omitting implicit inputs such as GCC, libc,
grep, etc. It is often useful to have such a concise graph, but
@@ -10136,7 +10143,7 @@ This is the package DAG, @emph{including} implicit inputs.
For instance, the following command:
@example
-guix graph --type=bag-emerged coreutils | dot -Tpdf > dag.pdf
+guix graph --type=bag-emerged coreutils
@end example
...@: yields this bigger graph:
@@ -10190,7 +10197,7 @@ For example, the following command shows the graph for the package
module that defines the @code{guile} package:
@example
-guix graph -t module guile | dot -Tpdf > module-graph.pdf
+guix graph -t module guile | xdot -
@end example
@end table
@@ -27249,10 +27256,10 @@ extensions.)
The command:
@example
-$ guix system extension-graph @var{file} | dot -Tpdf > services.pdf
+$ guix system extension-graph @var{file} | xdot -
@end example
-produces a PDF file showing the extension relations among services.
+shows the extension relations among services.
@anchor{system-shepherd-graph}
@item shepherd-graph
@@ -28649,11 +28656,11 @@ package from source. The command:
@example
guix graph -t bag \
-e '(@@@@ (gnu packages commencement)
- glibc-final-with-bootstrap-bash)' | dot -Tps > t.ps
+ glibc-final-with-bootstrap-bash)' | xdot -
@end example
@noindent
-produces the dependency graph leading to the ``final'' C
+displays the dependency graph leading to the ``final'' C
library@footnote{You may notice the @code{glibc-intermediate} label,
suggesting that it is not @emph{quite} final, but as a good
approximation, we will consider it final.}, depicted below.