--- therion-0.2.13.orig/thbook/ch03.tex +++ therion-0.2.13/thbook/ch03.tex @@ -274,9 +274,9 @@ \options * |-g| - Using this option you can generate a new configuration file. - If |cfg-file| is not specified therion will use the |thconfig| - file. If the destination file exists, it'll be overwritten. + Generate a new configuration file. This will be the given + if specified, or |thconfig| in the current directory if not. + If the file already exists, it will be overwritten. * |-h, --help| --- therion-0.2.13.orig/Makefile +++ therion-0.2.13/Makefile @@ -56,8 +56,13 @@ ##CXXBFLAGS = -O3 # BUILD OXYGEN +ifneq (,$(findstring noopt,$(DEB_BUILD_OPTIONS))) +CCBFLAGS = -O0 +CXXBFLAGS = -O0 +else CCBFLAGS = -O2 CXXBFLAGS = -O2 +endif # BUILD RELEASE ##CCBFLAGS = @@ -71,8 +76,8 @@ # compiler settings -CXXFLAGS = -Wall -D_GNU_SOURCE $(CXXPFLAGS) $(CXXBFLAGS) -CCFLAGS = -Wall -D_GNU_SOURCE $(CCPFLAGS) $(CCBFLAGS) +CXXFLAGS = -g -Wall -D_GNU_SOURCE $(CXXPFLAGS) $(CXXBFLAGS) +CCFLAGS = -g -Wall -D_GNU_SOURCE $(CCPFLAGS) $(CCBFLAGS) OBJECTS = $(POBJECTS) $(CMNOBJECTS) # linker settings --- therion-0.2.13.orig/makeconvert.pl +++ therion-0.2.13/makeconvert.pl @@ -38,7 +38,46 @@ push @flso,$fln; } if ($toconv && ($numch > 0)) { - print "$fn ($numch changes)\n"; + print "$fn ($numch name/station/id changes)\n"; + open(FL,">$fn"); + print FL "@flso"; + close(FL); + } +} + + +foreach $fn (@flist) { + open(FL,"$fn"); + @fls = ; + close(FL); + @flso = (); + $toconv = 1; + $numch = 0; + foreach $fln (@fls) { + if ($fln =~ /endcenterline/) { + $toconv = 0; + } + if ($fln =~ /^\s*centerline\s*$/) { + $toconv = 0; + } + if ($fln =~ /^\s*enddata/) { + $numch++; + $fln =~ s/data/centerline/; + } + if ($fln =~ /^\s*data\s*$/) { + $numch++; + $fln =~ s/data/centerline/; + } + if ($fln =~ /^\s*data\s*(\s+)$/) { + if ($1 =~ /^\-/) { + $numch++; + $fln =~ s/data/centerline/; + } + } + push @flso,$fln; + } + if ($toconv && ($numch > 0)) { + print "$fn ($numch data/centreline changes)\n"; open(FL,">$fn"); print FL "@flso"; close(FL); --- therion-0.2.13.orig/debian/README.Debian +++ therion-0.2.13/debian/README.Debian @@ -0,0 +1,56 @@ +Therion for Debian +------------------ + +Overview +-------- +Therion is cave surveying software. It allows the drawing of cave surveys on the +computer. Data can be added to a drawn plan and it will be realigned to fit any +new closures or fixed points. All the work is done by the Therion program. The +front-end for entering data is xtherion. It uses Survex for centreline dataprocessing. + +It is the sort of software where you need to read the manual in order to use it +effectively. You are unlikely to get a PDF out of it without doing that. + +Docs +---- +The Therion Book (file:///usr/share/doc/therion/thbook.pdf) is the best +documentation for the system. Start by reading that. + +There is a Mailing list for users at therion-users@mail.freesofware.fsf.org + +Differences from non-Debian installation +---------------------------------------- +The Debian version of this package installs files according to the FHS and Debian +conventions. therion.ini and xtherion.ini files are installed in /etc, the actual +binaries (as opposed to symlinks) are put into /usr/bin, and docs and examples go +in /usr/share/doc/therion. + +Therion includes metapost and tex macros. In a conventional therion +installation path search variables are set to enable these to be found. In +Debian these macros are installed into /usr/lib/texmf/tex/therion and +/usr/lib/texmf/metapost/therion where they can be found without the need +for environment variables or TeX configuration changes on a standard install. + +Config and example files +------------------------ +therion.ini contains the defaults the program uses without +a config file so you won't need to change it unless you need a different +charater set. xtherion.ini allows you to specify various options such as +character sets and font sizes. + +/usr/share/doc/therion/examples contains some example dataset files. + + +Incompatible data changes in versions 0.2.6 and 0.2.10 +----------------------------------------------------- +The therion data format (.th and .th2 files) was changed in these versions. +In 0.2.6 the -name attribute for stations changed to -id, and -station changed to +-name. In 0.2.10 the data and enddata keywords changed to centreline and endcentreline +These changes are not backwards compatible and you must update any old +data files. The thconvert script can be run at the top of your therion data +directory tree and it will make these changes for you. There are not expected +to be any future incompatible data format changes. + +Therion v0.2.9 was the first version included in Debian + +-- Wookey , Sun, 21 June 2003 00:14:01 +0000 --- therion-0.2.13.orig/debian/changelog +++ therion-0.2.13/debian/changelog @@ -0,0 +1,50 @@ +therion (0.2.13-1) unstable; urgency=low + + * New upstream release - source reorganised, most Debian patches incorporated + * thpdf and theps2pdf incorporated into therion itself + * Made compatible with g++3.3 (closes: bug#198???) + + + -- Wookey Fri, 20 Jun 2003 22:28:42 +0100 + +therion (0.2.10-1) unstable; urgency=low + + * Therion book moved to source dir + * Transparency and opacity options introduced + * Make simplified (no make xtherion and make thpdf any more) + * xtherion.ini config file for xtherion added. + * All C++ compile warnings fixed + + -- Wookey Mon, 29 Apr 2003 00:35:27 +0000 + +therion (0.2.9-3) unstable; urgency=low + + * Added missing bwidget dependency (for xtherion). (closes: bug#189465) + + -- Wookey Mon, 21 Apr 2003 18:31:47 +0000 + +therion (0.2.9-2) unstable; urgency=low + + * Added missing tclsh build dependency. (closes: bug#189578) + + -- Wookey Mon, 21 Apr 2003 17:22:00 +0000 + +therion (0.2.9-1) unstable; urgency=low + + * New upstream release - proper version numbering + * Incompatible data format changes - thconvert added to help convert + + -- Wookey Fri, 7 Mar 2003 23:47:15 +0000 + +therion (0.0.20021212-2) unstable; urgency=low + + * Tidying up of Debianization - Readme's etc + + -- Wookey Wed, 18 Dec 2002 09:59:25 +0000 + +therion (0.0.20021212-1) unstable; urgency=low + + * Initial Release. + + -- Wookey Wed, 18 Dec 2002 09:59:25 +0000 + --- therion-0.2.13.orig/debian/manpages +++ therion-0.2.13/debian/manpages @@ -0,0 +1,3 @@ +therion.1 +xtherion.1 +thconvert.1 --- therion-0.2.13.orig/debian/dirs +++ therion-0.2.13/debian/dirs @@ -0,0 +1,7 @@ +etc +usr/bin +usr/share/doc/therion +usr/share/doc/therion/examples +usr/share/therion +usr/share/texmf/tex/therion +usr/share/texmf/metapost/therion --- therion-0.2.13.orig/debian/menu +++ therion-0.2.13/debian/menu @@ -0,0 +1,2 @@ +?package(therion):needs=X11 section=Apps/Math\ + title="xtherion" command="/usr/bin/xtherion" --- therion-0.2.13.orig/debian/doc-base +++ therion-0.2.13/debian/doc-base @@ -0,0 +1,10 @@ +Document: therion +Title: Therion Manual +Author: Martin Budaj and Stacho Mudrak +Abstract: This manual describes what therion is + and how it can be used. +Section: science + +Format: pdf +Files: /usr/share/doc/therion/thbook.pdf + --- therion-0.2.13.orig/debian/watch +++ therion-0.2.13/debian/watch @@ -0,0 +1,6 @@ +# Example watch control file for uscan +# Rename this file to "watch" and then you can run the "uscan" command +# to check for upstream updates and more. +# Site Directory Pattern Version Script +version=2 +www.therion.sk / therion-(.*)\.tar\.bz2 debian uupdate --- therion-0.2.13.orig/debian/mantherion.sgml +++ therion-0.2.13/debian/mantherion.sgml @@ -0,0 +1,271 @@ + manpage.1'. You may view + the manual page with: `docbook-to-man manpage.sgml | nroff -man | + less'. A typical entry in a Makefile or Makefile.am is: + +manpage.1: manpage.sgml + docbook-to-man $< > $@ + + + The docbook-to-man binary is found in the docbook-to-man package. + Please remember that if you create the nroff version in one of the + debian/rules file targets (such as build), you will need to include + docbook-to-man in your Build-Depends control field. + + --> + + Wookey"> + + June 21, 2003"> + 1"> + wookey@debian.org"> + + THERION"> + + + Debian"> + GNU"> +]> + + + +
+ &dhemail; +
+ + &dhsurname; + + + 2002,2003 + &dhusername; + + &dhdate; + + + &dhucpackage; + + &dhsection; + + + &dhpackage; + + program to draw cave surveys + + + + &dhpackage; config-file + + + + + + + + + + + + + + + + , + + + + + + DESCRIPTION + + This manual page briefly documents + &dhpackage; and provides an overview of the package. + + This manual page was written for the &debian; distribution + because the original program does not have a manual page. + + &dhpackage; is a program that processes therion data + files to produce cave surveys. The data files are .th files which contain survey + data, largely equivalent 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. + + &dhpackage; 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. There are also a couple of + internal helper programs - theps2pdf and + thpdf which do conversions to glue the various pieces of + software together. + + 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, UTF-8, ISO-8859-15. + + + + + + ARGUMENTS + + &dhpackage; 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 + + These programs follow 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 + Info files. + + + + , + + + Show summary of options. + + + + , + + + Show version information. + + + + + + Quiet mode - minimise output. + + + + + + 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. + + + + + + Ignore comments when writing (-g|-u) configuration file. + + + + + + Do not create a log-file. Normally all messages are written + into a therion.log file. + + + + + + Change the name of the log file. + + + + + + This option is used to set the search path (or list of paths, + separated by colon), which &dhpackage; will use to find its source + files (if it doesn't find them in the working directory). + + + + + + Run &dhpackage; in quiet mode. It will print only warning + and error messages (to STDERR). + + + + + + Print a list of all supported encodings. + + + + + + Print a default initialisation file. For more details + see the Initialisation section in the Appendix of the Therion Book. + + + + + + Set the name of the source file. + + + + + + Upgrade the configuration file. + + + + + + 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), thconvert (1). + + For full information see the Therion Manual in /usr/share/doc/therion/ + which describes &dhpackage; and its use in detail. + + + AUTHOR + + This manual page was written by &dhusername; &dhemail; for + the &debian; system (but may be used by others). Permission is + granted to copy, distribute and/or modify this document under + the terms of the GNU Free Documentation + License, Version 1.1 or any later version published by the Free + Software Foundation; with no Invariant Sections, no Front-Cover + Texts and no Back-Cover Texts. + + + + + + + --- therion-0.2.13.orig/debian/manxtherion.sgml +++ therion-0.2.13/debian/manxtherion.sgml @@ -0,0 +1,127 @@ + manpage.1'. You may view + the manual page with: `docbook-to-man manpage.sgml | nroff -man | + less'. A typical entry in a Makefile or Makefile.am is: + +manpage.1: manpage.sgml + docbook-to-man $< > $@ + + + The docbook-to-man binary is found in the docbook-to-man package. + Please remember that if you create the nroff version in one of the + debian/rules file targets (such as build), you will need to include + docbook-to-man in your Build-Depends control field. + + --> + + Wookey"> + + June 21, 2003"> + 1"> + wookey@debian.org"> + + THERION"> + + + + Debian"> + GNU"> +]> + + + +
+ &dhemail; +
+ + &dhsurname; + + + 2002,2003 + &dhusername; + + &dhdate; + + + &dhucpackage; + + &dhsection; + + + &dhcommand; + + Graphical drawing editor for therion + + + + &dhcommand; + + + + + + DESCRIPTION + + This manual page documents + &dhcommand;, which is part of the &dhpackage; package. + + This manual page was written for the &debian; distribution + because the original program does not have a manual page. + + &dhcommand; is an application that serves as a graphical + front end for therion. Therion itself works entirely with text-based files, but + much of the data needs to be generated graphically, so xtherion is one example of + how it might be done. It is written in Tcl/Tk. + + &dhcommand; lets you load a background GIF, JPEG or PNM + (a scan of the cave segment or to-scale notes), scale it, then draw therion 'scraps' over + the image, and relate it to survey stations and save the resulting data. + + For full information see the Therion Manual in /usr/share/doc/therion/thbook + which describes the application and its use in detail. + + + OPTIONS + + xtherion takes no options. + + + SEE ALSO + + therion (1), thconvert (1). + + + + AUTHOR + + This manual page was written by &dhusername; &dhemail; for + the &debian; system (but may be used by others). Permission is + granted to copy, distribute and/or modify this document under + the terms of the GNU Free Documentation + License, Version 1.1 or any later version published by the Free + Software Foundation; with no Invariant Sections, no Front-Cover + Texts and no Back-Cover Texts. + + + + + + + --- therion-0.2.13.orig/debian/TODO +++ therion-0.2.13/debian/TODO @@ -0,0 +1,5 @@ +This is a list of things that should be improved in the packaging of Therion. + +autoconf the build process +htmlize thbook + --- therion-0.2.13.orig/debian/copyright +++ therion-0.2.13/debian/copyright @@ -0,0 +1,28 @@ +This package was debianized by Wookey on +Tue, 3 Dec 2002 23:54:27 +0000. + +It was downloaded from http://therion.speleo.sk/ + +Upstream Authors: + Martin Budaj + Stacho Mudrak + +Copyright: + + This package is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; version 2 dated June, 1991. + + This package is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License + along with this package; if not, write to the Free Software + Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA + 02111-1307, USA. + +On Debian GNU/Linux systems, the complete text of the GNU General +Public License can be found in `/usr/share/common-licenses/GPL'. + --- therion-0.2.13.orig/debian/control +++ therion-0.2.13/debian/control @@ -0,0 +1,18 @@ +Source: therion +Section: science +Priority: extra +Maintainer: Wookey +Build-Depends: debhelper (>> 3.0.0), perl (>= 5.5), docbook-to-man, tetex-bin, tclsh +Standards-Version: 3.5.10 + +Package: therion +Architecture: any +Depends: ${shlibs:Depends}, tcl8.4 | wish , survex (>=1.0.0), tetex-bin, bwidget +Recommends: pdf-viewer +Description: Cave surveying - 2D and 3D drawing software + Therion aids the process of drawing up cave surveys (maps). Drawings are done + over scans and can be distorted to fit the centreline data. Output is in single + plan or atlas style in PDF files. All data is stored in text files and a Tcl/Tk + map editor (xtherion) is provided to aid in the creation of the files. It is + compatible with Survex and uses it for the centreline processing. TeX and + metapost are used to generate the images. --- therion-0.2.13.orig/debian/rules +++ therion-0.2.13/debian/rules @@ -0,0 +1,121 @@ +#!/usr/bin/make -f +# Sample debian/rules that uses debhelper. +# GNU copyright 1997 to 1999 by Joey Hess. + +# Uncomment this to turn on verbose mode. +export DH_VERBOSE=1 + + +ifneq (,$(findstring debug,$(DEB_BUILD_OPTIONS))) + CFLAGS += -g +endif +ifeq (,$(findstring nostrip,$(DEB_BUILD_OPTIONS))) + INSTALL_PROGRAM += -s +endif + +configure: configure-stamp +configure-stamp: + dh_testdir + # Add here commands to configure the package. + + touch configure-stamp + + +build: build-stamp + +build-stamp: configure-stamp + dh_testdir + + # Add here commands to compile the package. + $(MAKE) + /usr/bin/docbook-to-man debian/mantherion.sgml > therion.1 + /usr/bin/docbook-to-man debian/manxtherion.sgml > xtherion.1 + /usr/bin/docbook-to-man debian/manthconvert.sgml > thconvert.1 + $(MAKE) doc + #we should generate html here too if possible + + touch build-stamp + +clean: + dh_testdir + dh_testroot + rm -f build-stamp configure-stamp + + # Add here commands to clean up after the build process. + $(MAKE) clean + cd thbook && rm -f thbook.pdf thbook.log + + dh_clean + +install: build + dh_testdir + dh_testroot + dh_clean -k + + + + +# Build architecture-independent files here. +binary-indep: build install +# We have nothing to do by default. + +# Build architecture-dependent files here. +binary-arch: build install + dh_testdir + dh_testroot + dh_installdirs + + # Add here commands to install the package into debian/therion. + install -p -o root -g root -m 755 therion debian/therion/usr/bin/therion + install -p -o root -g root -m 755 xtherion/xtherion debian/therion/usr/bin/xtherion + install -p -o root -g root -m 755 makeconvert.pl debian/therion/usr/bin/thconvert + + install -p -o root -g root -m 644 lib/grades.th debian/therion/usr/share/therion/ + install -p -o root -g root -m 644 lib/layouts.thcfg debian/therion/usr/share/therion/ + install -p -o root -g root -m 644 lib/therion.th debian/therion/usr/share/therion/ + + install -p -o root -g root -m 644 therion.ini debian/therion/etc/therion.ini + install -p -o root -g root -m 644 xtherion/xtherion.ini debian/therion/etc/xtherion.ini + + install -d -o root -g root -m 755 debian/therion/usr/share/texmf/metapost/therion + install -d -o root -g root -m 755 debian/therion/usr/share/texmf/tex/therion + install -p -o root -g root -m 644 mpost/*.mp debian/therion/usr/share/texmf/metapost/therion/ + install -p -o root -g root -m 644 tex/*.tex debian/therion/usr/share/texmf/tex/therion/ + + install -p -o root -g root -m 644 thbook/thbook.pdf debian/therion/usr/share/doc/therion/thbook.pdf + install -p -o root -g root -m 644 thconfig debian/therion/usr/share/doc/therion/examples/ + install -p -o root -g root -m 644 therion.ini debian/therion/usr/share/doc/therion/examples/ + install -d -o root -g root -m 755 debian/therion/usr/share/doc/therion/examples/tests + install -p -o root -g root -m 644 tests/* debian/therion/usr/share/doc/therion/examples/tests/ +#this file is null at the moment - so get rid of it +# dh_install +# dh_installdebconf + dh_installdocs --noscripts +# dh_installexamples + dh_installmenu +# dh_installlogrotate +# dh_installemacsen +# dh_installpam +# dh_installmime +# dh_installinit +# dh_installcron + dh_installman +# dh_installinfo +# dh_undocumented + dh_installchangelogs + dh_strip + dh_compress -X.pdf + dh_fixperms +# dh_makeshlibs + dh_installdeb +# dh_perl + dh_shlibdeps + dh_gencontrol + dh_md5sums + dh_builddeb + +binary: binary-indep binary-arch +.PHONY: build clean binary-indep binary-arch binary install configure + +get-orig-source: + wget -nc -nd http://therion.speleo.sk/download.php?package=therion --- therion-0.2.13.orig/debian/compat +++ therion-0.2.13/debian/compat @@ -0,0 +1 @@ +3 --- therion-0.2.13.orig/debian/manthconvert.sgml +++ therion-0.2.13/debian/manthconvert.sgml @@ -0,0 +1,136 @@ + manpage.1'. You may view + the manual page with: `docbook-to-man manpage.sgml | nroff -man | + less'. A typical entry in a Makefile or Makefile.am is: + +manpage.1: manpage.sgml + docbook-to-man $< > $@ + + + The docbook-to-man binary is found in the docbook-to-man package. + Please remember that if you create the nroff version in one of the + debian/rules file targets (such as build), you will need to include + docbook-to-man in your Build-Depends control field. + + --> + + Wookey"> + + June 21, 2003"> + 1"> + wookey@debian.org"> + + THERION"> + + + + Debian"> + GNU"> +]> + + + +
+ &dhemail; +
+ + &dhsurname; + + + 2003 + &dhusername; + + &dhdate; + + + &dhucpackage; + + &dhsection; + + + &dhcommand; + + Therion data update conversion script + + + + &dhcommand; + + + + + + DESCRIPTION + + This manual page documents + &dhcommand;, which is part of the &dhpackage; package. + + This manual page was written for the &debian; distribution + because the original program does not have a manual page. + + &dhcommand; is a script that attempts to update data + created with earlier versions of therion. There were incompatible data format + changes made in &dhpackage; 0.2.6 and 0.2.10. It is written in perl. + + To use the script change directory to the directory containing your + &dhpackage; data. Then run &dhcommand;. It will recurse down the tree looking for .th and .th2 + files and updating them. The files changed are listed followed by + the number of changes of each type made in each file. + + The version 0.2.6 change was to the -station, -name + and -id attributes. -name is replaced + by -id, and -station is replaced by -name. + The version 0.2.10 change is that data and enddata + are replaced by centreline and endcentreline. + These changes are, unfortunately, not compatible between + &dhpackage; versions so data must be converted. These are expected to be the last + incompatible data format changes in &dhpackage;. + + + + OPTIONS + + &dhcommand; takes no options. + + + SEE ALSO + + therion (1), xtherion (1). + + For full information see the Therion Manual in /usr/doc/therion/thbook + which describes &dhpackage; and its use in detail. + + + AUTHOR + + This manual page was written by &dhusername; &dhemail; for + the &debian; system (but may be used by others). Permission is + granted to copy, distribute and/or modify this document under + the terms of the GNU Free Documentation + License, Version 1.1 or any later version published by the Free + Software Foundation; with no Invariant Sections, no Front-Cover + Texts and no Back-Cover Texts. + + + + + + + --- therion-0.2.13.orig/debian/postinst +++ therion-0.2.13/debian/postinst @@ -0,0 +1,14 @@ +#!/bin/sh +set -e + +#DEBHELPER# +# from dh_installdocs, taken out to stop it adding the now-deprecated /usr/doc link too +if [ "$1" = configure ] && command -v install-docs >/dev/null 2>&1; then + install-docs -i /usr/share/doc-base/therion +fi +# make sure TeX sees our macros +if [ "$1" = configure -a -x /usr/bin/texhash ]; then + /usr/bin/texhash +fi + + --- therion-0.2.13.orig/debian/postrm +++ therion-0.2.13/debian/postrm @@ -0,0 +1,9 @@ +#!/bin/sh +set -e + +#DEBHELPER# +# update TeX now our macros have been removed +if [ -x /usr/bin/texhash ]; then /usr/bin/texhash +fi + + --- therion-0.2.13.orig/debian/prerm +++ therion-0.2.13/debian/prerm @@ -0,0 +1,10 @@ +#!/bin/sh +set -e + +#DEBHELPER# +# Originally made by dh_installdocs, but moved here to stop it doing the /doc/ link thing +if [ "$1" = remove -o "$1" = upgrade ] && \ + command -v install-docs >/dev/null 2>&1; then + install-docs -r therion +fi +# End automatically added section --- therion-0.2.13.orig/debian/conffiles +++ therion-0.2.13/debian/conffiles @@ -0,0 +1,2 @@ +/etc/therion.ini +/etc/xtherion.ini --- therion-0.2.13.orig/therion.1 +++ therion-0.2.13/therion.1 @@ -0,0 +1,159 @@ +.\" This -*- nroff -*- file has been generated from +.\" DocBook SGML with docbook-to-man on Debian GNU/Linux. +...\" +...\" transcript compatibility for postscript use. +...\" +...\" synopsis: .P! +...\" +.de P! +\\&. +.fl \" force out current output buffer +\\!%PB +\\!/showpage{}def +...\" the following is from Ken Flowers -- it prevents dictionary overflows +\\!/tempdict 200 dict def tempdict begin +.fl \" prolog +.sy cat \\$1\" bring in postscript file +...\" the following line matches the tempdict above +\\!end % tempdict % +\\!PE +\\!. +.sp \\$2u \" move below the image +.. +.de pF +.ie \\*(f1 .ds f1 \\n(.f +.el .ie \\*(f2 .ds f2 \\n(.f +.el .ie \\*(f3 .ds f3 \\n(.f +.el .ie \\*(f4 .ds f4 \\n(.f +.el .tm ? font overflow +.ft \\$1 +.. +.de fP +.ie !\\*(f4 \{\ +. ft \\*(f4 +. ds f4\" +' br \} +.el .ie !\\*(f3 \{\ +. ft \\*(f3 +. ds f3\" +' br \} +.el .ie !\\*(f2 \{\ +. ft \\*(f2 +. ds f2\" +' br \} +.el .ie !\\*(f1 \{\ +. ft \\*(f1 +. ds f1\" +' br \} +.el .tm ? font underflow +.. +.ds f1\" +.ds f2\" +.ds f3\" +.ds f4\" +'\" t +.ta 8n 16n 24n 32n 40n 48n 56n 64n 72n +.TH "THERION" "1" +.SH "NAME" +therion \(em program to draw cave surveys +.SH "SYNOPSIS" +.PP +\fBtherion\fP [config-file] [\fB-q\fP] [\fB-L \fP] [\fB-g \fP] [\fB-h\fP \fB--help\fP] [\fB-i\fP] [\fB-L\fP] [\fB-l \fIlog-file\fP\fP] [\fB-p \fIsearch-path\fP\fP] [\fB-q\fP] [\fB--print-encodings\fP] [\fB--print-init-file\fP] [\fB-s\fP] [\fB-u\fP] [\fB-v\fP, \fB--version\fP] [\fB-d\fP] +.SH "DESCRIPTION" +.PP +This manual page briefly documents +\fBtherion\fP and provides an overview of the package. +.PP +This manual page was written for the \fBDebian\fP distribution +because the original program does not have a manual page. +.PP +\fBtherion\fP is a program that processes therion data +files to produce cave surveys. The data files are .th files which contain survey +data, largely equivalent 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. +.PP +\fBtherion\fP uses a number of helper programs to do its +job. \fBSurvex\fP is used to process the centreline data, +\fBmetapost\fP is used to draw cave symbols, and +\fBpdftex\fP generates the final maps. There are also a couple of +internal helper programs - \fBtheps2pdf\fP and +\fBthpdf\fP which do conversions to glue the various pieces of +software together. +.PP +In order to make the entering of drawing data practical, and to make the +editing of survey files easier, a graphical editor \fBxtherion\fP +is included. This also includes a 'compiler' function which runs therion on the +data to produce output. This is implemented using tcl/tk. +.PP +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. +.PP +Multiple languages and character sets are supported - currently ISO-8859-1, +ISO-8859-2, UTF-8, ISO-8859-15. +.SH "ARGUMENTS" +.PP +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. +.SH "OPTIONS" +.PP +These programs follow 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 +\fBInfo\fP files. +.IP "\fB-h\fP, \fB--help\fP " 10 +Show summary of options. +.IP "\fB-v\fP, \fB--version\fP " 10 +Show version information. +.IP "\fB-q\fP" 10 +Quiet mode - minimise output. +.IP "\fB-g\fP" 10 +Generate a new configuration file. This will be the given +config-file if specified, or \fBthconfig\fP +in the current directory if not. If the file already exists, it will be overwritten. +.IP "\fB-i\fP" 10 +Ignore comments when writing (-g|-u) configuration file. +.IP "\fB-L\fP" 10 +Do not create a log-file. Normally all messages are written +into a \fBtherion.log\fP file. +.IP "\fB-l log-file\fP" 10 +Change the name of the log file. +.IP "\fB-p search-path\fP" 10 +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). +.IP "\fB-q\fP" 10 +Run therion in quiet mode. It will print only warning +and error messages (to STDERR). +.IP "\fB--print-encodings\fP" 10 +Print a list of all supported encodings. +.IP "\fB--print-init-file\fP" 10 +Print a default initialisation file. For more details +see the Initialisation section in the Appendix of the Therion Book. +.IP "\fB-s\fP" 10 +Set the name of the source file. +.IP "\fB-u\fP" 10 +Upgrade the configuration file. +.IP "\fB-d\fP" 10 +Turn on debugging mode. The current implementation creates a +temporary directory named \fBthTMPDIR\fP (in your system temporary +directory) and does not delete any temporary files. +.SH "SEE ALSO" +.PP +xtherion (1), thconvert (1). +.PP +For full information see the Therion Manual in /usr/share/doc/therion/ +which describes therion and its use in detail. +.SH "AUTHOR" +.PP +This manual page was written by Wookey wookey@debian.org for +the \fBDebian\fP system (but may be used by others). Permission is +granted to copy, distribute and/or modify this document under +the terms of the GNU Free Documentation +License, Version 1.1 or any later version published by the Free +Software Foundation; with no Invariant Sections, no Front-Cover +Texts and no Back-Cover Texts. +...\" created by instant / docbook-to-man, Tue 01 Jul 2003, 00:59 --- therion-0.2.13.orig/xtherion.1 +++ therion-0.2.13/xtherion.1 @@ -0,0 +1,96 @@ +.\" This -*- nroff -*- file has been generated from +.\" DocBook SGML with docbook-to-man on Debian GNU/Linux. +...\" +...\" transcript compatibility for postscript use. +...\" +...\" synopsis: .P! +...\" +.de P! +\\&. +.fl \" force out current output buffer +\\!%PB +\\!/showpage{}def +...\" the following is from Ken Flowers -- it prevents dictionary overflows +\\!/tempdict 200 dict def tempdict begin +.fl \" prolog +.sy cat \\$1\" bring in postscript file +...\" the following line matches the tempdict above +\\!end % tempdict % +\\!PE +\\!. +.sp \\$2u \" move below the image +.. +.de pF +.ie \\*(f1 .ds f1 \\n(.f +.el .ie \\*(f2 .ds f2 \\n(.f +.el .ie \\*(f3 .ds f3 \\n(.f +.el .ie \\*(f4 .ds f4 \\n(.f +.el .tm ? font overflow +.ft \\$1 +.. +.de fP +.ie !\\*(f4 \{\ +. ft \\*(f4 +. ds f4\" +' br \} +.el .ie !\\*(f3 \{\ +. ft \\*(f3 +. ds f3\" +' br \} +.el .ie !\\*(f2 \{\ +. ft \\*(f2 +. ds f2\" +' br \} +.el .ie !\\*(f1 \{\ +. ft \\*(f1 +. ds f1\" +' br \} +.el .tm ? font underflow +.. +.ds f1\" +.ds f2\" +.ds f3\" +.ds f4\" +'\" t +.ta 8n 16n 24n 32n 40n 48n 56n 64n 72n +.TH "THERION" "1" +.SH "NAME" +xtherion \(em Graphical drawing editor for therion +.SH "SYNOPSIS" +.PP +\fBxtherion\fP +.SH "DESCRIPTION" +.PP +This manual page documents +\fBxtherion\fP, which is part of the therion package. +.PP +This manual page was written for the \fBDebian\fP distribution +because the original program does not have a manual page. +.PP +\fBxtherion\fP is an application that serves as a graphical +front end for therion. Therion itself works entirely with text-based files, but +much of the data needs to be generated graphically, so xtherion is one example of +how it might be done. It is written in Tcl/Tk. +.PP +\fBxtherion\fP lets you load a background GIF, JPEG or PNM +(a scan of the cave segment or to-scale notes), scale it, then draw therion 'scraps' over +the image, and relate it to survey stations and save the resulting data. +.PP +For full information see the Therion Manual in /usr/share/doc/therion/thbook +which describes the application and its use in detail. +.SH "OPTIONS" +.PP +xtherion takes no options. +.SH "SEE ALSO" +.PP +therion (1), thconvert (1). +.SH "AUTHOR" +.PP +This manual page was written by Wookey wookey@debian.org for +the \fBDebian\fP system (but may be used by others). Permission is +granted to copy, distribute and/or modify this document under +the terms of the GNU Free Documentation +License, Version 1.1 or any later version published by the Free +Software Foundation; with no Invariant Sections, no Front-Cover +Texts and no Back-Cover Texts. +...\" created by instant / docbook-to-man, Tue 01 Jul 2003, 01:00 --- therion-0.2.13.orig/thconvert.1 +++ therion-0.2.13/thconvert.1 @@ -0,0 +1,104 @@ +.\" This -*- nroff -*- file has been generated from +.\" DocBook SGML with docbook-to-man on Debian GNU/Linux. +...\" +...\" transcript compatibility for postscript use. +...\" +...\" synopsis: .P! +...\" +.de P! +\\&. +.fl \" force out current output buffer +\\!%PB +\\!/showpage{}def +...\" the following is from Ken Flowers -- it prevents dictionary overflows +\\!/tempdict 200 dict def tempdict begin +.fl \" prolog +.sy cat \\$1\" bring in postscript file +...\" the following line matches the tempdict above +\\!end % tempdict % +\\!PE +\\!. +.sp \\$2u \" move below the image +.. +.de pF +.ie \\*(f1 .ds f1 \\n(.f +.el .ie \\*(f2 .ds f2 \\n(.f +.el .ie \\*(f3 .ds f3 \\n(.f +.el .ie \\*(f4 .ds f4 \\n(.f +.el .tm ? font overflow +.ft \\$1 +.. +.de fP +.ie !\\*(f4 \{\ +. ft \\*(f4 +. ds f4\" +' br \} +.el .ie !\\*(f3 \{\ +. ft \\*(f3 +. ds f3\" +' br \} +.el .ie !\\*(f2 \{\ +. ft \\*(f2 +. ds f2\" +' br \} +.el .ie !\\*(f1 \{\ +. ft \\*(f1 +. ds f1\" +' br \} +.el .tm ? font underflow +.. +.ds f1\" +.ds f2\" +.ds f3\" +.ds f4\" +'\" t +.ta 8n 16n 24n 32n 40n 48n 56n 64n 72n +.TH "THERION" "1" +.SH "NAME" +thconvert \(em Therion data update conversion script +.SH "SYNOPSIS" +.PP +\fBthconvert\fP +.SH "DESCRIPTION" +.PP +This manual page documents +\fBthconvert\fP, which is part of the therion package. +.PP +This manual page was written for the \fBDebian\fP distribution +because the original program does not have a manual page. +.PP +\fBthconvert\fP is a script that attempts to update data +created with earlier versions of therion. There were incompatible data format +changes made in therion 0.2.6 and 0.2.10. It is written in perl. +.PP +To use the script change directory to the directory containing your +therion data. Then run thconvert. It will recurse down the tree looking for +.th and .th2 files and updating them. The files changed are listed followed by +the number of changes of each type made in each file. +.PP +The version 0.2.6 change was to the \fI-station\fP, \fI-name\fP +and \fI-id\fP attributes. \fI-name\fP is replaced +by \fI-id\fP, and \fI-station\fP is replaced by \fI-name\fP. +The version 0.2.10 change is that \fIdata\fP and \fIenddata\fP are replaced by \fIcentreline\fP and \fIendcentreline\fP. +These changes are, unfortunately, not compatible between +therion versions so data must be converted. These are expected to be the last +incompatible data format changes in therion. +.SH "OPTIONS" +.PP +thconvert takes no options. +.SH "SEE ALSO" +.PP +therion (1), xtherion (1). +.PP +For full information see the Therion Manual in /usr/doc/therion/thbook +which describes therion and its use in detail. +.SH "AUTHOR" +.PP +This manual page was written by Wookey wookey@debian.org for +the \fBDebian\fP system (but may be used by others). Permission is +granted to copy, distribute and/or modify this document under +the terms of the GNU Free Documentation +License, Version 1.1 or any later version published by the Free +Software Foundation; with no Invariant Sections, no Front-Cover +Texts and no Back-Cover Texts. +...\" created by instant / docbook-to-man, Tue 01 Jul 2003, 01:00