From: erg <devnull@localhost>
Date: Thu, 28 May 2009 23:05:30 +0000 (+0000)
Subject: Add info on new packmodes
X-Git-Tag: LAST_LIBGRAPH~32^2~1972
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=d30f5e32762270df198ec670aebfd39695d63df8;p=graphviz

Add info on new packmodes
---

diff --git a/doc/info/attrs.html b/doc/info/attrs.html
index 9ed6ab29a..3704f8e98 100644
--- a/doc/info/attrs.html
+++ b/doc/info/attrs.html
@@ -409,6 +409,8 @@ This field indicates which graph component uses the attribute.
  <TR><TD><A NAME=a:smoothing HREF=#d:smoothing>smoothing</A>
 </TD><TD>G</TD><TD><A HREF=#k:smoothType>smoothType</A>
 </TD><TD ALIGN="CENTER">"none"</TD><TD></TD><TD>sfdp only</TD> </TR>
+ <TR><TD><A NAME=a:sortv HREF=#d:sortv>sortv</A>
+</TD><TD>GCN</TD><TD>int</TD><TD ALIGN="CENTER">0</TD><TD>0</TD><TD></TD> </TR>
  <TR><TD><A NAME=a:splines HREF=#d:splines>splines</A>
 </TD><TD>G</TD><TD><A HREF=#k:bool>bool</A>
 <BR>string</TD><TD ALIGN="CENTER"></TD><TD></TD><TD></TD> </TR>
@@ -1546,6 +1548,11 @@ This field indicates which graph component uses the attribute.
 <DD>  Specifies a post-processing step used to smooth out an uneven distribution 
   of nodes.
 
+<DT><A NAME=d:sortv HREF=#a:sortv><STRONG>sortv</STRONG></A>
+<DD>  If <A HREF="#d:packmode">packmode</A> indicates an array packing, 
+  this attribute specifies an
+  insertion order among the components, with smaller values inserted first.
+
 <DT><A NAME=d:splines HREF=#a:splines><STRONG>splines</STRONG></A>
 <DD>  Controls how, and if, edges are represented. If true, edges are drawn as
   splines routed around nodes; if false, edges are drawn as line segments.
@@ -1890,6 +1897,14 @@ the given types.
   Thus, the mode "array_c4" indicates array packing, with 4 rows,
   starting in the upper left and going down the first column, then
   down the second column, etc., until all components are used.
+  <P>
+  If the optional flags contains "u", this causes the insertion
+  order of elements in the array to be determined by user-supplied
+  values. Each component can specify its sort value by a 
+  non-negative integer using the <A HREF="#d:sortv">sortv</A> attribute. 
+  Components are
+  inserted in order, starting with the one with the smallest
+  sort value. If no sort value is specified, zero is used.
 
 <DT><A NAME=k:pagedir><STRONG>pagedir</STRONG></A>
 <DD>"BL", "BR", "TL", "TR", "RB", "RT", "LB", "LT".
diff --git a/doc/infosrc/attrs b/doc/infosrc/attrs
index ece45e981..a0b032912 100644
--- a/doc/infosrc/attrs
+++ b/doc/infosrc/attrs
@@ -996,6 +996,10 @@ skew top of polygon to right; negative to left.
 :smoothing:G:smoothType:"none";  sfdp
 Specifies a post-processing step used to smooth out an uneven distribution 
 of nodes.
+:sortv:GCN:int:0:0;
+If <A HREF="#d:packmode">packmode</A> indicates an array packing, 
+this attribute specifies an
+insertion order among the components, with smaller values inserted first.
 :splines:G:bool/string;
 Controls how, and if, edges are represented. If true, edges are drawn as
 splines routed around nodes; if false, edges are drawn as line segments.
diff --git a/doc/infosrc/types b/doc/infosrc/types
index e7cd2816c..88c8348c9 100644
--- a/doc/infosrc/types
+++ b/doc/infosrc/types
@@ -187,6 +187,14 @@ columns for row-major or the number of rows for column-major.
 Thus, the mode "array_c4" indicates array packing, with 4 rows,
 starting in the upper left and going down the first column, then
 down the second column, etc., until all components are used.
+<P>
+If the optional flags contains "u", this causes the insertion
+order of elements in the array to be determined by user-supplied
+values. Each component can specify its sort value by a 
+non-negative integer using the <A HREF="#d:sortv">sortv</A> attribute. 
+Components are
+inserted in order, starting with the one with the smallest
+sort value. If no sort value is specified, zero is used.
 :pagedir
 "BL", "BR", "TL", "TR", "RB", "RT", "LB", "LT".
 These specify the 8 row or column major orders for traversing a