regfiledump(1) [debian man page]

REGFILEDUMP(1)							The Regina Handbook						    REGFILEDUMP(1)

NAME

       regfiledump - Dump the contents of a Regina data file

SYNOPSIS

       regfiledump [ -f | -l | -n ] [ -c ] file [ packet-label ... ]

DESCRIPTION

       This utility dumps the contents of the given Regina data file to standard output in a human-readable format.

       If  a  list of packet labels is given on the command-line, only those packets will be output.  Otherwise all packets in the given file will
       be output.

OPTIONS

       -f (default)
	      Output full packet details.  The output for each packet will cover several lines, beginning with basic details (such as  the  packet
	      label and type) followed by the packet's long description.

       -l     Output a list of packet labels and types only, one packet per line.

       -n     Don't output any packets at all; this option forces a packet count (see option -c).

       -c     Finish the output with a total count of all packets in the file.

INTERNATIONALISATION

       If any packets contain international characters, Regina will attempt to convert these to your local character encoding as it writes them to
       the output.

       You can tell Regina what character encoding to use by setting standard locale-related environment variables,  such  as  LANG,  LC_CTYPE	or
       LC_ALL.

       For  example,  if  LANG is set to en_AU then output will be written in the Western European character set ISO-8859-1, and if LANG is set to
       en_AU.UTF-8 then output will be written in the universal character set UTF-8.

       Typically these environment variables will already be set for you when you install your GNU/Linux system, and  Regina  will  just  use  the
       right character set out of the box.  See your GNU/Linux system reference for further information on supporting different locales.

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/regfiledump.

WINDOWS USERS

       The command-line utilities  are	installed  beneath  the  Program  Files  directory;  on  some  machines  this  directory  is  called  Pro-
       gram Files (x86).  You can start this utility by running c:Program FilesReginaRegina 4.93in
egfiledump.exe.

SEE ALSO

       regina-gui.

AUTHOR

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

								    28 May 2012 						    REGFILEDUMP(1)

REGINA-ENGINE-CONFIG(1) 				      General Commands Manual					   REGINA-ENGINE-CONFIG(1)

NAME

       regina-engine-config - get information about the installed version of Regina

SYNOPSIS

       regina-engine-config [--prefix[=DIR]] [--exec-prefix[=DIR]] [--version] [--libs] [--cflags]

DESCRIPTION

       regina-engine-config tells you which compiler and linker flags should be used to build the mathematical engine of Regina into your own pro-
       grams.  Regina's mathematical engine is in the library libregina-engine.so.

       Regina is a software package for studying 3-manifold triangulations and normal surfaces. Other key features include angle structures,  cen-
       sus  enumeration, combinatorial recognition of triangulations, and high-level tasks such as 3-sphere recognition and connected sum decompo-
       sition.

OPTIONS

       regina-engine-config accepts the following options.

       --prefix=DIR
	      Use DIR instead of the installation prefix that Regina was built with when computing the output for the --cflags and --libs options.
	      This  option is also used for the exec prefix if --exec-prefix is not specified.	This option must be specified before any --libs or
	      --cflags options.  If no DIR is specified then the current installation prefix will be written to standard output.

	      Most people will not need this option.

       --exec-prefix=DIR
	      Use DIR instead of the installation exec prefix that Regina was built with when computing the output for	the  --cflags  and  --libs
	      options.	This option must be specified before any --libs or --cflags options.  If no DIR is specified then the current installation
	      exec prefix will be written to standard output.

	      Most people will not need this option.

       --version
	      Print the currently installed version of Regina.

       --libs Print the linker flags that are required to link a program against the Regina calculation engine.

       --cflags
	      Print the compiler flags that are required to compile a program that uses the Regina calculation engine.

SEE ALSO

       Regina includes a detailed users' handbook, which may be accessed through Regina's  help  menu  or  read  online  at  http://regina.source-
       forge.net/ .

AUTHOR

       This  utility  was  written  by	Ben  Burton <bab@debian.org>, and is licensed under the GNU General Public License.  Many people have been
       involved in the development of Regina; see the users' handbook for a full list of acknowledgements.

       This script regina-engine-config and its manual page were modified from gtk-config, which contains the following notice:

	      Copyright (C)  1998 Owen Taylor

	      Permission to use, copy, modify, and distribute this software and its documentation for  any  purpose  and  without  fee	is  hereby
	      granted,	provided  that	the  above  copyright  notice appear in all copies and that both that copyright notice and this permission
	      notice appear in supporting documentation.

       Note that the permission statement above applies only to regina-engine-config, and not to Regina as a whole.

								 September 8, 2011					   REGINA-ENGINE-CONFIG(1)