From: Emden R. Gansner <erg@alum.mit.edu>
Date: Mon, 2 Dec 2013 23:08:43 +0000 (-0500)
Subject: Update xdot description;
X-Git-Tag: 2.38.0~146
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=1d0902cfa3e8343002c04fdca04af13bfb305fbf;p=graphviz

Update xdot description;
note that dot or xdot output may create attributes that affect future
layouts
---

diff --git a/doc/libguide/basic.tex b/doc/libguide/basic.tex
index e340a7c51..45a431f27 100644
--- a/doc/libguide/basic.tex
+++ b/doc/libguide/basic.tex
@@ -912,6 +912,16 @@ information with a call to {\tt gvFreeLayout}
 before invoking a new layout function.
 An example of this was given in Figure~\ref{fig:nop}.
 
+Note that if you render a graph into the {\tt dot} or {\tt xdot}
+format, this attaches attributes onto the graph. Some of these attributes
+are used during layout. For example, the {\tt neato} layout will use
+the {\tt pos} attribute of the nodes for an initial layout, while the
+{\tt twopi} layout may set the {\tt root} attribute, which will lock in
+this attribute for any future layouts using {\tt twopi}.
+To avoid having these attributes affecting another
+layout of the graph, the user should should set these attributes to the
+empty string before calling {\tt gvLayout} again.
+
 Once the application is totally done with a graph, it should call
 {\tt agclose} to close the graph and reclaim the remaining resources associated
 with it.
diff --git a/doc/libguide/intro.tex b/doc/libguide/intro.tex
index 52f933fb7..5e80bc35d 100644
--- a/doc/libguide/intro.tex
+++ b/doc/libguide/intro.tex
@@ -166,6 +166,8 @@ Text drawn using the baseline point $(x,y)$. The text consists of the
 $n$ bytes following {\tt '-'}. The text should be left-aligned (centered,
 right-aligned) on the point if $j$ is -1 (0, 1), respectively. The 
 value $w$ gives the width of the text as computed by the library.  \\
+${\tt t}\ f$ &
+Set font characteristics. The integer f is the OR of BOLD=1, ITALIC=2, UNDERLINE=4, SUPERSCRIPT=8, SUBSCRIPT=16, and STRIKE-THROUGH=32. \\
 ${\tt C}\ n\ {\tt -}c_{1}c_{2}\cdots c_{n}$ & Set color used to fill closed
 regions. The
 color is specified by the $n$ characters following {\tt '-'}. \\
@@ -177,6 +179,9 @@ size is $s$ points. The font name
 is specified by the $n$ characters following {\tt '-'}. \\
 ${\tt S}\ n\ {\tt -}c_{1}c_{2}\cdots c_{n}$ & Set style attribute. The
 style value is specified by the $n$ characters following {\tt '-'}. \\
+${\tt I}\ x\ y\ j\ w\ n\ {\tt -}c_{1}c_{2}\cdots c_{n}$ &
+Externally-specified image drawn in the box with lower left corner $(x,y)$ 
+and upper right corner $(x+w,y+h)$. The name of the image consists of the $n$ bytes following '-'. This is usually a bitmap image. Note that the image size, even when converted from pixels to points, might be different from the required size $(w,h)$. It is assumed the renderer will perform the necessary scaling.\\
 \hline
 \end{tabular}
 \caption{{\tt xdot} drawing operations}
diff --git a/doc/libguide/libguide.pdf b/doc/libguide/libguide.pdf
index 11254329d..60c6860b8 100644
Binary files a/doc/libguide/libguide.pdf and b/doc/libguide/libguide.pdf differ