From e374d80155646b9551948a27b8fe1ccc6ce6eb74 Mon Sep 17 00:00:00 2001 From: erg Date: Tue, 2 Nov 2010 20:11:49 +0000 Subject: [PATCH] Remove .dot uses from most documentation --- doc/Dot.ref | 2 +- doc/FAQ.html | 16 ++++++++-------- doc/dotguide/dotguide.tex | 8 ++++---- doc/dotguide/ndotguide.tex | 6 +++--- doc/dotty/progs/progfa.tex | 2 +- doc/dotty/section1.tex | 2 +- doc/fontfaq.txt | 4 ++-- doc/infosrc/command.html | 2 +- doc/infosrc/outputs | 6 +++--- doc/neato/neato.tex | 12 ++++++------ 10 files changed, 30 insertions(+), 30 deletions(-) diff --git a/doc/Dot.ref b/doc/Dot.ref index 866550637..edf7096c9 100644 --- a/doc/Dot.ref +++ b/doc/Dot.ref @@ -746,7 +746,7 @@ cmap form of the output, e.g. in JPEG or GIF format, to attach links to nodes and edges. For example, given the dot file - /* x.dot */ + /* x.gv */ digraph G { URL="http://www.research.att.com/"; command [URL="command.html"]; diff --git a/doc/FAQ.html b/doc/FAQ.html index 8e8bb8c6f..486ff5b5e 100644 --- a/doc/FAQ.html +++ b/doc/FAQ.html @@ -556,7 +556,7 @@ Typically this error is reported as: >> context: >>> <<< digraph G { >> dotty.lefty: giving up on dot >> dotty.lefty: graph that causes dot ->> dotty.lefty: to fail has been saved in file dottybug.dot +>> dotty.lefty: to fail has been saved in file dottybug.gv Probably there is a command in your shell environment (such as .alias or .profile) that does output even for non-interactive shells. @@ -614,7 +614,7 @@ file. Then run neato -s -n2. For example: 
-neato -s -n2 -Tgif file.dot -o file.gif
+neato -s -n2 -Tgif file.gv -o file.gif
Note that if an edge does not have a pos attribute defined, neato will perform whatever edge routing it would @@ -630,7 +630,7 @@ It's not really too convenient to use dot for this. It is possible to use neato for this, running neato -s -n For example: 
-neato -s -n -Tgif file.dot -o file.gif
+neato -s -n -Tgif file.gv -o file.gif
neato will use the node positions, but use its technique for routing the edges. There are several things to note. First, @@ -679,7 +679,7 @@ and that it is not commented out! but when I execute a Perl/CGI script through Apache, no output is generated. For example, the code -system("/usr/local/bin/dot -Tpng /tmp/tree.dot -o /tmp/tree.png"); +system("/usr/local/bin/dot -Tpng /tmp/tree.gv -o /tmp/tree.png"); produces no file /tmp/tree.png.

@@ -852,8 +852,8 @@ of the nodes. It is quite possible that if you run neato again, but with a different random seed value, or more iterations, you'll get a better layout. For example: 

-neato -Gstart=5 file.dot -Tps -o file.ps
-neato -Gepsilon=.0000001 file.dot -Tps -o file.ps
+neato -Gstart=5 file.gv -Tps -o file.ps
+neato -Gepsilon=.0000001 file.gv -Tps -o file.ps

In particular, note that there are no guarantees that neato will produce @@ -1053,9 +1053,9 @@ or

which deletes the Launch Services database and rebuilds it from existing apps. You may need to sudo to do this.

-3. Verify that the Graphviz.app can now open .dot files and Microsoft Word can still open its own .dot files. +3. Verify that the Graphviz.app can now open .gv files and Microsoft Word can still open its own .gv files.

-One artifact of this will be that Microsoft .dot files may appear with the Graphviz document icon. Unfortunately there doesn't seem any a priori way of getting the system to determine whether an arbitrary .dot file belongs to Word or Graphviz -- you can choose which application to open with by right-clicking or control-clicking on the document icon and choosing the app. +One artifact of this will be that Microsoft .gv files may appear with the Graphviz document icon. Unfortunately there doesn't seem any a priori way of getting the system to determine whether an arbitrary .gv file belongs to Word or Graphviz -- you can choose which application to open with by right-clicking or control-clicking on the document icon and choosing the app.

As for why the Launch Services database doesn't automatically register Graphviz, we're not entirely sure but suspect this only happens if both conditions diff --git a/doc/dotguide/dotguide.tex b/doc/dotguide/dotguide.tex index c08c7f7cd..98afd1c4d 100644 --- a/doc/dotguide/dotguide.tex +++ b/doc/dotguide/dotguide.tex @@ -8,7 +8,7 @@ \def\dag{{\it dag}} \def\DOT{{\it DOT}} \def\graphviz{{\it Graphviz}} -\newcommand{\lastedited}{December 22, 2009} +\newcommand{\lastedited}{November 2, 2010} \date{\lastedited} \newcommand{\mymark}{{\it dot} User's Manual, \lastedited \hfil } \markboth{\mymark}{\mymark} @@ -121,9 +121,9 @@ A node is created when its name first appears in the file. An edge is created when nodes are joined by the edge operator \verb"->". In the example, line 2 makes edges from {\it main} to {\it parse}, and from {\it parse} to {\it execute}. -Running \dot\ on this file (call it \verb"graph1.dot") +Running \dot\ on this file (call it \verb"graph1.gv") \begin{verbatim} - $ dot -Tps graph1.dot -o graph1.ps + $ dot -Tps graph1.gv -o graph1.ps \end{verbatim} yields the drawing of Figure~\ref{fig:drawing1}. The command line option \verb"-Tps" selects PostScript (EPSF) output. @@ -493,7 +493,7 @@ the following line in a file \verb"lib.ps". \end{verbatim} Use the \verb"-l" command line option to load this file. \begin{verbatim} - dot -Tps -l lib.ps file.dot -o file.ps + dot -Tps -l lib.ps file.gv -o file.ps \end{verbatim} The {\tt style} attribute controls miscellaneous graphics features of diff --git a/doc/dotguide/ndotguide.tex b/doc/dotguide/ndotguide.tex index 05f0eef40..fa2bf8185 100644 --- a/doc/dotguide/ndotguide.tex +++ b/doc/dotguide/ndotguide.tex @@ -124,9 +124,9 @@ A node is created when its name first appears in the file. An edge is created when nodes are joined by the edge operator \verb"->". In the example, line 2 makes edges from {\it main} to {\it parse}, and from {\it parse} to {\it execute}. -Running \dot\ on this file (call it \verb"graph1.dot") +Running \dot\ on this file (call it \verb"graph1.gv") \begin{verbatim} - $ dot -Tps graph1.dot -o graph1.ps + $ dot -Tps graph1.gv -o graph1.ps \end{verbatim} yields the drawing of Figure~\ref{fig:drawing1}. The command line option \verb"-Tps" selects PostScript (EPSF) output. @@ -649,7 +649,7 @@ the following line in a file \verb"lib.ps". \end{verbatim} Use the \verb"-l" command line option to load this file. \begin{verbatim} - dot -Tps -l lib.ps file.dot -o file.ps + dot -Tps -l lib.ps file.gv -o file.ps \end{verbatim} The {\tt style} attribute controls miscellaneous graphics features of diff --git a/doc/dotty/progs/progfa.tex b/doc/dotty/progs/progfa.tex index cae74663b..f68561948 100644 --- a/doc/dotty/progs/progfa.tex +++ b/doc/dotty/progs/progfa.tex @@ -24,7 +24,7 @@ fa.main = function () { gnvt = dotty.createviewandgraph (null, 'file', fa.protogt, fa.protovt); gt = gnvt.gt; - gt.loadgraph (gt, 'fa.dot', 'file', fa.protogt.graph, 1); + gt.loadgraph (gt, 'fa.gv', 'file', fa.protogt.graph, 1); fa.currstate = gt.graph.nodes[gt.graph.nodedict['start']]; fa.loadtrans ('fa.trans'); fa.setcurrcolor (gt, fa.currstate); diff --git a/doc/dotty/section1.tex b/doc/dotty/section1.tex index 3c53bca1d..1099f09a1 100644 --- a/doc/dotty/section1.tex +++ b/doc/dotty/section1.tex @@ -30,7 +30,7 @@ explicitly. As an example, the user can start up {\DOTTY} and select \verb+load graph+ from the menu. Figure~\ref{figdotty1}a shows the \verb+DOTTY+ window and the dialog window that asks for the graph file name. In this example, the user asks for -file \verb+d.dot+. Figure~\ref{figdotty1}b shows the result of the \verb+load +file \verb+d.gv+. Figure~\ref{figdotty1}b shows the result of the \verb+load graph+ action. \begin{figure}[htb] diff --git a/doc/fontfaq.txt b/doc/fontfaq.txt index b5d790b0b..043df5d2f 100644 --- a/doc/fontfaq.txt +++ b/doc/fontfaq.txt @@ -114,7 +114,7 @@ name translation. Font selection. =============== -The fontname attribute in .dot graphs is a fontconfig style specification. +The fontname attribute in .gv graphs is a fontconfig style specification. From: http://www.fontconfig.org/fontconfig-user.html Fontconfig provides a textual representation for patterns that @@ -165,7 +165,7 @@ How can I tell what fonts are available? $ fc-list How can I tell what fonts dot is using; - $ dot foo.dot -Tpng -o foo.png -v 2>&1 | grep font + $ dot foo.gv -Tpng -o foo.png -v 2>&1 | grep font How can I add a custom font? In the current version of Graphviz with fontconfig, Cairo and diff --git a/doc/infosrc/command.html b/doc/infosrc/command.html index b0b4a811c..11f99b618 100644 --- a/doc/infosrc/command.html +++ b/doc/infosrc/command.html @@ -159,7 +159,7 @@ Note that sometimes, when using one of the layout programs in a web script, it is not enough to use an export command but rather the variables should be set when the command is run, for example,
-SERVER_NAME=xxx GV_FILE_PATH="images:etc/images:/usr/share/images" dot -Tpng -o x.png x.dot +SERVER_NAME=xxx GV_FILE_PATH="images:etc/images:/usr/share/images" dot -Tpng -o x.png x.gv

Note that the image files must really reside in one of the specified directories. If the diff --git a/doc/infosrc/outputs b/doc/infosrc/outputs index fd6c70e2d..b0267f9f7 100644 --- a/doc/infosrc/outputs +++ b/doc/infosrc/outputs @@ -65,7 +65,7 @@ a graphical form of the output, e.g. in JPEG or GIF format, to attach links to nodes and edges. For example, to create a server-side map given the dot file 

-/* x.dot */
+/* x.gv */
 digraph mainmap {
   URL="http://www.research.att.com/base.html";
   command [URL="http://www.research.att.com/command.html"];
@@ -74,7 +74,7 @@ digraph mainmap {
one would process the graph and generate two output files: 
-dot -Timap -ox.map -Tgif -ox.gif x.dot
+dot -Timap -ox.map -Tgif -ox.gif x.gv
and then refer to it in a web page: @@ -82,7 +82,7 @@ and then refer to it in a web page: For client-side maps, one again generates two output files: 
-dot -Tcmapx -ox.map -Tgif -ox.gif x.dot
+dot -Tcmapx -ox.map -Tgif -ox.gif x.gv
and uses the HTML diff --git a/doc/neato/neato.tex b/doc/neato/neato.tex index 20e5053a2..d6d52ed8d 100644 --- a/doc/neato/neato.tex +++ b/doc/neato/neato.tex @@ -122,11 +122,11 @@ encode many-to-many dependencies. \begin{figure}[h] \begin{minipage}[b]{2in} \begin{verbatim} -$ cat example.dot +$ cat example.gv graph G { n0 -- n1 -- n2 -- n3 -- n0; } -$ neato -Tps example.dot -o example.ps +$ neato -Tps example.gv -o example.ps \end{verbatim} @@ -213,7 +213,7 @@ generator. The layout is different for each seed, but still deterministic. If the value is not a number, the process ID or current time is used. Each run potentially yields a different drawing. For example: \begin{verbatim} -$ neato -Tps -Gstart=rand file.dot > file.ps +$ neato -Tps -Gstart=rand file.gv > file.ps \end{verbatim} \subsection{Termination Threshold} @@ -231,9 +231,9 @@ $\epsilon$ is set in the graph's \verb"epsilon" variable. You can also directly limit the number of iterations. It is convenient to do this on the command line: \begin{verbatim} -$ neato -Tps -Gepsilon=.001 small.dot -o small.ps -$ neato -Tps -Gepsilon=1.5 big.dot -o big.ps -$ neato -Tps -Gmaxiter=1000 big.dot -o big.ps +$ neato -Tps -Gepsilon=.001 small.gv -o small.ps +$ neato -Tps -Gepsilon=1.5 big.gv -o big.ps +$ neato -Tps -Gmaxiter=1000 big.gv -o big.ps \end{verbatim} \subsection{Edge Lengths and Weights} -- 2.40.0