wolffd@0: .TH UNFLATTEN 1 "21 January 2001"
wolffd@0: .SH NAME
wolffd@0: unflatten \- adjust directed graphs to improve layout aspect ratio
wolffd@0: .SH SYNOPSIS
wolffd@0: .B unflatten
wolffd@0: [\fB\-f\fR]
wolffd@0: [\fB\-l\fIlen\fR]
wolffd@0: [\fB\-c\fIlen\fR
wolffd@0: ] [
wolffd@0: .B \-o
wolffd@0: .I outfile
wolffd@0: ]
wolffd@0: [ files ]
wolffd@0: .SH DESCRIPTION
wolffd@0: .B unflatten
wolffd@0: is a preprocessor to 
wolffd@0: .B dot
wolffd@0: that is
wolffd@0: used to improve the aspect ratio of graphs having many leaves 
wolffd@0: or disconnected nodes.
wolffd@0: The usual layout for such a graph is generally very wide or tall.  
wolffd@0: .B unflatten
wolffd@0: inserts invisible edges or adjusts the \fBminlen\fP on edges
wolffd@0: to improve layout compaction.
wolffd@0: .SH OPTIONS
wolffd@0: The following options are supported:
wolffd@0: .TP
wolffd@0: .BI \-l " len"
wolffd@0: The minimum length of leaf edges is staggered
wolffd@0: between 1 and \fIlen\fP (a small integer).  
wolffd@0: .TP
wolffd@0: .B \-f
wolffd@0: Enables the staggering of the \fB-l\fP option to fanout nodes whose
wolffd@0: indegree and outdegree are both 1. This helps with structures such
wolffd@0: as \fIa -> {w x y z} -> b\fP.
wolffd@0: This option only works if the \fB-l\fP flag is set. 
wolffd@0: .TP
wolffd@0: .BI \-c " len"
wolffd@0: Form disconnected nodes into chains of up to \fIlen\fP nodes.
wolffd@0: .TP
wolffd@0: .BI \-o " outfile"
wolffd@0: causes the output to be written to the specified file; by default,
wolffd@0: output is written to \fBstdout\fP.
wolffd@0: .SH OPERANDS
wolffd@0: The following operand is supported:
wolffd@0: .TP 8
wolffd@0: .I files
wolffd@0: Names of files containing 1 or more graphs in dot format.
wolffd@0: If no
wolffd@0: .I files
wolffd@0: operand is specified,
wolffd@0: the standard input will be used.
wolffd@0: .SH AUTHORS
wolffd@0: Stephen C. North <north@research.att.com>
wolffd@0: .br
wolffd@0: Emden R. Gansner <erg@research.att.com>
wolffd@0: .SH "SEE ALSO"
wolffd@0: gc(1), dot(1), acyclic(1), gvpr(1), gvcolor(1), ccomps(1), tred(1), libgraph(3)