From 6841f8b9e861331f70b4d42d0ab0d3053f32aee2 Mon Sep 17 00:00:00 2001 From: ellson Date: Tue, 18 Oct 2005 21:04:52 +0000 Subject: [PATCH] URL cleanup and html syntax patch from: Ryan Schmidt --- doc/FAQ.html | 65 +++++++++++++++++++++++++++------------------------- 1 file changed, 34 insertions(+), 31 deletions(-) diff --git a/doc/FAQ.html b/doc/FAQ.html index a412d06db..5a11c3596 100644 --- a/doc/FAQ.html +++ b/doc/FAQ.html @@ -1,4 +1,7 @@ + Graphviz FAQ 2004-12-15 +

Graphviz FAQ 2004-12-15

@@ -20,11 +23,11 @@ for a partial list of compatible tools and packages. Q. Where can I see a list of all the attributes that control dot or neato?

-See +See Graph Attributes. There is also information on - + command-line usage and - + output formats.

@@ -55,7 +58,7 @@ please contact ellson, erg, or north@research.att.com.

Also, if a program crashes or you get an abort or something strange occurs and you are fairly comfortable using the tools: - +

Q. I'm trying to make a layout larger. How?

@@ -106,7 +109,7 @@ expand the layout. For twopi and circo, there are other parameters such as ranksep which can be used. See the - + graph attributes.

You can also use the ratio attribute. If you set the size @@ -140,7 +143,6 @@ digraph G { } -

Q. How can I generate graph layouts in PDF?

@@ -179,7 +181,7 @@ is the default. When splines=true, we have no good answer but we are working on it. One trick which is sometimes sufficient is to specify multiple colors for the edge. This will a produce set of tightly parallel splines, each in its specified color. Read about the -color +color attribute for more information.

Clusters

@@ -237,7 +239,7 @@ is drawn between the real nodes as usual.

Q. Clusters are hard to see.

-Set bgcolor=grey +Set bgcolor=grey (or some other color) in the cluster.

@@ -281,7 +283,7 @@ raster drivers that load Truetype or Type1 fonts! (That means, -Tgif, -Tpng, -Tjpeg, and possibly -Tbmp or -Txbm if enabled). -Use UTF8 coding, e.g. ¥ for the Yen +Use UTF8 coding, e.g. ¥ for the Yen currency symbol. Example: graph G { @@ -295,7 +297,7 @@ character set reference . Q. How do I get font and color changes in record labels or other labels?

This is not possible in record shapes. However, you can do this using - + HTML-like labels. The granularity of changes is still at the cell level, but by playing with cell spacing and padding, you can get pretty much the effect you want. The intention is to support arbitrary font changes @@ -321,7 +323,7 @@ all the way to both nodes. It's true. dot -Grankdir=LR rotates record nodes so that their top level fields are still listed across levels. rankdir=LR has no effect in neato. One workaround is - + HTML-like records (they don't rotate; the downside is that you have to write in XML). Another workaround is to enclose record labels in { } to rotate/unrotate the record contents. See also, @@ -361,7 +363,7 @@ might already rely on. Q. How can I get custom shapes or images in my graph?

Please see the - + Shape HowTo for some approaches. There is no easy way to create custom shapes that work with dot/neato, dotty (Unix or MS-Windows) and Grappa (the Java @@ -378,18 +380,18 @@ known bug. Q. How can I get some display feature (such as bold lines) in dotty?

-Dotty has not really changed for many years. Therefore, there are +Dotty has not really changed for many years. Therefore, there are myriad features available in Graphviz which it cannot handle. In some cases, you can use -Grappa -or webdot +Grappa +or webdot for display instead of dotty. For example, Grappa has generalized polygons (node [shape=polygon]) that dotty lacks. There are additional interactive viewers available. For example, see Graphical Interfaces and Viewers. If you -are using MacOSX, the Mac +are using Mac OS X, the Mac version of Graphviz has a highly recommended GUI.

If the display attribute that you need isn't there already, in dotty, @@ -471,11 +473,11 @@ and that it is not commented out!

Q. I've installed Debian Graphviz and it works just fine on the command line, but when I execute a Perl/CGI script through Apache, no output is generated. -For example, the code +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.dot -o /tmp/tree.png");
-produces no file /tmp/tree.png. +produces no file /tmp/tree.png.

As best as we can tell, dot dies with no stdout or stderr messages on Debian systems when run from an Apache cgi program @@ -483,7 +485,7 @@ with no HOME set. The workaround is to provide a HOME directory in the Apache userid's environment.

Someone has also suggested using the - + Perl module for Graphviz.

Q. How can I get 3D output? @@ -498,15 +500,15 @@ scene graphs? Open Scene Graphs? Java3D programs?) we'd like to try it.

neato internally supports layouts in higher dimensions through the dim attribute, e.g. neato -Gdim=7 but there's no way to get the output -unless you invoke neato as a library and inspect ND_pos(n)[i] -where n is a pointer to the relevant node. +unless you invoke neato as a library and inspect ND_pos(n)[i] +where n is a pointer to the relevant node. This would need some (minor) driver work and a good 7-dimensional viewer. Well, dim=3 ought to be possible.

Problems

Q. How can I avoid node overlaps in neato?

-Use the graph attribute overlap. +Use the graph attribute overlap.

Q. How can I avoid node-edge overlaps in neato?

@@ -564,7 +566,7 @@ is a cubic algorithm, so you would do well to avoid using splines=true. Difficult problem. We're working on it. If anyone has some general label placement code (e.g. a simulated annealer based on the Marks et al. -technique in Graphics Gems IV, please get in touch. +technique in Graphics Gems IV), please get in touch.

Q. Dot runs forever on a certain example.

@@ -616,7 +618,7 @@ is also possible for these heuristics to get stuck in local minima. Also, it is heavily influenced by the initial position 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:

+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
@@ -628,7 +630,7 @@ symmetries.
 

 Q.  Webdot doesn't work.
 

-We assume you're using Apache and have TCL installed.
+We assume you're using Apache and have TCL installed.
 If you don't, it's probably better to just use the
 
 webdot perl script.
@@ -671,7 +673,7 @@ simple cgi-bin tcl script like:
 	foreach e [lsort [array names env]] {puts "$e: $env($e)"}
Save this script as .../cgi-bin/test.tcl, make it executable, then -loook at: http://localhost/cgi-bin/test.tcl +look at: http://localhost/cgi-bin/test.tcl

Q. I have "Font not found" errors, or text labels missing in webdot.

@@ -712,11 +714,12 @@ renderer in Java and can be run as a stand-alone program.

For help with embedding SVG in HTML pages, see here. +

Q. libexpat is reported as containing a virus or as a security hole. -Is this a real problem? +Is this a real problem?

No, this is a false positive reported by various security software. -See http://www.pcreview.co.uk/forums/thread-1689630.php or -http://spywareblog.com/index.php/2004/11/24/is_libexpat_dll_spyware. +See http://www.pcreview.co.uk/forums/thread-1689630.php or +http://spywareblog.com/index.php/2004/11/24/is_libexpat_dll_spyware. -- 2.50.1