.\" 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 "REGFILETYPE" "1" "14 March 2023" "" "The Regina Handbook"

.SH NAME
regfiletype \- Identify the formats of Regina data files
.SH SYNOPSIS

\fBregfiletype\fR \fB\fIfile\fB\fR\fI ...\fR


\fBregfiletype\fR { \fB-v, --version\fR | \fB-?, --help\fR }

.SH "DESCRIPTION"
.PP
This utility determines which file format a given
Regina data file is in.
You may pass multiple files on the command line; the format of each
file will be written to standard output.
.PP
Only Regina's modern XML-based file formats are recognised
(both compressed and uncompressed).
In its very early years, Regina used an impenetrable and undocumented
binary format; this was replaced with XML in 2002 (Regina\~3.0),
and support for this format was removed completely in 2013
(Regina\~4.94).
If you still need to recognise and/or read files in this ancient binary
format, you will need to download Regina\~4.93.
.SH "OPTIONS"
.TP
\fB-v, --version\fR
Show which version of Regina is being used, and exit
immediately.
.TP
\fB-?, --help\fR
Display brief usage information, and exit immediately.
.SH "MACOS USERS"
.PP
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/regfiletype\&.
.SH "WINDOWS USERS"
.PP
The command-line utilities are installed beneath the
\fIProgram\~Files\fR directory; on some
machines this directory is called
\fIProgram\~Files\~(x86)\fR\&.
You can start this utility by running
c:\\Program\~Files\\Regina\\Regina\~7.3\\bin\\regfiletype.exe\&.
.SH "SEE ALSO"
.PP
regconvert,
regina-gui\&.
.SH "AUTHOR"
.PP
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.