NAME

       regconvert - Convert between different Regina file formats

SYNOPSIS

       regconvert [ -2 | -3 ] [ -x | -u ] old-file [ new-file ]

DESCRIPTION

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

       Regina's file formats include:

       Third-generation XML
              This  is  the  modern  XML  format  introduced in Regina 7.0.  Older versions of Regina (6.0.1 and
              below) cannot read it at all.

       Second-generation XML
              This is the original XML format that was used  in  Regina  3.0-6.0.1  (from  2002-2021).   Current
              versions of Regina can still read and write this format if required.

       First-generation binary format
              This  is the ancient binary format that was used in Regina 2.x (from 2000-2002).  Support for this
              format was dropped completely in September 2013, and modern versions  of  Regina  cannot  read  or
              write it.

              If  you  still  have  ancient  files  that  use  this  format,  you  will  need  to find a copy of
              Regina 3.0-4.93 (from 2002-2012), which  can  convert  these  old  binary  files  to  the  second-
              generation XML format.

       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).

OPTIONS

       -2     Convert to the older second-generation XML format, as used in Regina 3.0-6.0.1.

       -3 (default)
              Convert to the modern third-generation XML format, introduced in Regina 7.0.

       -x (default)
              Write the output as compressed XML.

       -u     Write the output as uncompressed (plain text) XML.

MACOS 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 7.0\bin\regconvert.exe.

SEE ALSO

       regfiletype, regina-gui.

AUTHOR

       This utility was written by Benjamin Burton <bab@maths.uq.edu.au>.  Many people have been involved in the
       development of Regina; see the users' handbook for a full list of credits.

                                                17 December 2021                                   REGCONVERT(1)