Clarify ratio=fill

diff --git a/doc/info/attrs.html b/doc/info/attrs.html
index 49a46c34a0c2082f248d575dc8a452cdee502781..3c30e0d45df93b30560298abe5a6d676661fb74b 100644 (file)
--- a/doc/info/attrs.html
+++ b/doc/info/attrs.html
@@ -1411,6 +1411,8 @@ This field indicates which graph component uses the attribute.
 <DD>  Sets the aspect ratio (drawing height/drawing width) for the drawing.
   Note that this is adjusted before
   the <A HREF=#d:size><B>size</B></A> attribute constraints are enforced.
+  In addition, the calculations usually ignore the node sizes, so the
+  final drawing size may only approximate what is desired.
   <P>
   If <B>ratio</B> is numeric, it is taken as the desired aspect ratio.
   Then, if the actual aspect ratio is less than the desired ratio,
@@ -1421,6 +1423,18 @@ This field indicates which graph component uses the attribute.
   If <B>ratio</B> = "fill" and the <A HREF=#d:size><B>size</B></A>
   attribute is set, node positions are scaled, separately in both x
   and y, so that the final drawing exactly fills the specified size.
+  If both <A HREF=#d:size><B>size</B></A> values exceed the width
+  and height of the drawing, then both coordinate values of each
+  node are scaled up accordingly. However, if either size dimension
+  is smaller than the corresponding dimension in the drawing, one
+  dimension is scaled up so that the final drawing has the same aspect
+  ratio as specified by <A HREF=#d:size><B>size</B></A>. 
+  Then, when rendered, the layout will be
+  scaled down uniformly in both dimensions to fit the given
+  <A HREF=#d:size><B>size</B></A>, which may cause nodes and text
+  to shrink as well. This may not be what the user
+  wants, but it avoids the hard problem of how to reposition the
+  nodes in an acceptable fashion to reduce the drawing size.
   <P>
   If <B>ratio</B> = "compress" and the <A HREF=#d:size><B>size</B></A>
   attribute is set, dot attempts to compress the initial layout to fit

diff --git a/doc/infosrc/attrs b/doc/infosrc/attrs
index 2f84fcdf73067f0fcd20aa34c600144b2478f49b..234a63318672459bdcce845fd5a0b7d3fd1f2175 100644 (file)
--- a/doc/infosrc/attrs
+++ b/doc/infosrc/attrs
@@ -881,6 +881,8 @@ numbers, the last number is used as the increment for the remainder.
 Sets the aspect ratio (drawing height/drawing width) for the drawing.
 Note that this is adjusted before
 the <A HREF=#d:size><B>size</B></A> attribute constraints are enforced.
+In addition, the calculations usually ignore the node sizes, so the
+final drawing size may only approximate what is desired.
 <P>
 If <B>ratio</B> is numeric, it is taken as the desired aspect ratio.
 Then, if the actual aspect ratio is less than the desired ratio,
@@ -891,6 +893,18 @@ the drawing width is scaled up.
 If <B>ratio</B> = "fill" and the <A HREF=#d:size><B>size</B></A>
 attribute is set, node positions are scaled, separately in both x
 and y, so that the final drawing exactly fills the specified size.
+If both <A HREF=#d:size><B>size</B></A> values exceed the width
+and height of the drawing, then both coordinate values of each
+node are scaled up accordingly. However, if either size dimension
+is smaller than the corresponding dimension in the drawing, one
+dimension is scaled up so that the final drawing has the same aspect
+ratio as specified by <A HREF=#d:size><B>size</B></A>. 
+Then, when rendered, the layout will be
+scaled down uniformly in both dimensions to fit the given
+<A HREF=#d:size><B>size</B></A>, which may cause nodes and text
+to shrink as well. This may not be what the user
+wants, but it avoids the hard problem of how to reposition the
+nodes in an acceptable fashion to reduce the drawing size.
 <P>
 If <B>ratio</B> = "compress" and the <A HREF=#d:size><B>size</B></A>
 attribute is set, dot attempts to compress the initial layout to fit