From e4302e2f1436275d0f170d13eeb431588eac6fde Mon Sep 17 00:00:00 2001 From: erg Date: Wed, 30 Mar 2011 16:44:09 +0000 Subject: [PATCH] Add note on the need to use HTML escape sequences in HTML strings. --- doc/info/shapes.html | 7 ++++++- doc/infosrc/html.1 | 5 +++++ 2 files changed, 11 insertions(+), 1 deletion(-) diff --git a/doc/info/shapes.html b/doc/info/shapes.html index 029c921b1..e93fa3e9b 100644 --- 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.

+As HTML strings are processed like HTML input, any use of +the ", &, <, and > characters in literal text or in attribute values +need to be replaced by the corresponding escape sequence. For example, if you want to +use & in an href value, this should be represented as &amp;. +

NOTE: 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 shape -attribute to plaintext, the HTML label will be the node's +attribute to none or plaintext, the HTML label will be the node's shape. On the other hand, if the node has any other shape (except point), 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 3f1cbdfa3..85cdcec4f 100644 --- 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.

+As HTML strings are processed like HTML input, any use of +the ", &, <, and > characters in literal text or in attribute values +need to be replaced by the corresponding escape sequence. For example, if you want to +use & in an href value, this should be represented as &amp;. +

NOTE: 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 -- 2.40.0