Archived
1
0
Fork 0

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.
This commit is contained in:
Ludovic Courtès 2020-05-11 22:40:50 +02:00
parent 647c57207a
commit c2b2c19a7b
No known key found for this signature in database
GPG key ID: 090B11993D9AEBB5

View file

@ -10102,6 +10102,13 @@ The output looks like this:
Nice little graph, no? 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 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, graph of package objects, omitting implicit inputs such as GCC, libc,
grep, etc. It is often useful to have such a concise graph, but 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: For instance, the following command:
@example @example
guix graph --type=bag-emerged coreutils | dot -Tpdf > dag.pdf guix graph --type=bag-emerged coreutils
@end example @end example
...@: yields this bigger graph: ...@: 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: module that defines the @code{guile} package:
@example @example
guix graph -t module guile | dot -Tpdf > module-graph.pdf guix graph -t module guile | xdot -
@end example @end example
@end table @end table
@ -27249,10 +27256,10 @@ extensions.)
The command: The command:
@example @example
$ guix system extension-graph @var{file} | dot -Tpdf > services.pdf $ guix system extension-graph @var{file} | xdot -
@end example @end example
produces a PDF file showing the extension relations among services. shows the extension relations among services.
@anchor{system-shepherd-graph} @anchor{system-shepherd-graph}
@item shepherd-graph @item shepherd-graph
@ -28649,11 +28656,11 @@ package from source. The command:
@example @example
guix graph -t bag \ guix graph -t bag \
-e '(@@@@ (gnu packages commencement) -e '(@@@@ (gnu packages commencement)
glibc-final-with-bootstrap-bash)' | dot -Tps > t.ps glibc-final-with-bootstrap-bash)' | xdot -
@end example @end example
@noindent @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, library@footnote{You may notice the @code{glibc-intermediate} label,
suggesting that it is not @emph{quite} final, but as a good suggesting that it is not @emph{quite} final, but as a good
approximation, we will consider it final.}, depicted below. approximation, we will consider it final.}, depicted below.