1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
|
From: Ole Streicher <olebole@debian.org>
Date: Wed, 15 Mar 2017 08:41:07 +0100
Subject: Clearly mark this version as Debian
---
build.xml | 6 +++---
src/docs/sun256.xml | 32 ++++++++++++++++++++++++++++++++
2 files changed, 35 insertions(+), 3 deletions(-)
diff --git a/build.xml b/build.xml
index 95bf4d9..8330b77 100644
--- a/build.xml
+++ b/build.xml
@@ -515,7 +515,7 @@
<!-- Write the package version number to a file. -->
<echo file="${build.classes}/uk/ac/starlink/ttools/stilts.version"
- message="${version}"/>
+ message="${version}-debian"/>
<!-- Local third party jars, if any. Copy straight into
! distribution directories to save on unnecessary copies and to
@@ -1452,7 +1452,7 @@
<xslt in="${build.docs}/${user.doc}.xml"
out="${build.docs}/${user.doc}/${user.doc}.html"
style="${xdoc.etc}/toHTML1.xslt">
- <param name="VERSION" expression="${version}"/>
+ <param name="VERSION" expression="${version}-debian"/>
<param name="BASEDIR" expression="${build.docs}/${user.doc}"/>
<param name="COVERIMAGE" expression="${coverimage}"/>
<param name="CSS_HREF" expression="sun-style.css"/>
@@ -1500,7 +1500,7 @@
out="${build.docs}/${user.doc}/${user.doc}.2.html"
classpath="/usr/share/java/Saxon-HE.jar"
style="${xdoc.etc}/toHTML.xslt">
- <param name="VERSION" expression="${version}"/>
+ <param name="VERSION" expression="${version}-debian"/>
<param name="BASEDIR" expression="${build.docs}/${user.doc}"/>
<param name="FIGDIR" expression="${build.docs}/${user.doc}"/>
<param name="COVERIMAGE" expression="${coverimage}"/>
diff --git a/src/docs/sun256.xml b/src/docs/sun256.xml
index 52b7abf..39801e7 100644
--- a/src/docs/sun256.xml
+++ b/src/docs/sun256.xml
@@ -245,6 +245,10 @@ detailed on-line help is available from the tools themselves.
under the GNU Lesser General Public License (LGPL).
</px>
+<px><em>This document describes the Debian version of STILTS, which differs in a
+few properties from the original.</em>
+</px>
+
</abstract>
<sect>
@@ -386,6 +390,34 @@ here are a few possibilities:
</dl>
</p>
+<subsect id="debian">
+<subhead><title>Debian specific changes</title></subhead>
+
+<p>This document describes the Debian version of STILTS, which differs
+in a few properties from the original. Some rarely used or non-free
+support modules were removed:
+<ul>
+<li>HTM (non-free library),</li>
+<li>PLASTIC (outdated and superceded by SAMP),</li>
+<li>Data structures and formats: HDS, HDX, NDX, GBIN, and Mirage,</li>
+<li>STILTS server.</li>
+</ul>
+</p>
+<p>Please file a bug report if you think that some of this support shall
+be brought back.
+</p>
+<p>Also, the Debian version of topcat uses external libraries which
+are different from the libraries shipped with the original STILTS
+distribution, with the fits Java library (<code>nom.tam.fits</code>;
+Debian package <webref url="https://packages.debian.org/libfits-java">
+<code>libfits-java</code></webref>)
+as the most important one. This may trigger bugs that do not appear in
+the original version. Please report problems with the Debian version
+of STILTS to the Debian bug database with the
+<webref url="https://packages.debian.org/reportbug">
+<code>reportbug</code></webref> tool.
+</p>
+</subsect>
</sect>
<sect id="stilts-cmd">
|
