Daniel@0: .TH GXL2GV,GV2GXL 1 "20 December 2002"
Daniel@0: .SH NAME
Daniel@0: gxl2gv,gv2gxl \- GXL-GV converters
Daniel@0: .SH SYNOPSIS
Daniel@0: .B gxl2gv
Daniel@0: [
Daniel@0: .B \-gd?
Daniel@0: ]
Daniel@0: [
Daniel@0: .BI -o outfile
Daniel@0: ]
Daniel@0: [ 
Daniel@0: .I files
Daniel@0: ]
Daniel@0: .br
Daniel@0: .B gv2gxl
Daniel@0: [
Daniel@0: .B \-gd?
Daniel@0: ]
Daniel@0: [
Daniel@0: .BI -o outfile
Daniel@0: ]
Daniel@0: [ 
Daniel@0: .I files
Daniel@0: ]
Daniel@0: .SH DESCRIPTION
Daniel@0: .B gxl2gv
Daniel@0: converts between graphs represented in GXL and in the
Daniel@0: GV language. Unless a conversion type is specified using
Daniel@0: a flag,
Daniel@0: .B gxl2gv
Daniel@0: will deduce the type of conversion from the suffix of
Daniel@0: the input file, a ".gv" (or a ".dot") suffix causing a conversion from GV
Daniel@0: to GXL, and a ".gxl" suffix causing a conversion from GXL to GV.
Daniel@0: If no suffix is available, e.g. when the input is from a pipe,
Daniel@0: and no flags are used then
Daniel@0: .B gxl2gv
Daniel@0: assumes the type of the input file from its executable name
Daniel@0: so that
Daniel@0: .B gxl2gv
Daniel@0: converts from GXL to GV, and
Daniel@0: .B gv2gxl
Daniel@0: converts from GV to GXL.
Daniel@0: .PP
Daniel@0: GXL supports a much richer graph model than GV. \fBgxl2gv\fP
Daniel@0: will attempt to map GXL constructs into the analogous GV construct
Daniel@0: when this is possible. If not, the GXL information is stored as
Daniel@0: an attribute. The intention is that applying \fBgxl2gv|gv2gxl\fP
Daniel@0: is semantically equivalent to the identity operator.
Daniel@0: .SH OPTIONS
Daniel@0: The following options are supported:
Daniel@0: .TP
Daniel@0: .B \-g
Daniel@0: The command name and input file extensions are ignored, the
Daniel@0: input is taken as a GV file and a GXL file is generated.
Daniel@0: .TP
Daniel@0: .B \-d
Daniel@0: The command name and input file extensions are ignored, the
Daniel@0: input is taken as a GXL file and a GV file is generated.
Daniel@0: .TP
Daniel@0: .B \-?
Daniel@0: Prints usage information and exits.
Daniel@0: .TP
Daniel@0: .BI \-o " outfile"
Daniel@0: If specified, the output will be written into the file
Daniel@0: \fIoutfile\fP. Otherwise, output is written to standard out.
Daniel@0: .SH OPERANDS
Daniel@0: The following operand is supported:
Daniel@0: .TP 8
Daniel@0: .I files
Daniel@0: Names of files containing 1 or more graphs in GXL or GV.
Daniel@0: If no
Daniel@0: .I files
Daniel@0: operand is specified,
Daniel@0: the standard input will be used.
Daniel@0: .SH RETURN CODES
Daniel@0: Both \fBgxl2gv\fP and \fBgv2gxl\fP return \fB0\fP
Daniel@0: if there were no problems during conversion;
Daniel@0: and non-zero if any error occurred.
Daniel@0: .SH "BUGS"
Daniel@0: \fBgxl2gv\fP will only convert in one direction even if given multiple files
Daniel@0: with varying suffixes.
Daniel@0: .PP
Daniel@0: The conversion can only handle one graph per GXL file.
Daniel@0: .PP
Daniel@0: There are some GXL constructs which \fBgxl2gv\fP cannot handle.
Daniel@0: .SH AUTHORS
Daniel@0: Krishnam Pericherla <kp@research.att.com>
Daniel@0: .br
Daniel@0: Emden R. Gansner <erg@research.att.com>
Daniel@0: .SH "SEE ALSO"
Daniel@0: dot(1), libgraph(3), libagraph(3), neato(1), twopi(1)