|
wolffd@0
|
1 .TH GXL2GV,GV2GXL 1 "20 December 2002"
|
|
wolffd@0
|
2 .SH NAME
|
|
wolffd@0
|
3 gxl2gv,gv2gxl \- GXL-GV converters
|
|
wolffd@0
|
4 .SH SYNOPSIS
|
|
wolffd@0
|
5 .B gxl2gv
|
|
wolffd@0
|
6 [
|
|
wolffd@0
|
7 .B \-gd?
|
|
wolffd@0
|
8 ]
|
|
wolffd@0
|
9 [
|
|
wolffd@0
|
10 .BI -o outfile
|
|
wolffd@0
|
11 ]
|
|
wolffd@0
|
12 [
|
|
wolffd@0
|
13 .I files
|
|
wolffd@0
|
14 ]
|
|
wolffd@0
|
15 .br
|
|
wolffd@0
|
16 .B gv2gxl
|
|
wolffd@0
|
17 [
|
|
wolffd@0
|
18 .B \-gd?
|
|
wolffd@0
|
19 ]
|
|
wolffd@0
|
20 [
|
|
wolffd@0
|
21 .BI -o outfile
|
|
wolffd@0
|
22 ]
|
|
wolffd@0
|
23 [
|
|
wolffd@0
|
24 .I files
|
|
wolffd@0
|
25 ]
|
|
wolffd@0
|
26 .SH DESCRIPTION
|
|
wolffd@0
|
27 .B gxl2gv
|
|
wolffd@0
|
28 converts between graphs represented in GXL and in the
|
|
wolffd@0
|
29 GV language. Unless a conversion type is specified using
|
|
wolffd@0
|
30 a flag,
|
|
wolffd@0
|
31 .B gxl2gv
|
|
wolffd@0
|
32 will deduce the type of conversion from the suffix of
|
|
wolffd@0
|
33 the input file, a ".gv" (or a ".dot") suffix causing a conversion from GV
|
|
wolffd@0
|
34 to GXL, and a ".gxl" suffix causing a conversion from GXL to GV.
|
|
wolffd@0
|
35 If no suffix is available, e.g. when the input is from a pipe,
|
|
wolffd@0
|
36 and no flags are used then
|
|
wolffd@0
|
37 .B gxl2gv
|
|
wolffd@0
|
38 assumes the type of the input file from its executable name
|
|
wolffd@0
|
39 so that
|
|
wolffd@0
|
40 .B gxl2gv
|
|
wolffd@0
|
41 converts from GXL to GV, and
|
|
wolffd@0
|
42 .B gv2gxl
|
|
wolffd@0
|
43 converts from GV to GXL.
|
|
wolffd@0
|
44 .PP
|
|
wolffd@0
|
45 GXL supports a much richer graph model than GV. \fBgxl2gv\fP
|
|
wolffd@0
|
46 will attempt to map GXL constructs into the analogous GV construct
|
|
wolffd@0
|
47 when this is possible. If not, the GXL information is stored as
|
|
wolffd@0
|
48 an attribute. The intention is that applying \fBgxl2gv|gv2gxl\fP
|
|
wolffd@0
|
49 is semantically equivalent to the identity operator.
|
|
wolffd@0
|
50 .SH OPTIONS
|
|
wolffd@0
|
51 The following options are supported:
|
|
wolffd@0
|
52 .TP
|
|
wolffd@0
|
53 .B \-g
|
|
wolffd@0
|
54 The command name and input file extensions are ignored, the
|
|
wolffd@0
|
55 input is taken as a GV file and a GXL file is generated.
|
|
wolffd@0
|
56 .TP
|
|
wolffd@0
|
57 .B \-d
|
|
wolffd@0
|
58 The command name and input file extensions are ignored, the
|
|
wolffd@0
|
59 input is taken as a GXL file and a GV file is generated.
|
|
wolffd@0
|
60 .TP
|
|
wolffd@0
|
61 .B \-?
|
|
wolffd@0
|
62 Prints usage information and exits.
|
|
wolffd@0
|
63 .TP
|
|
wolffd@0
|
64 .BI \-o " outfile"
|
|
wolffd@0
|
65 If specified, the output will be written into the file
|
|
wolffd@0
|
66 \fIoutfile\fP. Otherwise, output is written to standard out.
|
|
wolffd@0
|
67 .SH OPERANDS
|
|
wolffd@0
|
68 The following operand is supported:
|
|
wolffd@0
|
69 .TP 8
|
|
wolffd@0
|
70 .I files
|
|
wolffd@0
|
71 Names of files containing 1 or more graphs in GXL or GV.
|
|
wolffd@0
|
72 If no
|
|
wolffd@0
|
73 .I files
|
|
wolffd@0
|
74 operand is specified,
|
|
wolffd@0
|
75 the standard input will be used.
|
|
wolffd@0
|
76 .SH RETURN CODES
|
|
wolffd@0
|
77 Both \fBgxl2gv\fP and \fBgv2gxl\fP return \fB0\fP
|
|
wolffd@0
|
78 if there were no problems during conversion;
|
|
wolffd@0
|
79 and non-zero if any error occurred.
|
|
wolffd@0
|
80 .SH "BUGS"
|
|
wolffd@0
|
81 \fBgxl2gv\fP will only convert in one direction even if given multiple files
|
|
wolffd@0
|
82 with varying suffixes.
|
|
wolffd@0
|
83 .PP
|
|
wolffd@0
|
84 The conversion can only handle one graph per GXL file.
|
|
wolffd@0
|
85 .PP
|
|
wolffd@0
|
86 There are some GXL constructs which \fBgxl2gv\fP cannot handle.
|
|
wolffd@0
|
87 .SH AUTHORS
|
|
wolffd@0
|
88 Krishnam Pericherla <kp@research.att.com>
|
|
wolffd@0
|
89 .br
|
|
wolffd@0
|
90 Emden R. Gansner <erg@research.att.com>
|
|
wolffd@0
|
91 .SH "SEE ALSO"
|
|
wolffd@0
|
92 dot(1), libgraph(3), libagraph(3), neato(1), twopi(1)
|
