comparison toolboxes/graph_visualisation/share/man/man1/gv2gxl.1 @ 0:e9a9cd732c1e tip

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