Upstream source archives
========================

Upstream versioning
-------------------

The upstream versioning format changed slightly, in order
to improve compatibility with Maven.

Mark Taylor kindly explained the background by email on 16 June 2016:

  I changed the versioning scheme when lobbied to do so by a Maven
  enthusiast (Paul Harrison), since it's apparently problematic to
  have minus signs for use in maven-friendly repositories,
  or something.  So I plan to use x.y.z from now on."

For clarity, this means that the versions appear as follows:

  Until JSAMP version '1.3-4' upstream used a hyphen.
  After JSAMP version '1.3.5' upstream uses a dot. 

Upstream Git
------------

Repo:

  https://github.com/mbtaylor/jsamp

Upstream version tags:

  jsamp-x.x.x


Previous .tar.gz
================

Location
--------

The source archives can be found at
http://software.astrogrid.org/p/jsamp/x.x-x/downloads.html
and
http://www.astrogrid.org/maven/org.astrogrid/jars/ .
To use a simpler watch file syntax, we currently fetch the source
archives from the second URL.

As of 2016, the version from the astrogrid pages was newer than
the Maven copy.

Resorting
---------

For our Debian package, we resorted the original zip archive into a
versioned tarball ("jsamp_<upstreamVersion>.orig.tar.gz").

Resorting is done automatically by the script "debian/orig-tar.sh"
which is called by "uscan".

File Stripping
--------------

The script "debian/orig-tar.sh" also removes the sub-directory
"src/java/org/astrogrid/samp/xmlrpc/apache". This is done in
consultation with upstream lying on the fact that there is an "xmlrpc"
implementation internal to JSAMP in the package, and that Apache-XMLRPC
was only added to the source for test purposes.
