Package maintenance for PureOS
------------------------------

This package is maintained with git-buildpackage(1). It follows DEP-14
for branch naming (e.g. using pureos/latest for the current version
in PureOS landing).

It uses pristine-tar(1) to store enough information in git to generate
bit identical tarballs when building the package without having
downloaded an upstream tarball first.

When working with patches it is recommended to use "gbp pq import" to
import the patches, modify the source and then use "gbp pq export
--commit" to commit the modifications.

The changelog is generated using "gbp dch" so if you submit any
changes don't bother to add changelog entries but rather provide
a nice git commit message that can then end up in the changelog.

It is recommended to build the package with pbuilder using:

    gbp buildpackage --git-pbuilder

For information on how to set up a pbuilder environment see the
git-pbuilder(1) manpage. In short:

    DIST=sid git-pbuilder create
    gbp clone https://source.puri.sm/pureos/packages/vvmplayer.git
    cd vvmplayer
    gbp buildpackage --git-pbuilder

Pulling and updating the source package
---------------------------------------

PureOS is based on Debian. To pull in a new version from the Debian packaging
the following steps will be needed.

If not done already add the Debian Salsa git tree as an local remote (only
needed done once).

    git remote add salsa git@salsa.debian.org:DebianOnMobile-team/vvmplayer.git

Pull in the work from Salsa GitLab instance.

    git fetch salsa

Next simply merge in the most recent, or wanted Debian release tag.

    git merge $DEBIAN_TAG

That's it. Upon here only PureOS specific work has to be done to finish a new
package version.

 -- Carsten Schoenert <carsten.schoenert@puri.sm>  Sat, 05 Nov 2022 08:36:00 +0100
