Add note on the need to use HTML escape sequences in HTML strings.

diff --git a/doc/info/shapes.html b/doc/info/shapes.html
index 029c921b1550fffb6b1fe80f0d43ed49b14e573b..e93fa3e9b1a2de73fd4c4dc99f0ab1fb91083958 100644 (file)
--- a/doc/info/shapes.html
+++ b/doc/info/shapes.html
@@ -325,6 +325,11 @@ can describe multiple lines of variously aligned text as provided by ordinary
 label can specify a table similar to those provided by HTML,
 with different graphical attributes at each level.
 <P>
+As <A HREF=lang.html#html>HTML strings</A> are processed like HTML input, any use of
+the &quot;, &amp;, &lt;, and &gt; characters in literal text or in attribute values
+need to be replaced by the corresponding escape sequence. For example, if you want to
+use  &amp; in an <TT>href</TT> value, this should be represented as  &amp;amp;.
+<P>
 <B>NOTE:</B> The features and syntax supported by these labels are
 modeled on HTML. However, there are many aspects that are relevant
 to Graphviz labels that are not in HTML and, conversely, HTML allows
@@ -337,7 +342,7 @@ Although HTML labels are not, strictly speaking, a shape, they can be
 viewed as a generalization of the record shapes described above. 
 In particular, if a node has set its 
 <A HREF=attrs.html#k:shape><TT>shape</TT></A>
-attribute to <TT>plaintext</TT>, the HTML label will be the node's
+attribute to <TT>none</TT> or <TT>plaintext</TT>, the HTML label will be the node's
 shape. On the other hand, if the node has any other shape (except 
 <TT>point</TT>), the HTML label will be embedded within the node the
 same way an ordinary label would be.

diff --git a/doc/infosrc/html.1 b/doc/infosrc/html.1
index 3f1cbdfa3dbf50c219399bddff1564b3fd949c05..85cdcec4f1d7c670394d0232a350fc3f497060d1 100644 (file)
--- a/doc/infosrc/html.1
+++ b/doc/infosrc/html.1
@@ -20,6 +20,11 @@ can describe multiple lines of variously aligned text as provided by ordinary
 label can specify a table similar to those provided by HTML,
 with different graphical attributes at each level.
 <P>
+As <A HREF=lang.html#html>HTML strings</A> are processed like HTML input, any use of
+the &quot;, &amp;, &lt;, and &gt; characters in literal text or in attribute values
+need to be replaced by the corresponding escape sequence. For example, if you want to
+use  &amp; in an <TT>href</TT> value, this should be represented as  &amp;amp;.
+<P>
 <B>NOTE:</B> The features and syntax supported by these labels are
 modeled on HTML. However, there are many aspects that are relevant
 to Graphviz labels that are not in HTML and, conversely, HTML allows