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
91
92
93
94
|
From: Ole Streicher <olebole@debian.org>
Date: Wed, 15 Mar 2017 08:43:14 +0100
Subject: Clearly mark this version as Debian
---
build.xml | 6 +++---
src/docs/sun253.xml | 36 ++++++++++++++++++++++++++++++++++++
2 files changed, 39 insertions(+), 3 deletions(-)
diff --git a/build.xml b/build.xml
index 90f5b9b..85a52d3 100644
--- a/build.xml
+++ b/build.xml
@@ -482,7 +482,7 @@
<!-- Version string. -->
<echo file="${build.classes}/uk/ac/starlink/topcat/version-string"
- message="${version}"/>
+ message="${version}-debian"/>
<!-- Local third party jars, if any. Copy straight into
! distribution directories to save on unnecessary copies and to
@@ -1324,7 +1324,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="../figures/multishot-mini.png"/>
<param name="CSS_HREF" expression="sun-style.css"/>
@@ -1335,7 +1335,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="COVERIMAGE" expression="../figures/multishot-mini.png"/>
<param name="CSS_HREF" expression="sun-style.css"/>
diff --git a/src/docs/sun253.xml b/src/docs/sun253.xml
index a479e90..b9088a0 100644
--- a/src/docs/sun253.xml
+++ b/src/docs/sun253.xml
@@ -445,6 +445,10 @@ GNU General Public Licence. Its underlying table processing facilities
are provided by STIL, the Starlink Tables Infrastructure Library.
</px>
+<px><em>This document describes the Debian version of TOPCAT, which differs in a
+few properties from the original.</em>
+</px>
+
</abstract>
<sect id="intro">
@@ -569,6 +573,38 @@ see documentation of the
for more details.
</p>
+<subsect id="debian">
+<subhead><title>Debian specific changes</title></subhead>
+
+<p>This document describes the Debian version of TOPCAT, 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>Remote data access via Astrogrid (MySpace) and SRB,</li>
+<li>Image display via SOG, Diva, JSky.</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 TOPCAT
+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 TOPCAT to the Debian bug database with the
+<webref url="https://packages.debian.org/reportbug">
+<code>reportbug</code></webref> tool.
+</p>
+<p>Automated update check is disabled by default for user
+privacy. Use the Debian update mechanism to keep TOPCAT up to date.
+</p>
+</subsect>
</sect>
<sect id="quick">
|
