General maintenance
===================

This package is maintained in Git at https://salsa.debian.org/roundcube-team/roundcube.git
and uses the "3.0 (quilt)" source format.

Import a new upstream release
=============================

Since 1.4.10+dfsg.2-1 we use cryptographically signed Git release tags
as basis for the Debian package.

To import a new upstream release into our packaging repository, do the
following:

    0. Ensure that you have the Roundcube upstream Git repository
       available as a remote in the Git repository where you're doing
       the packaging work:

        $ git remote add upstream https://github.com/roundcube/roundcubemail.git

    1. Merge the newest upstream release tag into the 'debian/latest'
       branch of your packaging repository:

        $ UPSTREAM_VERSION=1.6.0
        $ gbp import-orig --uscan --upstream-version=$UPSTREAM_VERSION+dfsg \
            --upstream-vcs-tag=$UPSTREAM_VERSION

       That commands does all the magic, namely
       - updating the `upstream` remote,
       - downloading the tinymce dependencies as secondary tarballs,
       - verifying the cryptographic signature on the upstream release tag,
       - creating a new tag 'upstream/$VERSION' with '$UPSTREAM_VERSION'
         as additional parent, and
       - merging 'upstream/$VERSION' into 'debian/latest'

       We use --upstream-version and --upstream-vcs-tag since it doesn't
       trim the +dfsg repack suffix, see https://bugs.debian.org/1009163 .

    2. Optionally, move upstream tarballs and detached signatures to the
       build area:

        $ mv -vt "$XDG_CACHE_HOME/build-area" ../roundcube[-_]"$UPSTREAM_VERSION"*.tar.*

       This step is needed when gbp.conf(5) sets a non-default export-dir, see
       https://bugs.debian.org/638993 .

    3. Update debian/sql with the upstream schema migrations (the
       command is a no-op if there are none):

        $ ./debian/sqlupdate

    4. Refresh patches:

        $ gbp pq rebase
        $ gbp pq export
        $ git add -p -- debian/patches
        $ git commit -m "Refresh patches." -- debian/patches

    5. Bump upstream version in debian/changelog:

        $ gbp dch --commit
 
    6. Build the package:

        $ gbp buildpackage

    7. Make sure all upstream files are included in one of the newly
       built .deb:

        $ ./debian/origtargz-diff.sh

Upload a new version to the Debian archive
==========================================

    0. Set distribution in debian/changelog:

        $ gbp dch --release --commit

    1. Push to salsa and wait for CI to pass:

        $ git push

    2. Build binary packages and tag:

        $ gbp buildpackage --git-tag

    3. Push the tag to salsa:

        $ git push

    4. Upload the source-only package to the archive:

        $ dput /path/to/export-dir/roundcube_${VERSION}_source.changes

 -- Guilhem Moulin <guilhem@debian.org>  Sun, 26 Jun 2022 15:06:39 +0200
