== Updating to a new upstream release ==

Upstream releases contain a number of minified javascript files. Such files do
not qualify as source code in the sense of the DFSG because their format is not
the preferred one for making modifications. Therefore, proper sources have to
be added before bumping the upstream version.

The required non-minified javascript files are stored in the 'missing-sources'
branch of the package's git repository on salsa.debian.org. The content of this
branch is structured as an overlay for the upstream tarballs, which adds the
missing source files into 'src' sub-directories.

After updating the missing-sources, the orig tarball is generated by calling
the get-orig-source target in debian/rules. That leaves us with the following
procedure for an upstream version bump:

* bump the version in debian/changelog to the new upstream release.
* add/update/refresh any missing source files in the missing-sources branch to
  match the new upstream release and push that branch.
* generate the orig tarball by calling the get-orig-source target from the
  root of the package's git repository: ./debian/rules get-orig-source
* import the generated orig tarball:
  gbp import-orig ../sabnzbdplus_X.X.X+dfsg.orig.tar.gz --pristine-tar
* once the new upstream version made its way into the archive, also tag the
  missing-sources branch.
