Provided by: therion_5.3.13-1_amd64 bug

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
        .PLT files and VRML files for 3D models.

       Therion uses a number of helper programs to do its job. Survex  is  used  to  process  the
       centreline  data,  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                                 THERION(1)