NAME
Therion -- program to draw cave surveys
SYNOPSIS
therion [-q] [-L] [-l log-file]
[-s source file] [-p search path]
[-g|-u] [-i] [-d] [-x] [config-file]
therion [-h|--help]
[-v|--version]
[--print-encodings]
[--print-tex-encodings]
[--print-init-file]
DESCRIPTION
This manual page briefly documents Therion and provides an overview of
the package.
Therion is a program that processes Therion data files to produce cave
surveys. The data files are usually .th files which contain survey data
(very similar to survex .svx files), .th2 files which contain drawing
data, and thconfig files which control the data files to be used and
the maps to be output.
Therion outputs .pdf and .svg files for drawings, Survex .3d files,
Compass
Therion uses a number of helper programs to do its job. MetaPost is
used to draw cave symbols, and pdfTeX generates the final maps.
In order to make the entering of drawing data practical, and to make
the editing of survey files easier, a graphical editor XTherion is
included. This also includes a 'compiler' function which runs Therion
on the data to produce output. This is implemented using Tcl/Tk.
The Therion data files describe the cave as text in terms of objects so
the corresponding graphical representations are only inserted at output
generation time. This means that a survey can be produced using
whichever symbol set you require by specifying the relevant set of
MetaPost macros. Currently the UIS symbol set is supported.
Multiple languages and character sets are supported -- currently
ISO-8859-1, ISO-8859-2, ISO-8859-5, ISO-8859-7, UTF-8, ASCII and
CP1250.
ARGUMENTS
therion takes only one argument -- a config-file. If no file is
specified then the default thconfig file in the current directory will
be used. A new default file can be created using the -g option.
OPTIONS
This program follows the usual GNU command line syntax, with long
options starting with two dashes ("--"). A summary of options is
included below. For a complete description, see The Therion Book.
-h, --help
Show summary of options.
-v, --version
Show version information.
-q Quiet mode -- minimise output.
-g Generate a new configuration file. This will be the given
config-file if specified, or thconfig in the current
directory if not. If the file already exists, it will be
overwritten.
-i Ignore comments when writing (-g|-u) configuration file.
-L Do not create a log-file. Normally all messages are written
into a therion.log file.
-l log-file
Change the name of the log file.
-p search-path
This option is used to set the search path (or list of paths,
separated by colon), which therion will use to find its
source files (if it doesn't find them in the working
directory).
-q Run therion in quiet mode. It will print only warning and
error messages (to STDERR).
--print-encodings
Print a list of all supported encodings.
--print-init-file
Print a default initialisation file. For more details see the
Initialisation section in the Appendix of the Therion Book.
-s Set the name of the source file.
-u Upgrade the configuration file.
-d Turn on debugging mode. The current implementation creates a
temporary directory named thTMPDIR (in your system temporary
directory) and does not delete any temporary files.
SEE ALSO
xtherion (1)
For full information see The Therion Book
(/usr/share/doc/therion/thbook.pdf) which describes Therion and its use
in detail.
AUTHORS
Stacho Mudrak and Martin Budaj. This manual page was originally written
by Wookey <wookey@debian.org> for the Debian system, and is now
maintained by MB.
Copyright Wookey 2003, Martin Budaj 2003. This file is licensed under
the GNU General Public Licence.
2003/07/15