02/03: doc: emacs: Document "View graph" popup action.

[Alex Kost]

alezost pushed a commit to branch master
in repository guix.

commit 5e2b761e6adda10c86f2f0038dc7c62ac7a640cc
Author: Alex Kost <address@hidden>
Date:   Fri Oct 16 17:50:36 2015 +0300

    doc: emacs: Document "View graph" popup action.
    
    * doc/emacs.texi (Emacs Popup Interface): Document "View graph" action.
---
 doc/emacs.texi |   43 +++++++++++++++++++++++++++++++++++++++++++
 1 files changed, 43 insertions(+), 0 deletions(-)

diff --git a/doc/emacs.texi b/doc/emacs.texi
index ab69515..0e901e1 100644
--- a/doc/emacs.texi
+++ b/doc/emacs.texi
@@ -531,6 +531,49 @@ GNU Emacs Manual}).
 
 @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:
+
address@hidden @code
+
address@hidden 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}):
+
address@hidden
+(setq guix-find-file-function 'org-open-file)
+(add-to-list 'org-file-apps '("\\.png\\'" . "sxiv %s"))
address@hidden example
+
address@hidden 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.
+
address@hidden 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}.
+
address@hidden table
+
+So, for example, if you want to generate and open a PDF file in your
+Emacs, you may change the settings like this:
+
address@hidden
+(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)
address@hidden example
+
 
 @node Emacs Prettify
 @section Guix Prettify Mode