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 95658e4..106412b 100644
--- a/build.xml
+++ b/build.xml
@@ -484,7 +484,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
@@ -1367,7 +1367,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"/>
@@ -1378,7 +1378,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 42c1f06..f34e510 100644
--- a/src/docs/sun256.xml
+++ b/src/docs/sun256.xml
@@ -224,6 +224,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>
@@ -359,6 +363,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">