Notes for Ubuntu backporting libopenmpt

libs/libopenmpt/SRB2NOTE-DEBIAN.md

+# libopenmpt Debian backport info
+
+Backported libopenmpt 0.4.0 packages are available at ppa:stjr/srb2
+for Ubuntu Disco, Cosmic, Bionic, Xenial, and Trusty as of 2019/01/04.
+
+Debian Jessie users should use the Trusty package. Later Debian versions
+may use Disco or another working version.
+
+* libopenmpt 0.4.0 source package: http://archive.ubuntu.com/ubuntu/pool/universe/libo/libopenmpt/libopenmpt_0.4.0-1.dsc
+
+# Backporting from Disco to Cosmic and Bionic
+
+Cosmic and Bionic require no changes to the source package. They have
+the prerequisite `debhelper` and `dpkg-dev` versions, a matching
+`automake` version (1.15), as well as G++ > 5.
+
+Use the `backportpackage` script to automatically tag the package to
+Cosmic and Bionic, then upload to PPA:
+
+```
+sudo apt install ubuntu-dev-tools
+export UBUMAIL="John Doe <email@com.com>" # Name and email associated with your PGP sign key
+backportpackage -d [cosmic/bionic] -u [path-to-ppa] --key=[key-fingerprint] http://archive.ubuntu.com/ubuntu/pool/universe/libo/libopenmpt/libopenmpt_0.4.0-1.dsc
+```
+
+# Backporting from Disco to Xenial
+
+Download the package:
+
+```
+dget http://archive.ubuntu.com/ubuntu/pool/universe/libo/libopenmpt/libopenmpt_0.4.0-1.dsc
+```
+
+Xenial has an earlier `debhelper` version, but the rest of the prerequisites
+are available.
+
+The required changes (see patch `debian/libopenmpt-0.4.0-xenial-backport.diff` in this directory):
+
+* `debian/control`
+    * Add `automake` to Build-Depends
+    * Change `debhelper` version to `(>= 9.0~)`
+* `debian/compat`
+    * Change to `10`
+
+Then run these commands:
+
+```
+dch -i # Edit the changelog; make sure the Name and email match the PGP sign key and that the changelog targets xenial
+debuild -s -d -k0x[key-fingerprint] # Build the updated package
+dput [path-to-ppa] [path-to-changes-file] # Upload to PPA
+```
+
+# Backporting from Disco to Trusty
+
+Download the package:
+
+```
+dget http://archive.ubuntu.com/ubuntu/pool/universe/libo/libopenmpt/libopenmpt_0.4.0-1.dsc
+```
+
+Trusty requires more changes because it uses G++ 4.8 whereas the source
+package expects G++ >= 5. Automake is an earlier version as well --
+1.14 vs 1.15 -- so `autoreconf` needs to be run at build time.
+
+The required changes (see patch `debian/libopenmpt-0.4.0-trusty-backport.diff` in this directory):
+
+* `debian/control`
+    * Add `automake` and `libtool` to Build-Depends
+    * Change `debhelper` version to `(>= 9.0~)`
+    * Change `dpkg-dev` version to `(>= 1.17.0)`
+* `debian/compat`
+    * Change to `10`
+* `debian/rules`
+    * Under `override_dh_auto_configure`, input this line as the first command:
+      `autoreconf --force --install`
+        * This re-configures the package for Automake 1.14
+* `debian/libopenmpt-modplug1.symbols` and `debian/libopenmpt0.symbols`
+    * Delete these files
+        * The C++ ABI for G++ 4.8 is incompatible with G++ >= 5, so the
+          generated symbols will be different than the expected symbols
+          in the `*.symbols` files. Deleting these files will skip the
+          symbol check.
+
+Then run these commands:
+
+```
+dch -i # Edit the changelog; make sure the Name and email match the PGP sign key and that the changelog targets trusty
+debuild -s -d -k0x[key-fingerprint] # Build the updated package
+dput [path-to-ppa] [path-to-changes-file] # Upload to PPA
+```

libs/libopenmpt/SRB2NOTE.md

@@ -2,8 +2,8 @@
 
 Current built version as of 2019/01/03 is 0.4.0+r11103.pkg
 
-mingw binaries (.dll): `bin/[x86 or x86_64]/mingw`
-mingw import libraries (.dll.a): `lib/[x86 or x86_64]/mingw`
+* mingw binaries (.dll): `bin/[x86 or x86_64]/mingw`
+* mingw import libraries (.dll.a): `lib/[x86 or x86_64]/mingw`
 
 # Building libopenmpt with mingw-w64
 

libs/libopenmpt/debian/libopenmpt-0.4.0-xenial-backport.diff

+diff -uraN ../../orig/libopenmpt-0.4.0/debian/changelog ./debian/changelog
+--- ../../orig/libopenmpt-0.4.0/debian/changelog	2018-12-24 16:43:58.000000000 -0500
++++ ./debian/changelog	2019-01-04 16:37:08.788775423 -0500
+@@ -1,3 +1,12 @@
++libopenmpt (0.4.0-ubuntu16.04.1~ppa10) xenial; urgency=medium
++
++  * Backport to Xenial
++  * automake build depend added
++  * debhelper depend adjusted to >= 9.0~
++  * deb compat level adjusted to 10
++
++ -- Sonic Team Junior <stjr@srb2.org>  Fri, 04 Jan 2019 16:35:08 -0500
++
+ libopenmpt (0.4.0-1) unstable; urgency=medium
+ 
+   * New upstream release.
+diff -uraN ../../orig/libopenmpt-0.4.0/debian/compat ./debian/compat
+--- ../../orig/libopenmpt-0.4.0/debian/compat	2018-12-24 16:43:58.000000000 -0500
++++ ./debian/compat	2019-01-04 16:34:31.830370437 -0500
+@@ -1 +1 @@
+-11
++10
+diff -uraN ../../orig/libopenmpt-0.4.0/debian/control ./debian/control
+--- ../../orig/libopenmpt-0.4.0/debian/control	2018-12-24 16:43:58.000000000 -0500
++++ ./debian/control	2019-01-04 16:34:59.339499384 -0500
+@@ -4,7 +4,8 @@
+ Maintainer: Debian Multimedia Maintainers <debian-multimedia@lists.debian.org>
+ Uploaders: James Cowgill <jcowgill@debian.org>
+ Build-Depends:
+- debhelper (>= 11.1~),
++ automake,
++ debhelper (>= 9.0~),
+  dh-exec,
+  doxygen,
+  dpkg-dev (>= 1.18.0),
+diff -uraN ../../orig/libopenmpt-0.4.0/debian/files ./debian/files
+--- ../../orig/libopenmpt-0.4.0/debian/files	1969-12-31 19:00:00.000000000 -0500
++++ ./debian/files	2019-01-04 16:37:20.001229883 -0500
+@@ -0,0 +1 @@
++libopenmpt_0.4.0-ubuntu16.04.1~ppa10_source.buildinfo libs optional