← Back to branch summary

~ubuntu-branches/ubuntu/precise/graphviz/precise-security

« back to all changes in this revision

Viewing changes to doc/info/arrows.html

  • Committer: Bazaar Package Importer
  • Author(s): David Claughton
  • Date: 2010-03-24 22:45:18 UTC
  • mfrom: (1.2.7 upstream) (6.1.7 sid)
  • Revision ID: james.westby@ubuntu.com-20100324224518-do441tthbqjaqjzd
Tags: 2.26.3-4
http://bugs.debian.org/575255
Add patch to fix segfault in circo. Backported from upstream snapshot
release.  Thanks to Francis Russell for his work on this.
(Closes: #575255)

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/info/arrows.html
 
1
<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
 
2
<!--
 
3
    This is a generated document.  Do not edit.
 
4
-->
 
5
<HTML VERSION="2.0">
 
6
<HEAD>
 
7
<TITLE>Arrow Shapes</TITLE>
 
8
</HEAD>
 
9
<BODY BGCOLOR=white>
 
10
<A NAME="top"></A>
 
11
<H1 ALIGN=CENTER>Arrow Shapes</H1>
 
12
<HR>
 
13
Arrow shapes can be specified and named using the following simple
 
14
grammar. 
 
15
Terminals are shown in bold font and nonterminals in italics.
 
16
Literal characters are given in single quotes.
 
17
Square brackets [ and ] enclose optional items.
 
18
Vertical bars | separate alternatives.
 
19
<TABLE>
 
20
<TR>
 
21
  <TD ALIGN=RIGHT><I>arrowname</I></TD>
 
22
  <TD ALIGN=LEFT>:</TD>
 
23
  <TD ALIGN=LEFT><I>aname</I> [ <I>aname</I> [ <I>aname</I> [ <I>aname</I> ] ] ]</TD>
 
24
</TR>
 
25
<TR>
 
26
  <TD ALIGN=RIGHT><I>aname</I></TD>
 
27
  <TD ALIGN=LEFT>:</TD>
 
28
  <TD ALIGN=LEFT>[ <I>modifiers</I> ] <I>shape</I></TD>
 
29
</TR>
 
30
<TR>
 
31
  <TD ALIGN=RIGHT><I>modifiers</I></TD>
 
32
  <TD ALIGN=LEFT>:</TD>
 
33
  <TD ALIGN=LEFT>[ <B>'o'</B> ] [ <I>side</I> ]</TD>
 
34
</TR>
 
35
<TR>
 
36
  <TD ALIGN=RIGHT><I>side</I></TD>
 
37
  <TD ALIGN=LEFT>:</TD>
 
38
  <TD ALIGN=LEFT><B>'l'</B></TD>
 
39
</TR>
 
40
<TR>
 
41
  <TD ALIGN=RIGHT></TD>
 
42
  <TD ALIGN=LEFT>|</TD>
 
43
  <TD ALIGN=LEFT><B>'r'</B></TD>
 
44
</TR>
 
45
<TR>
 
46
  <TD ALIGN=RIGHT><I>shape</I></TD>
 
47
  <TD ALIGN=LEFT>:</TD>
 
48
  <TD ALIGN=LEFT><B>box</B></TD>
 
49
</TR>
 
50
<TR>
 
51
  <TD ALIGN=RIGHT></TD>
 
52
  <TD ALIGN=LEFT>|</TD>
 
53
  <TD ALIGN=LEFT><B>crow</B></TD>
 
54
</TR>
 
55
<TR>
 
56
  <TD ALIGN=RIGHT></TD>
 
57
  <TD ALIGN=LEFT>|</TD>
 
58
  <TD ALIGN=LEFT><B>diamond</B></TD>
 
59
</TR>
 
60
<TR>
 
61
  <TD ALIGN=RIGHT></TD>
 
62
  <TD ALIGN=LEFT>|</TD>
 
63
  <TD ALIGN=LEFT><B>dot</B></TD>
 
64
</TR>
 
65
<TR>
 
66
  <TD ALIGN=RIGHT></TD>
 
67
  <TD ALIGN=LEFT>|</TD>
 
68
  <TD ALIGN=LEFT><B>inv</B></TD>
 
69
</TR>
 
70
<TR>
 
71
  <TD ALIGN=RIGHT></TD>
 
72
  <TD ALIGN=LEFT>|</TD>
 
73
  <TD ALIGN=LEFT><B>none</B></TD>
 
74
</TR>
 
75
<TR>
 
76
  <TD ALIGN=RIGHT></TD>
 
77
  <TD ALIGN=LEFT>|</TD>
 
78
  <TD ALIGN=LEFT><B>normal</B></TD>
 
79
</TR>
 
80
<TR>
 
81
  <TD ALIGN=RIGHT></TD>
 
82
  <TD ALIGN=LEFT>|</TD>
 
83
  <TD ALIGN=LEFT><B>tee</B></TD>
 
84
</TR>
 
85
<TR>
 
86
  <TD ALIGN=RIGHT></TD>
 
87
  <TD ALIGN=LEFT>|</TD>
 
88
  <TD ALIGN=LEFT><B>vee</B></TD>
 
89
</TR>
 
90
</TABLE>
 
91
<P>
 
92
The primitive shapes are:
 
93
<CENTER>
 
94
<TABLE>
 
95
  <TR>
 
96
    <TD>"box"<TD><IMG SRC="a_box.gif">
 
97
    <TD>"crow"<TD><IMG SRC="a_crow.gif">
 
98
    <TD>"diamond"<TD><IMG SRC="a_diamond.gif">
 
99
  </TR>
 
100
  <TR>
 
101
    <TD>"dot"<TD><IMG SRC="a_dot.gif">
 
102
    <TD>"inv"<TD><IMG SRC="a_inv.gif">
 
103
    <TD>"none"<TD><IMG SRC="a_none.gif">
 
104
  </TR>
 
105
  <TR>
 
106
    <TD>"normal"<TD><IMG SRC="a_normal.gif">
 
107
    <TD>"tee"<TD><IMG SRC="a_tee.gif">
 
108
    <TD>"vee"<TD><IMG SRC="a_open.gif">
 
109
  </TR>
 
110
</TABLE>
 
111
</CENTER>
 
112
<P>
 
113
As for the modifiers:
 
114
<DL>
 
115
<DT>'l'
 
116
  <DD> Clip the shape, leaving only the part to the left of the edge.
 
117
<DT>'r'
 
118
  <DD> Clip the shape, leaving only the part to the right of the edge.
 
119
<DT>'o'
 
120
  <DD> Use an open (non-filled) version of the shape.
 
121
</DL>
 
122
Left and right are defined as those directions determined by looking
 
123
from the edge towards the point where the arrow "touches" the node.
 
124
<P>
 
125
As an example, the arrow shape <TT>lteeoldiamond</TT> is parsed as
 
126
<TT>'l' 'tee' 'o' 'l' 'diamond'</TT> and corresponds to the shape
 
127
<CENTER>
 
128
<IMG SRC="a_lteeoldiamond.gif">
 
129
</CENTER>
 
130
Note that the first arrow shape specified occurs closest to the node.
 
131
Subsequent arrow shapes, if specified, occur further from the node.
 
132
<P>
 
133
Not all syntactically legal combinations of modifiers are meaningful
 
134
or semantically valid.
 
135
For example, none of the modifiers make any sense with <TT>none</TT>.
 
136
The following table indicates which modifiers are allowed with which shapes.
 
137
<P>
 
138
<CENTER>
 
139
<TABLE BORDER=2>
 
140
<TR ALIGN=CENTER>
 
141
 <TH>Modifier</TH>
 
142
 <TH>box
 
143
 <TH>crow
 
144
 <TH>diamond
 
145
 <TH>dot
 
146
 <TH>inv
 
147
 <TH>none
 
148
 <TH>normal
 
149
 <TH>tee
 
150
 <TH>vee
 
151
</TR>
 
152
<TR ALIGN=CENTER><TD>'l'/'r'<TD>X<TD>X<TD>X<TD>&nbsp;<TD>X<TD>&nbsp;<TD>X<TD>X<TD>X</TR>
 
153
<TR ALIGN=CENTER><TD>'o'    <TD>X<TD>&nbsp;<TD>X<TD>X<TD>X<TD>&nbsp;<TD>X<TD>&nbsp;<TD>&nbsp;</TR>
 
154
</TABLE>
 
155
</CENTER>
 
156
<P>
 
157
This yields 36 different arrow shapes. The optional second, third, fourth shapes
 
158
can independently be any of the 36, but since <TT>nonenone</TT> 
 
159
is redundant, there are 35**4 + 35**3 + 35**2 + 35 + 1 = 1,544,761 different combinations.
 
160
<P>
 
161
The following display contains the 36 combinations possible with a single
 
162
arrow shape. The node attached to the arrow is not drawn but would appear
 
163
on the right side of the edge.
 
164
<P>
 
165
<CENTER>
 
166
<TABLE>
 
167
  <TR ALIGN=CENTER>
 
168
    <TD><IMG SRC="aa_box.gif">
 
169
    <TD><IMG SRC="aa_lbox.gif">
 
170
    <TD><IMG SRC="aa_rbox.gif">
 
171
    <TD><IMG SRC="aa_obox.gif">
 
172
    <TD><IMG SRC="aa_olbox.gif">
 
173
    <TD><IMG SRC="aa_orbox.gif">
 
174
  </TR>
 
175
  <TR ALIGN=CENTER>
 
176
    <TD>box
 
177
    <TD>lbox
 
178
    <TD>rbox
 
179
    <TD>obox
 
180
    <TD>olbox
 
181
    <TD>orbox
 
182
  </TR>
 
183
  <TR ALIGN=CENTER>
 
184
    <TD><IMG SRC="aa_crow.gif">
 
185
    <TD><IMG SRC="aa_lcrow.gif">
 
186
    <TD><IMG SRC="aa_rcrow.gif">
 
187
  </TR>
 
188
  <TR ALIGN=CENTER>
 
189
    <TD>crow
 
190
    <TD>lcrow
 
191
    <TD>rcrow
 
192
  </TR>
 
193
  <TR ALIGN=CENTER>
 
194
    <TD><IMG SRC="aa_diamond.gif">
 
195
    <TD><IMG SRC="aa_ldiamond.gif">
 
196
    <TD><IMG SRC="aa_rdiamond.gif">
 
197
    <TD><IMG SRC="aa_odiamond.gif">
 
198
    <TD><IMG SRC="aa_oldiamond.gif">
 
199
    <TD><IMG SRC="aa_ordiamond.gif">
 
200
  </TR>
 
201
  <TR ALIGN=CENTER>
 
202
    <TD>diamond
 
203
    <TD>ldiamond
 
204
    <TD>rdiamond
 
205
    <TD>odiamond
 
206
    <TD>oldiamond
 
207
    <TD>ordiamond
 
208
  </TR>
 
209
  <TR ALIGN=CENTER>
 
210
    <TD><IMG SRC="aa_dot.gif">
 
211
    <TD><IMG SRC="aa_odot.gif">
 
212
  </TR>
 
213
  <TR ALIGN=CENTER>
 
214
    <TD>dot
 
215
    <TD>odot
 
216
  </TR>
 
217
  <TR ALIGN=CENTER>
 
218
    <TD><IMG SRC="aa_inv.gif">
 
219
    <TD><IMG SRC="aa_linv.gif">
 
220
    <TD><IMG SRC="aa_rinv.gif">
 
221
    <TD><IMG SRC="aa_oinv.gif">
 
222
    <TD><IMG SRC="aa_olinv.gif">
 
223
    <TD><IMG SRC="aa_orinv.gif">
 
224
  </TR>
 
225
  <TR ALIGN=CENTER>
 
226
    <TD>inv
 
227
    <TD>linv
 
228
    <TD>rinv
 
229
    <TD>oinv
 
230
    <TD>olinv
 
231
    <TD>orinv
 
232
  </TR>
 
233
  <TR ALIGN=CENTER>
 
234
    <TD><IMG SRC="aa_none.gif">
 
235
  </TR>
 
236
  <TR ALIGN=CENTER>
 
237
    <TD>none
 
238
  </TR>
 
239
  <TR ALIGN=CENTER>
 
240
    <TD><IMG SRC="aa_normal.gif">
 
241
    <TD><IMG SRC="aa_lnormal.gif">
 
242
    <TD><IMG SRC="aa_rnormal.gif">
 
243
    <TD><IMG SRC="aa_onormal.gif">
 
244
    <TD><IMG SRC="aa_olnormal.gif">
 
245
    <TD><IMG SRC="aa_ornormal.gif">
 
246
  </TR>
 
247
  <TR ALIGN=CENTER>
 
248
    <TD>normal
 
249
    <TD>lnormal
 
250
    <TD>rnormal
 
251
    <TD>onormal
 
252
    <TD>olnormal
 
253
    <TD>ornormal
 
254
  </TR>
 
255
  <TR ALIGN=CENTER>
 
256
    <TD><IMG SRC="aa_tee.gif">
 
257
    <TD><IMG SRC="aa_ltee.gif">
 
258
    <TD><IMG SRC="aa_rtee.gif">
 
259
  </TR>
 
260
  <TR ALIGN=CENTER>
 
261
    <TD>tee
 
262
    <TD>ltee
 
263
    <TD>rtee
 
264
  </TR>
 
265
  <TR ALIGN=CENTER>
 
266
    <TD><IMG SRC="aa_vee.gif">
 
267
    <TD><IMG SRC="aa_lvee.gif">
 
268
    <TD><IMG SRC="aa_rvee.gif">
 
269
  </TR>
 
270
  <TR ALIGN=CENTER>
 
271
    <TD>vee
 
272
    <TD>lvee
 
273
    <TD>rvee
 
274
  </TR>
 
275
</TABLE>
 
276
</CENTER>
 
277
</BODY>
 
278
</HTML>