Add note on how width and height are used for regular node shapes

diff --git a/doc/info/attrs.html b/doc/info/attrs.html
index 3c30e0d45df93b30560298abe5a6d676661fb74b..6a59a2517ae9ae86e44f1827c9dbf1a3adc84ef3 100644 (file)
--- a/doc/info/attrs.html
+++ b/doc/info/attrs.html
@@ -847,6 +847,14 @@ This field indicates which graph component uses the attribute.
   requires more height to fit, the node's height will be increased to
   contain the label. Note also that, if the output format is dot, the
   value given to <B>height</B> will be the final value.
+  <P>
+  If the node shape is regular, the width and height are made identical.
+  In this case, if either the width or the height is set explicitly,
+  that value is used.
+  In this case, if both the width or the height are set explicitly,
+  the maximum of the two values is used.
+  If neither is set explicitly, the minimum of the two default values
+  is used.
 
 <DT><A NAME=d:href HREF=#a:href><STRONG>href</STRONG></A>
 <DD>  Synonym for <A HREF=#d:URL>URL</A>.
@@ -1462,7 +1470,8 @@ This field indicates which graph component uses the attribute.
 <DD>  Rectangles for fields of records, <A HREF=#points>in points</A>.
 
 <DT><A NAME=d:regular HREF=#a:regular><STRONG>regular</STRONG></A>
-<DD>  If true, force polygon to be regular.
+<DD>  If true, force polygon to be regular, i.e., the vertices of the
+  polygon will lie on a circle whose center is the center of the node.
 
 <DT><A NAME=d:remincross HREF=#a:remincross><STRONG>remincross</STRONG></A>
 <DD>  If true and there are multiple clusters, run cross
@@ -1711,6 +1720,14 @@ This field indicates which graph component uses the attribute.
   requires more width to fit, the node's width will be increased to
   contain the label. Note also that, if the output format is dot, the
   value given to <B>width</B> will be the final value.
+  <P>
+  If the node shape is regular, the width and height are made identical.
+  In this case, if either the width or the height is set explicitly,
+  that value is used.
+  In this case, if both the width or the height are set explicitly,
+  the maximum of the two values is used.
+  If neither is set explicitly, the minimum of the two default values
+  is used.
 
 <DT><A NAME=d:z HREF=#a:z><STRONG>z</STRONG></A>
 <DD>  <B>Deprecated:</B>Use <A HREF=#d:pos><B>pos</B></A> attribute, along

diff --git a/doc/infosrc/attrs b/doc/infosrc/attrs
index 234a63318672459bdcce845fd5a0b7d3fd1f2175..8b56c3017a98a245973deeacb690048a0eefe445 100644 (file)
--- a/doc/infosrc/attrs
+++ b/doc/infosrc/attrs
@@ -374,6 +374,14 @@ will be the final height of the node. Otherwise, if the node label
 requires more height to fit, the node's height will be increased to
 contain the label. Note also that, if the output format is dot, the
 value given to <B>height</B> will be the final value.
+<P>
+If the node shape is regular, the width and height are made identical.
+In this case, if either the width or the height is set explicitly,
+that value is used.
+In this case, if both the width or the height are set explicitly,
+the maximum of the two values is used.
+If neither is set explicitly, the minimum of the two default values
+is used.
 :href:E:escString:"";  map,ps,svg
 Synonym for <A HREF=#d:URL>URL</A>.
 :id:GNE:lblString:"";  map,ps,svg
@@ -930,7 +938,8 @@ new size. This feature only works in dot.
 :rects:N:rect; write
 Rectangles for fields of records, <A HREF=#points>in points</A>.
 :regular:N:bool:false;
-If true, force polygon to be regular.
+If true, force polygon to be regular, i.e., the vertices of the
+polygon will lie on a circle whose center is the center of the node.
 :remincross:G:bool:false;  dot
 If true and there are multiple clusters, run cross
 minimization a second time.
@@ -1148,6 +1157,14 @@ will be the final width of the node. Otherwise, if the node label
 requires more width to fit, the node's width will be increased to
 contain the label. Note also that, if the output format is dot, the
 value given to <B>width</B> will be the final value.
+<P>
+If the node shape is regular, the width and height are made identical.
+In this case, if either the width or the height is set explicitly,
+that value is used.
+In this case, if both the width or the height are set explicitly,
+the maximum of the two values is used.
+If neither is set explicitly, the minimum of the two default values
+is used.
 :z:N:double:0.0:-MAXFLOAT/-1000;
 <B>Deprecated:</B>Use <A HREF=#d:pos><B>pos</B></A> attribute, along
 with <A HREF=#d:dimen><B>dimen</B></A> and/or <A HREF=#d:dim><B>dim</B></A>