From: Emden R. Gansner <erg@alum.mit.edu>
Date: Fri, 25 Jul 2014 19:22:10 +0000 (-0400)
Subject: Add more notes warning about using record shapes.
X-Git-Tag: TRAVIS_CI_BUILD_EXPERIMENTAL~193
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=c52bea9f0085d9bd201e38a6843265269952ecf5;p=graphviz

Add more notes warning about using record shapes.
---

diff --git a/doc/info/shapes.html b/doc/info/shapes.html
index cc0ab2146..2906a526c 100644
--- a/doc/info/shapes.html
+++ b/doc/info/shapes.html
@@ -17,7 +17,7 @@ There are three main types of shapes :
 The record-based shape has largely been superseded and greatly generalized
 by <A HREF=shapes.html#html>HTML-like labels</A>. 
 That is, instead of using <TT>shape=record</TT>, one might
-consider using <TT>shape=none</TT> and an HTML-like label.
+consider using <TT>shape=none</TT>, <TT>margin=0</TT> and an HTML-like label.
 <P>
 The geometry and style of all node shapes are affected by
 the node attributes 
@@ -286,6 +286,11 @@ The synthetic biology shapes:
 were contributed by Jenny Cheng.
 
 <H2><A NAME=record>Record-based Nodes</A></H2>
+<B>NOTE:</B> Please see the note about record-based nodes at the
+<A HREF=#top>top</A> of this page. Also note that there are problems using 
+non-trivial edges (edges with ports or labels) between adjacent
+nodes on the same rank if one or both nodes has a record shape.
+<P>
 These are specified by shape values of "record" and "Mrecord".
 The structure of a record-based node is determined by 
 its <A HREF=attrs.html#d:label><TT>label</TT></A>,
diff --git a/doc/infosrc/shapes.1 b/doc/infosrc/shapes.1
index 1dcaa5bed..90397b1a1 100644
--- a/doc/infosrc/shapes.1
+++ b/doc/infosrc/shapes.1
@@ -17,7 +17,7 @@ There are three main types of shapes :
 The record-based shape has largely been superseded and greatly generalized
 by <A HREF=shapes.html#html>HTML-like labels</A>. 
 That is, instead of using <TT>shape=record</TT>, one might
-consider using <TT>shape=none</TT> and an HTML-like label.
+consider using <TT>shape=none</TT>, <TT>margin=0</TT> and an HTML-like label.
 <P>
 The geometry and style of all node shapes are affected by
 the node attributes 
diff --git a/doc/infosrc/shapes.2 b/doc/infosrc/shapes.2
index 72eab109e..7ec431877 100644
--- a/doc/infosrc/shapes.2
+++ b/doc/infosrc/shapes.2
@@ -78,6 +78,11 @@ The synthetic biology shapes:
 were contributed by Jenny Cheng.
 
 <H2><A NAME=record>Record-based Nodes</A></H2>
+<B>NOTE:</B> Please see the note about record-based nodes at the
+<A HREF=#top>top</A> of this page. Also note that there are problems using 
+non-trivial edges (edges with ports or labels) between adjacent
+nodes on the same rank if one or both nodes has a record shape.
+<P>
 These are specified by shape values of "record" and "Mrecord".
 The structure of a record-based node is determined by 
 its <A HREF=attrs.html#d:label><TT>label</TT></A>,