![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to dag.1 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [Research Unix] / researchv10dc / man / adm / man1|
Return to dag.1 CVS log | Up to [Research Unix] / researchv10dc / man / adm / man1 |
1.1 root 1: .TH DAG 1
2: .CT 1 writing_troff graphics
3: .tr @"
4: .SH NAME
5: dag \- preprocessor for drawing directed graphs
6: .SH SYNOPSIS
7: .B dag
8: [
9: .I option ...
10: ] [ file ... ]
11: .SH DESCRIPTION
12: .I Dag
13: is a
14: .IR pic (1)
15: or PostScript preprocessor for laying out directed graphs.
16: It does well on
17: acyclic graphs (dags) and other graphs that can be drawn
18: hierarchically.
19: Graph statements are contained between
20: .B .GD
21: (node ranks increase downward) or
22: .BR .GR
23: (rightward) and
24: .BR .GE .
25: Edges point in the direction of increasing rank if possible;
26: the other direction is favored for edges within rank.
27: A summary of statements follows.
28: .PP
29: .B edge from
30: .I tail
31: .B to
32: .IB "head0 edge-items" ,
33: .B to
34: .IB "head1 edge-items" ,
35: .B to
36: .IB "head2 edge-items..." ;
37: Create edges from the tail node
38: to the head node(s).
39: Nodes are created if they do
40: not already exist.
41: Edge-items
42: (described below) and the noise words
43: .BR edge ,
44: .BR from ,
45: .BR to ,
46: and comma are optional.
47: Node names may be quoted to protect blanks or keywords.
48: .PP
49: .B ordered
50: .IB "tail head0 head1 head2..." ;
51: Make edges with heads in given left-to-right order
52: on the same rank.
53: May contain noise words and edge-items.
54: .PP
55: .B path
56: .IB "node0 node1 node2..." ;
57: Make a path of edges.
58: May contain noise words and edge-items.
59: .PP
60: .B backedge
61: .IB "tail head0 head1 head2..." ;
62: Same as edges with opposite node ranking preferred.
63: .PP
64: .B backpath
65: .IB "node0 node1 node2..." ;
66: Make a path of backedges.
67: .PP
68: .B draw nodes
69: .IB node-items ;
70: Set properties of subsequently created
71: nodes.
72: Legal
73: .IR node-items :
74: .RS
75: .TF color\ string
76: .TP
77: .BI as " shape
78: Known shapes are
79: .BR Box ,
80: .BR Circle ,
81: .BR Doublecircle ,
82: .BR Ellipse
83: (default),
84: .BR Diamond ,
85: .BR Square ,
86: .BR Plaintext .
87: Other shapes may be specified within braces
88: .B {}
89: in the output language (e.g.
90: .IR pic )
91: or defined; see below.
92: .TP
93: .BI label " @string@
94: Label with
95: .I string
96: instead of node name.
97: .TP
98: .BI pointsize " points
99: .TP
100: .BIwidth " inches
101: .TP
102: .BI height "inches
103: .TP
104: .BI color " @string@
105: Hue-saturation-brightness
106: triple; works only with PostScript.
107: .PD
108: .RE
109: .PP
110: .B draw
111: .IB "nodelist node-items" ;
112: Set properties of listed nodes.
113: .PP
114: .B draw edges
115: .IB edge-items ;
116: Set properties of subsequently created edges.
117: Legal
118: .IR edge-items :
119: .RS
120: .TF color\ string
121: .HP
122: .BR dotted ,
123: .BR dashed ,
124: .BR solid ,
125: .BR invis
126: .TP
127: .BI label " @string@
128: .TP
129: .BI weight " n
130: High-weight edges are kept short. Default weight 1.
131: .TP
132: .BI color " @string@
133: .TP
134: .BI pointsize " points
135: .PD
136: .RE
137: .PP
138: .B minimum rank
139: .IB nodelist ;
140: Listed nodes must be on the topmost rank (leftmost with
141: .BR .GR ).
142: .PD0
143: .PP
144: .B maximum rank
145: .IB nodelist ;
146: Bottommost or rightmost rank.
147: .PP
148: .B same rank
149: .IB nodelist ;
150: .PD
151: .HP
152: .B separate ranks
153: .IB "inches how " ;
154: Set minimum separation between ranks.
155: The optional
156: .I how
157: is
158: .B exactly
159: or
160: .BR equally .
161: .PD 0
162: .TP
163: .BI "separate nodes " inches " ;
164: .PD
165: .PP
166: .ne 3
167: The options are
168: .TF -Tsimple
169: .PD
170: .TP
171: .B -O
172: Place nodes `optimally';
173: practical for graphs of a few
174: dozen nodes.
175: .TP
176: .B -Tps
177: Prepare output for PostScript rather than
178: .I pic.
179: .PD0
180: .TP
181: .B -Tsimple
182: Output similar to that of
183: .IR graphdraw (9.1).
184: .TP
185: .B -Tcip
186: Output readable by
187: .IR cip (9.1).
188: .PD
189: .TP
190: .BI -p width x height , marginwidth\fPx\fPmarginheight
191: Set PostScript page dimensions;
192: .I marginwidth
193: and/or
194: .I marginheight
195: may be omitted.
196: .TP
197: .B -l
198: Disable automatic loading of the
199: .IR dag
200: graphics library.
201: .PP
202: The introductory
203: .B .GD
204: or
205: .B .GR
206: line may carry optional parameters in the form
207: .B .GD
208: .I width
209: .I height
210: .BR fill .
211: .I Width
212: and
213: .I height
214: are maximum values in inches;
215: .B fill
216: causes the graph to be stretched to the full dimensions.
217: .PP
218: Graphics code written in the output language
219: .RI ( pic
220: or PostScript)
221: may be embedded between
222: .B .PS
223: and
224: .BR .PE .
225: Macros defined
226: with three arguments\(emlabel, width, and height\(emmay
227: be used as shape names in node-items.
228: .SH EXAMPLES
229: .EX
230: \&.GD 2 2
231: a b c;
232: path a x y;
233: draw nodes as Box;
234: a z label "hi" weight 1000;
235: draw edges dashed;
236: b x;
237: same rank b x;
238: \&.GE
239: .EE
240: .if n .ig
241: .GD 2 2
242: a b c;
243: path a x y;
244: draw nodes as Box;
245: a z label "hi" weight 1000;
246: draw edges dashed;
247: b x;
248: same rank b x;
249: .GE
250: ..
251: .SH FILES
252: .TF $TOOLS/daglib.pic
253: .TP
254: .F $TOOLS/daglib.pic
255: default
256: .BR TOOLS = /usr/lib
257: .TP
258: .F $TOOLS/daglib.ps
259: .SH SEE ALSO
260: .IR pic (1),
261: .IR lp (1),
262: .IR graphdraw (9.1),
263: .IR psi (9.1),
264: .IR troff (1)
265: .br
266: E. R. Gansner, S. C. North, K. P. Vo,
267: `DAG\(emA Program that Draws Directed Graphs',
268: this manual, Volume 2
269: .SH BUGS
270: The delimiter
271: .B .GD
272: is nonstandard; it may be called
273: .B .GS
274: in installations where
275: .IR ped (9.1)
276: is not used.
277: .br
278: .I Troff
279: lacks dotted or dashed splines; use PostScript.
280: .br
281: Edge labels may overlap.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.