[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[therion-users] Packaging patches for 0.2.9-1
From: |
Wookey |
Subject: |
[therion-users] Packaging patches for 0.2.9-1 |
Date: |
Mon, 24 Mar 2003 18:50:31 +0000 (GMT) |
I'm getting a few errors during the Therion build which I think merit
changes to the Therion source. (I've run out of time today - maybe tomorrow
for these)
There are also a number of patches I've made which should probably go in
the original. I'll present them here for you to say if you don't like some
of them.
Updated doc/HISTORY
Add -g -Wall for c and c++ compiles and -O2 for final build
Manpages for Therion, xtherion, thconvert, thpdf, eps2pdf (done in SGML) -
do you want to add these to the main tarball?
A diff for all this is attached if you want to apply it. The manpages need
to be run through docbook2man to generate final man pages.
Files with no newline at the end (this produces warnings from various tools):
doc/HISTORY
AUTHORS
INSTALL
And all the thbook .TeX files.
There is a spurious src/index.html file that I don't think is supposed to
be there.
Hope this is useful.
Wookey
--
Aleph One Ltd, Bottisham, CAMBRIDGE, CB5 9BA, UK Tel +44 (0) 1223 811679
work: http://www.aleph1.co.uk/ play: http://www.chaos.org.uk/~wookey/
--- therion-0.2.9.orig/doc/HISTORY
+++ therion-0.2.9/doc/HISTORY
@@ -22,4 +22,6 @@
Aug: xtherion extended to 2D map editor (as a replacement of ThEdit)
Sep: Therion compiles first real and complex map of a cave. xtherion
extended to compiler.
- Oct 5:
\ No newline at end of file
+ Dec: Packaged for Debian, Therion book started
+2003:
+ Mar: Installed in Debian
--- therion-0.2.9.orig/src/Makefile
+++ therion-0.2.9/src/Makefile
@@ -45,8 +45,16 @@
# BUILD CONFIG
# BUILD RELEASE
-CCBFLAGS =
-CXXBFLAGS =
+CCBFLAGS = -g -Wall
+CXXBFLAGS = -g -Wall
+
+ifneq (,$(findstring noopt,$(DEB_BUILD_OPTIONS)))
+CCBFLAGS += -O0
+CXXBFLAGS += -O0
+else
+CCBFLASG += -O2
+CXXBFLAGS += -O2
+endif
# BUILD DEBUG
##CCBFLAGS =
--- therion-0.2.9.orig/debian/mantherion.sgml
+++ therion-0.2.9/debian/mantherion.sgml
@@ -0,0 +1,264 @@
+<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [
+
+<!-- Process this file with docbook-to-man to generate an nroff manual
+ page: `docbook-to-man manpage.sgml > 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.
+
+ -->
+
+ <!ENTITY dhsurname "<surname>Wookey</surname>">
+ <!-- Please adjust the date whenever revising the manpage. -->
+ <!ENTITY dhdate "<date>December 3, 2002</date>">
+ <!ENTITY dhsection "<manvolnum>1</manvolnum>">
+ <!ENTITY dhemail "<email>address@hidden</email>">
+ <!ENTITY dhusername "Wookey">
+ <!ENTITY dhucpackage "<refentrytitle>THERION</refentrytitle>">
+ <!ENTITY dhpackage "therion">
+
+ <!ENTITY debian "<productname>Debian</productname>">
+ <!ENTITY gnu "<acronym>GNU</acronym>">
+]>
+
+<refentry>
+ <refentryinfo>
+ <address>
+ &dhemail;
+ </address>
+ <author>
+ &dhsurname;
+ </author>
+ <copyright>
+ <year>2002</year>
+ <holder>&dhusername;</holder>
+ </copyright>
+ &dhdate;
+ </refentryinfo>
+ <refmeta>
+ &dhucpackage;
+
+ &dhsection;
+ </refmeta>
+ <refnamediv>
+ <refname>&dhpackage;</refname>
+
+ <refpurpose>program to draw cave surveys</refpurpose>
+ </refnamediv>
+ <refsynopsisdiv>
+ <cmdsynopsis>
+ <command>&dhpackage;</command> <arg>config-file</arg>
+
+ <arg><option>-q</option></arg>
+
+ <arg><option>-L </option></arg>
+ <arg><option>-g </option></arg>
+ <arg><option>-h</option> <option>--help</option></arg>
+ <arg><option>-i</option></arg>
+ <arg><option>-L</option></arg>
+ <arg><option>-l <replaceable>log-file</replaceable></option></arg>
+ <arg><option>-p <replaceable>search-path</replaceable></option></arg>
+ <arg><option>-q</option></arg>
+ <arg><option>--print-encodings</option></arg>
+ <arg><option>--print-init-file</option></arg>
+ <arg><option>-s</option></arg>
+ <arg><option>-u</option></arg>
+ <arg><option>-v</option>, <option>--version</option></arg>
+ <arg><option>-d</option></arg>
+
+ </cmdsynopsis>
+ </refsynopsisdiv>
+ <refsect1>
+ <title>DESCRIPTION</title>
+
+ <para>This manual page briefly documents
+ <command>&dhpackage;</command> and provides an overview of the
package.</para>
+
+ <para>This manual page was written for the &debian; distribution
+ because the original program does not have a manual page.</para>
+
+ <para><command>&dhpackage;</command> 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. </para>
+
+ <para><command>&dhpackage;</command> uses a number of helper programs to
do its
+ job. <command>Survex</command> is used to process the centreline data,
+ <command>metapost</command> is used to draw cave symbols, and
+ <command>pdftex</command> generates the final maps. There are also a
couple of
+ internal helper programs - <command>theps2pdf</command> and
+ <command>thpdf</command> which do conversions to glue the various pieces
of
+ software together.</para>
+
+ <para>In order to make the entering of drawing data practical, and to make
the
+ editing of survey files easier, a graphical editor
<command>xtherion</command>
+ is included. This also includes a 'compiler' function which runs therion
on the
+ data to produce output. This is implemented using tcl/tk.</para>
+
+ <para>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.</para>
+
+ <para>Multiple languages and character sets are supported - currently
ISO-8859-1,
+ ISO-8859-2, UTF-8, ISO-8859-15.</para>
+
+
+
+ </refsect1>
+ <refsect1>
+ <title>OPTIONS</title>
+
+ <para>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
+ <application>Info</application> files.</para>
+
+ <variablelist>
+ <varlistentry>
+ <term><option>-h</option>, <option>--help</option>
+ </term>
+ <listitem>
+ <para>Show summary of options.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>-v</option>, <option>--version</option>
+ </term>
+ <listitem>
+ <para>Show version information.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>-q</option></term>
+ <listitem>
+ <para>Quiet mode - minimise output.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>-g</option></term>
+ <listitem>
+ <para>Using this option, you can generate the new configuration file.
+ If cfg-file will not be specified, program will use thconfig
+ file. If destination file exists, it'll be overwritten.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>-i</option></term>
+ <listitem>
+ <para>Ignore comments when writing (-g|-u) configuration file.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>-L</option></term>
+ <listitem>
+ <para>Do not create log-file. Normally it writes all the messages
+ into <filename>therion.log</filename> file.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>-l log-file</option></term>
+ <listitem>
+ <para>Change the name of the log file.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>-p search-path</option></term>
+ <listitem>
+ <para>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).</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>-q</option></term>
+ <listitem>
+ <para>Run program in quiet mode. Program will print only warning
+ and error messages to STDERR.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--print-encodings</option></term>
+ <listitem>
+ <para>Print a list of all supported encodings.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--print-init-file</option></term>
+ <listitem>
+ <para>Print a default initialization file. For more details
+ see the INITIALIZATION section of this document.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>-s</option></term>
+ <listitem>
+ <para>Set the name of the source file.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>-u</option></term>
+ <listitem>
+ <para>Upgrade the configuration file.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>-d</option></term>
+ <listitem>
+ <para>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.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </refsect1>
+ <refsect1>
+ <title>SEE ALSO</title>
+
+ <para>xtherion (1), theps2pdf (1), thpdf (1), thconvert (1).</para>
+
+ <para>For full information see the Therion Manual in
/usr/doc/therion/thbook
+ which describes &dhpackage; and its use in detail.</para>
+ </refsect1>
+ <refsect1>
+ <title>AUTHOR</title>
+
+ <para>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 <acronym>GNU</acronym> 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.</para>
+
+ </refsect1>
+</refentry>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:2
+sgml-indent-data:t
+sgml-parent-document:nil
+sgml-default-dtd-file:nil
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+-->
+
+
--- therion-0.2.9.orig/debian/manxtherion.sgml
+++ therion-0.2.9/debian/manxtherion.sgml
@@ -0,0 +1,127 @@
+<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [
+
+<!-- Process this file with docbook-to-man to generate an nroff manual
+ page: `docbook-to-man manpage.sgml > 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.
+
+ -->
+
+ <!ENTITY dhsurname "<surname>Wookey</surname>">
+ <!-- Please adjust the date whenever revising the manpage. -->
+ <!ENTITY dhdate "<date>December 25, 2002</date>">
+ <!ENTITY dhsection "<manvolnum>1</manvolnum>">
+ <!ENTITY dhemail "<email>address@hidden</email>">
+ <!ENTITY dhusername "Wookey">
+ <!ENTITY dhucpackage "<refentrytitle>THERION</refentrytitle>">
+ <!ENTITY dhpackage "therion">
+ <!ENTITY dhcommand "xtherion">
+
+ <!ENTITY debian "<productname>Debian</productname>">
+ <!ENTITY gnu "<acronym>GNU</acronym>">
+]>
+
+<refentry>
+ <refentryinfo>
+ <address>
+ &dhemail;
+ </address>
+ <author>
+ &dhsurname;
+ </author>
+ <copyright>
+ <year>2002</year>
+ <holder>&dhusername;</holder>
+ </copyright>
+ &dhdate;
+ </refentryinfo>
+ <refmeta>
+ &dhucpackage;
+
+ &dhsection;
+ </refmeta>
+ <refnamediv>
+ <refname>&dhcommand;</refname>
+
+ <refpurpose>Graphical drawing editor for therion</refpurpose>
+ </refnamediv>
+ <refsynopsisdiv>
+ <cmdsynopsis>
+ <command>&dhcommand;</command>
+
+
+ </cmdsynopsis>
+ </refsynopsisdiv>
+ <refsect1>
+ <title>DESCRIPTION</title>
+
+ <para>This manual page documents
+ <command>&dhcommand;</command>, which is part of the &dhpackage;
package.</para>
+
+ <para>This manual page was written for the &debian; distribution
+ because the original program does not have a manual page.</para>
+
+ <para><command>&dhcommand;</command> 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.</para>
+
+ <para><command>&dhpackage;</command> 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.</para>
+
+ <para>For full information see the Therion Manual in
/usr/doc/therion/thbook
+ which describes the application and its use in detail.</para>
+ </refsect1>
+ <refsect1>
+ <title>OPTIONS</title>
+
+ <para>xtherion takes no options.</para>
+ </refsect1>
+ <refsect1>
+ <title>SEE ALSO</title>
+
+ <para>therion (1), thpdf (1), theps2pdf (1), thconvert (1).</para>
+
+ </refsect1>
+ <refsect1>
+ <title>AUTHOR</title>
+
+ <para>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 <acronym>GNU</acronym> 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.</para>
+
+ </refsect1>
+</refentry>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:2
+sgml-indent-data:t
+sgml-parent-document:nil
+sgml-default-dtd-file:nil
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+-->
+
+
--- therion-0.2.9.orig/debian/manthpdf.sgml
+++ therion-0.2.9/debian/manthpdf.sgml
@@ -0,0 +1,271 @@
+<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [
+
+<!-- Process this file with docbook-to-man to generate an nroff manual
+ page: `docbook-to-man manpage.sgml > 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.
+
+ -->
+
+ <!ENTITY dhsurname "<surname>Wookey</surname>">
+ <!-- Please adjust the date whenever revising the manpage. -->
+ <!ENTITY dhdate "<date>December 25, 2002</date>">
+ <!ENTITY dhsection "<manvolnum>1</manvolnum>">
+ <!ENTITY dhemail "<email>address@hidden</email>">
+ <!ENTITY dhusername "Wookey">
+ <!ENTITY dhucpackage "<refentrytitle>THERION</refentrytitle>">
+ <!ENTITY dhpackage "therion">
+ <!ENTITY dhcommand "thpdf">
+
+ <!ENTITY debian "<productname>Debian</productname>">
+ <!ENTITY gnu "<acronym>GNU</acronym>">
+]>
+
+<refentry>
+ <refentryinfo>
+ <address>
+ &dhemail;
+ </address>
+ <author>
+ &dhsurname;
+ </author>
+ <copyright>
+ <year>2002</year>
+ <holder>&dhusername;</holder>
+ </copyright>
+ &dhdate;
+ </refentryinfo>
+ <refmeta>
+ &dhucpackage;
+
+ &dhsection;
+ </refmeta>
+ <refnamediv>
+ <refname>&dhcommand;</refname>
+
+ <refpurpose>makes a survey/atlas in PDF format</refpurpose>
+ </refnamediv>
+ <refsynopsisdiv>
+ <cmdsynopsis>
+ <command>&dhcommand;</command> <arg>options</arg>
<replaceable>input-file</replaceable>
+<arg><option>-q</option></arg>
+<arg><option>-m</option></arg>
+
+
+ </cmdsynopsis>
+ </refsynopsisdiv>
+ <refsect1>
+ <title>DESCRIPTION</title>
+
+ <para>This manual page documents
+ <command>&dhcommand;</command>, which is part of the &dhpackage;
package.</para>
+
+ <para>It was created for the &debian; distribution from
+ Martin Budaj's man-page-like HTML docs.</para>
+
+ <para><command>&dhcommand;</command> is a program that processes the
output of
+ the therion command to generate the final PDF cave survey/map/atlas. It is
a perl script.</para>
+
+ <para><command>&dhpackage;</command> converts output files from Metapost
+ (in EPS format) to PDF XObjects and writes PdfTeX objects.</para>
+
+ <para>Four files are created:</para>
+
+ <para><filename>th_fontdef.tex</filename>,
<filename>th_formdef.tex</filename>, <filename>th_pagedef.tex</filename>
+ and <filename>th_pages.tex</filename>. To make an atlas, create a TeX file
(e.g.
+ <filename>main.tex</filename>, see EXAMPLES) in which you define
appropriate
+ page dimensions and include the four files list above (in order), then
process
+ this file with PdfTeX (or PdfeTeX if you have a lot of scraps). </para>
+
+ <para>A config file can specify additional options for thpdf.
+ This file is looked for in the current directory and is called
<filename>Config</filename>.
+ Details of the options are given in the CONFIG FILE section, below.</para>
+
+ </refsect1>
+ <refsect1>
+ <title>OPTIONS</title>
+
+ <para>Long-format options are not suppported.</para>
+
+
+ <variablelist>
+ <varlistentry>
+ <term><option>-q</option>
+ </term>
+ <listitem>
+ <para>Quick mode - thpdf uses the previously converted data (files
+ <filename>th_fontdef.tex</filename> and
<filename>th_formdef.tex</filename>).
+ The file <filename>th_hashdef</filename> from the previous run must be
present
+ too. This option cannot be used when Therion produces new Metapost
files.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>-m</option>
+ </term>
+ <listitem>
+ <para>Draws one (possibly large) map page instead of a multi-page
atlas.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </refsect1>
+ <refsect1>
+ <title>EXAMPLES</title>
+
+ <para>Here is an example <filename>main.tex</filename> file:
+ <literallayout>
+ \pdfpagewidth=21cm
+ \pdfpageheight=20cm
+ \hsize=20cm
+ \vsize=19.5cm
+ \hoffset=-2.04cm
+ \voffset=-2.04cm
+
+ \pdfinfo {%
+ /Title (Closani Cave)
+ /Author (Fred Flinstone)
+ }
+
+ \input th_fontdef
+ \input th_formdef
+ \input th_pagedef
+ \input th_pages
+
+ \end
+ </literallayout>
+ </para>
+ </refsect1>
+ <refsect1>
+ <title>CONFIG FILE</title>
+
+ <para>The <filename>Config</filename> file specifies additional options for
+ <command>thpdf</command>.</para>
+
+ <para>Options for dimensions (dimension can be in points (pt), postscript
+ points (bp), milimeters (mm), centimeters (cm), picas (pc), inches (in),
+ Didot's points (dd) and ciceros (cc)):</para>
+ <variablelist>
+ <varlistentry>
+ <term>Hsize:, Vsize:</term><listitem><para>horizontal and vertical size
of the map sheet</para></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Hoffset:, Voffset:</term><listitem><para>amount for shifting
paper</para></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Overlap:</term><listitem><para>width of an overlap to adjoining
sheets</para></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Hgrid:, Vgrid:</term><listitem><para>distances between grid
lines</para></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>HgridOffset:, VgridOffset:</term><listitem><para>shifts the whole
grid</para></listitem>
+ </varlistentry>
+ </variablelist>
+ <para>Boolean options (true is 1, false 0 or empty string):</para>
+ <variablelist>
+ <varlistentry>
+ <term>Background:</term><listitem><para>if true, background of each page
is filled gray</para></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>ExclPages:</term><listitem><para>if true, pages defined in
<option>ExclList</option>
+ are excluded from atlas</para></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>TitlePages:</term><listitem><para>if true, title pages are printed
before
+ new layer in atlas</para></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>PageNumbering:</term><listitem><para>if true, page number of the
page
+ and page numbers of adjoining pages are printed</para></listitem>
+ </varlistentry>
+ </variablelist>
+ <para>Integer options:</para>
+ <variablelist>
+ <varlistentry>
+ <term>NavRight:</term><listitem><para>number of pages to right and left
+ shown in the Navigator window</para></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>NavUp:</term><listitem><para>the same for up and down
directions</para></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>NavFactor:</term><listitem><para>scale factor main window : one
navigator
+ window</para></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>OwnPages:</term><listitem><para>number of your own pages added to
main tex file
+ before the first page of automatically generated maps
+ (necessary for correct page numbering)</para></listitem>
+ </varlistentry>
+ </variablelist>
+ <para>Integer or string options:</para>
+ <variablelist>
+ <varlistentry>
+ <term>StartX:, StartY</term><listitem><para>name of the most upper-left
sheet</para></listitem>
+ </varlistentry>
+ </variablelist>
+ <para>List options:</para>
+ <variablelist>
+ <varlistentry>
+ <term>ExclList:</term>
+ <listitem><para>pages which are omited; string may contain
+ numbers separated by comma or dash (for intervals) -- e.g.
+ 2,4-7,9,23 means, that pages 2, 4, 5, 6, 7, 9 and 23 are omited.
+ Please don't change <option>TitlePages</option> and
<option>OwnPages</option>
+ options without redefining <option>ExclList</option>. Hint: to find
+ correct numbers for pages that should be ommited,
+ set <option>ExclPages</option> false and specify correct
<option>OwnPages</option>
+ and process your file with thpdf and pdftex. Correct page
+ numbers can be read in Acrobat Reader status line.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </refsect1>
+ <refsect1>
+ <title>SEE ALSO</title>
+
+ <para>therion (1), xtherion (1), theps2pdf (1), thconvert (1).</para>
+
+ <para>For full information see the Therion Manual in
/usr/doc/therion/thbook
+ which describes &dhpackage; and its use in detail.</para>
+ </refsect1>
+ <refsect1>
+ <title>AUTHOR</title>
+
+ <para>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 <acronym>GNU</acronym> 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.</para>
+
+ </refsect1>
+</refentry>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:2
+sgml-indent-data:t
+sgml-parent-document:nil
+sgml-default-dtd-file:nil
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+-->
+
+
--- therion-0.2.9.orig/debian/mantheps2pdf.sgml
+++ therion-0.2.9/debian/mantheps2pdf.sgml
@@ -0,0 +1,166 @@
+<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [
+
+<!-- Process this file with docbook-to-man to generate an nroff manual
+ page: `docbook-to-man manpage.sgml > 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.
+
+ -->
+
+ <!ENTITY dhsurname "<surname>Wookey</surname>">
+ <!-- Please adjust the date whenever revising the manpage. -->
+ <!ENTITY dhdate "<date>December 25, 2002</date>">
+ <!ENTITY dhsection "<manvolnum>1</manvolnum>">
+ <!ENTITY dhemail "<email>address@hidden</email>">
+ <!ENTITY dhusername "Wookey">
+ <!ENTITY dhucpackage "<refentrytitle>THERION</refentrytitle>">
+ <!ENTITY dhpackage "therion">
+ <!ENTITY dhcommand "theps2pdf">
+
+ <!ENTITY debian "<productname>Debian</productname>">
+ <!ENTITY gnu "<acronym>GNU</acronym>">
+]>
+
+<refentry>
+ <refentryinfo>
+ <address>
+ &dhemail;
+ </address>
+ <author>
+ &dhsurname;
+ </author>
+ <copyright>
+ <year>2002</year>
+ <holder>&dhusername;</holder>
+ </copyright>
+ &dhdate;
+ </refentryinfo>
+ <refmeta>
+ &dhucpackage;
+
+ &dhsection;
+ </refmeta>
+ <refnamediv>
+ <refname>&dhcommand;</refname>
+
+ <refpurpose>converts therion PostScript to PDF commands</refpurpose>
+ </refnamediv>
+ <refsynopsisdiv>
+ <cmdsynopsis>
+ <command>&dhcommand;</command> <arg>dx</arg> <arg>dy</arg>
<arg>mode</arg>
+
+ </cmdsynopsis>
+ </refsynopsisdiv>
+ <refsect1>
+ <title>DESCRIPTION</title>
+
+ <para>This manual page documents
+ <command>&dhcommand;</command>, which is part of the &dhpackage;
package.</para>
+
+ <para>It was created for the &debian; distribution from
+ Martin Budaj's man-page-like HTML docs.</para>
+
+ <para><command>&dhcommand;</command> is a program that converts PostScript
commands
+ produced by MetaPost and preprocessed by thpdf to PDF. It is not intended
to be called
+ by the user - only by thpdf.</para>
+
+ <para>Input is on stdin. Output is added to
<filename>th_formdef.tex</filename> when
+ processing forms (mode = 0), otherwise <filename>pat.tmp</filename> is
(re)written.</para>
+
+
+ </refsect1>
+ <refsect1>
+ <title>ARGUMENTS</title>
+
+
+ <variablelist>
+ <varlistentry>
+ <term><option>dx</option></term>
+ <listitem>
+ <para>shift in x-axis for all co-ordinates.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>dy</option></term>
+ <listitem>
+ <para>shift in y-axis for all co-ordinates.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>mode</option></term>
+ <listitem>
+ <para>0 for forms, 1 for patterns.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </refsect1>
+
+ <refsect1>
+ <title>RESTRICTIONS</title>
+
+ <para>&dhcommand; doesn't convert arbitrary Postscript files, only MetaPost
+ output (optionally postprocessed by the <command>mpattern</command> program
for
+ pattern addition).</para>
+
+ <para>The conversion of two special cases is not yet supported:</para>
+ <itemizedlist>
+ <listitem><para>postscript <command>concat</command> operator when
applied to other
+ objects than texts</para></listitem>
+ <listitem><para>long postscript strings splitted in more
lines</para></listitem>
+ </itemizedlist>
+
+ <para>For long labels Therion uses the <command>btex...etex</command>
construction,
+ so the second case never happens. Occurence of the first case
+ depends on the definitions of map symbols; if you don't transform
+ picture variables, it should never happen.</para>
+
+ </refsect1>
+ <refsect1>
+ <title>SEE ALSO</title>
+
+ <para>therion (1), xtherion (1), thpdf (1), thconvert (1).</para>
+
+ <para>For full information see the Therion Manual in
/usr/doc/therion/thbook
+ which describes &dhpackage; and its use in detail.</para>
+ </refsect1>
+ <refsect1>
+ <title>AUTHOR</title>
+
+ <para>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 <acronym>GNU</acronym> 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.</para>
+
+ </refsect1>
+</refentry>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:2
+sgml-indent-data:t
+sgml-parent-document:nil
+sgml-default-dtd-file:nil
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+-->
+
+
--- therion-0.2.9.orig/debian/manthconvert.sgml
+++ therion-0.2.9/debian/manthconvert.sgml
@@ -0,0 +1,132 @@
+<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [
+
+<!-- Process this file with docbook-to-man to generate an nroff manual
+ page: `docbook-to-man manpage.sgml > 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.
+
+ -->
+
+ <!ENTITY dhsurname "<surname>Wookey</surname>">
+ <!-- Please adjust the date whenever revising the manpage. -->
+ <!ENTITY dhdate "<date>March 9, 2003</date>">
+ <!ENTITY dhsection "<manvolnum>1</manvolnum>">
+ <!ENTITY dhemail "<email>address@hidden</email>">
+ <!ENTITY dhusername "Wookey">
+ <!ENTITY dhucpackage "<refentrytitle>THERION</refentrytitle>">
+ <!ENTITY dhpackage "therion">
+ <!ENTITY dhcommand "thconvert">
+
+ <!ENTITY debian "<productname>Debian</productname>">
+ <!ENTITY gnu "<acronym>GNU</acronym>">
+]>
+
+<refentry>
+ <refentryinfo>
+ <address>
+ &dhemail;
+ </address>
+ <author>
+ &dhsurname;
+ </author>
+ <copyright>
+ <year>2003</year>
+ <holder>&dhusername;</holder>
+ </copyright>
+ &dhdate;
+ </refentryinfo>
+ <refmeta>
+ &dhucpackage;
+
+ &dhsection;
+ </refmeta>
+ <refnamediv>
+ <refname>&dhcommand;</refname>
+
+ <refpurpose>Therion data update conversion script</refpurpose>
+ </refnamediv>
+ <refsynopsisdiv>
+ <cmdsynopsis>
+ <command>&dhcommand;</command>
+
+
+ </cmdsynopsis>
+ </refsynopsisdiv>
+ <refsect1>
+ <title>DESCRIPTION</title>
+
+ <para>This manual page documents
+ <command>&dhcommand;</command>, which is part of the &dhpackage;
package.</para>
+
+ <para>This manual page was written for the &debian; distribution
+ because the original program does not have a manual page.</para>
+
+ <para><command>&dhcommand;</command> is a script that attempts to convert
+ from the data format used prior to &dhpackage; v0.2.6 to the data
+ format used from then on. It is written in perl.</para>
+
+ <para>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 lines changed in each file.</para>
+
+ <para>The change was to the -station, -name and -id attributes. -name is
replaced
+ by -id, and -station is replaced by -name. This change is, unfortunately,
not compatible between
+ &dhpackage; versions so data must be converted. This is expected to be the
last
+ incompatible data format change in &dhpackage;.</para>
+
+ </refsect1>
+ <refsect1>
+ <title>OPTIONS</title>
+
+ <para>&dhcommand; takes no options.</para>
+ </refsect1>
+ <refsect1>
+ <title>SEE ALSO</title>
+
+ <para>therion (1), thpdf (1), theps2pdf (1), xtherion (1).</para>
+
+ <para>For full information see the Therion Manual in
/usr/doc/therion/thbook
+ which describes &dhpackage; and its use in detail.</para>
+ </refsect1>
+ <refsect1>
+ <title>AUTHOR</title>
+
+ <para>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 <acronym>GNU</acronym> 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.</para>
+
+ </refsect1>
+</refentry>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:2
+sgml-indent-data:t
+sgml-parent-document:nil
+sgml-default-dtd-file:nil
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+-->
+
+
- [therion-users] Packaging patches for 0.2.9-1,
Wookey <=