mirror of
https://git.in.rschanz.org/ryan77627/guix.git
synced 2024-12-24 05:18:07 -05:00
doc: emacs: Document "View graph" popup action.
* doc/emacs.texi (Emacs Popup Interface): Document "View graph" action.
This commit is contained in:
parent
7c0b02f5ae
commit
5e2b761e6a
1 changed files with 43 additions and 0 deletions
|
@ -531,6 +531,49 @@ GNU Emacs Manual}).
|
||||||
|
|
||||||
@end itemize
|
@end itemize
|
||||||
|
|
||||||
|
Several commands (@command{guix graph}, @command{guix system dmd-graph}
|
||||||
|
and @command{guix system extension-graph}) also have a ``View graph''
|
||||||
|
action, which allows you to view a generated graph using @command{dot}
|
||||||
|
command (specified by @code{guix-dot-program} variable). By default a
|
||||||
|
PNG file will be saved in @file{/tmp} directory and will be opened
|
||||||
|
directly in Emacs. This behavior may be changed with the following
|
||||||
|
variables:
|
||||||
|
|
||||||
|
@table @code
|
||||||
|
|
||||||
|
@item guix-find-file-function
|
||||||
|
Function used to open a generated graph. If you want to open a graph in
|
||||||
|
an external program, you can do it by modifying this variable---for
|
||||||
|
example, you can use a functionality provided by the Org Mode
|
||||||
|
(@pxref{Top,,, org, The Org Manual}):
|
||||||
|
|
||||||
|
@example
|
||||||
|
(setq guix-find-file-function 'org-open-file)
|
||||||
|
(add-to-list 'org-file-apps '("\\.png\\'" . "sxiv %s"))
|
||||||
|
@end example
|
||||||
|
|
||||||
|
@item guix-dot-default-arguments
|
||||||
|
Command line arguments to run @command{dot} command. If you change an
|
||||||
|
output format (for example, into @code{-Tpdf}), you also need to change
|
||||||
|
the next variable.
|
||||||
|
|
||||||
|
@item guix-dot-file-name-function
|
||||||
|
Function used to define a name of the generated graph file. Default
|
||||||
|
name is @file{/tmp/guix-emacs-graph-XXXXXX.png}.
|
||||||
|
|
||||||
|
@end table
|
||||||
|
|
||||||
|
So, for example, if you want to generate and open a PDF file in your
|
||||||
|
Emacs, you may change the settings like this:
|
||||||
|
|
||||||
|
@example
|
||||||
|
(defun my-guix-pdf-graph ()
|
||||||
|
"/tmp/my-current-guix-graph.pdf")
|
||||||
|
|
||||||
|
(setq guix-dot-default-arguments '("-Tpdf")
|
||||||
|
guix-dot-file-name-function 'my-guix-pdf-graph)
|
||||||
|
@end example
|
||||||
|
|
||||||
|
|
||||||
@node Emacs Prettify
|
@node Emacs Prettify
|
||||||
@section Guix Prettify Mode
|
@section Guix Prettify Mode
|
||||||
|
|
Loading…
Reference in a new issue