1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
|
.\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/>
.\" Please send any bug reports, improvements, comments, patches,
.\" etc. to Steve Cheng <steve@ggi-project.org>.
.TH "REGCONVERT" "1" "10 May 2008" "" "Specialised Utilities"
.SH NAME
regconvert \- Convert between different Regina file formats
.SH SYNOPSIS
\fBregconvert\fR [ \fB-x\fR | \fB-u\fR | \fB-b\fR ] \fB\fIold-file\fB\fR [ \fB\fInew-file\fB\fR ]
.SH "DESCRIPTION"
.PP
Between \fBRegina\fR versions 2.4 and 3.0, the data files changed from
using an impenetrable and undocumented binary format to using
(optionally compressed) XML\&.
.PP
This utility simply converts back and forth between these different
file formats.
.PP
Argument \fIold-file\fR should be the file to
read and convert; argument \fInew-file\fR should
be the name of the new converted file to write. These two filenames
may be the same, in which case the old file will be replaced with the new.
.PP
If argument \fInew-file\fR is missing, the new
file will be written to standard output; this forces output to be
uncompressed XML (see option \fB-u\fR).
.sp
.RS
.B "Warning:"
When writing an old-style binary file, some information might be
lost. Specifically, only information that is understood by the
\fBRegina\fR\~2.4 calculation engine will be written.
.RE
.SH "OPTIONS"
.TP
\fB-x (default)\fR
Convert to compressed XML\&.
.TP
\fB-u\fR
Convert to plain (uncompressed) XML\&.
.TP
\fB-b\fR
Convert to the old-style binary format.
.SH "SEE ALSO"
.PP
regfiletype,
regina-kde\&.
.SH "AUTHOR"
.PP
\fBRegina\fR was written by Ben Burton <bab@debian.org> with help from others;
see the documentation for full details.
|
