Name

regconvert — Convert between different Regina file formats

Synopsis

regconvert [[-x] | [-u] | [-b]] {old-file} [new-file]

Description

Between Regina versions 2.4 and 3.0, the data files changed from using an impenetrable and undocumented binary format to using (optionally compressed) XML.

This utility converts back and forth between these different file formats.

The argument old-file should be the file to read and convert; the argument new-file 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.

If the argument new-file is missing then the new file will be written to standard output, which forces the output to be uncompressed XML (see option -u).

Warning

When writing an old-style binary file, some information might be lost. Old-style binary files can only store information that was understood by the old version Regina 2.4.

Options

-x (default)

Convert to compressed XML.

-u

Convert to plain (uncompressed) XML.

-b

Convert to the old-style binary format.

MacOS X Users

If you downloaded a drag-and-drop app bundle, this utility is shipped inside it. If you dragged Regina to the main Applications folder, you can run it as /Applications/Regina.app/Contents/MacOS/regconvert.

Windows Users

The command-line utilities are installed beneath the Program Files directory; on some machines this directory is called Program Files (x86). You can start this utility by running c:\Program Files\Regina\Regina 4.93\bin\regconvert.exe.

Author

This utility was written by Benjamin Burton . Many people have been involved in the development of Regina; see the acknowledgements page for a full list of credits.