| Ondřej Surý | 748c8e5 | 2021-05-07 18:56:31 +0200 | [diff] [blame] | 1 | This module uses gbp and upstream git repository |
| 2 | |
| 3 | To update this package, first import the changes from upstream: |
| 4 | - git fetch --all |
| 5 | |
| 6 | Find the latest version: |
| 7 | VERSION=$(git describe --tags $(git rev-list '--tags=v1*' --max-count=1) | sed 's/^v//') |
| 8 | echo $VERSION |
| 9 | |
| 10 | Update debian/sid branch |
| 11 | - git checkout debian/master |
| 12 | - git merge v$VERSION |
| 13 | |
| 14 | Update the debian/copyright file: |
| 15 | - cme update dpkg-copyright |
| 16 | See also https://github.com/dod38fr/config-model/wiki/Updating-debian-copyright-file-with-cme |
| 17 | |
| 18 | Check patches (and cleanup if necessary): |
| 19 | - gbp pq rebase --commit --drop |
| 20 | |
| 21 | Download upstream tarball: |
| 22 | - uscan --download --verbose --download-version $VERSION |
| 23 | |
| 24 | Add pristine-tar: |
| 25 | - pristine-tar commit ../libyang_$VERSION.orig.tar.gz v$VERSION |
| 26 | |
| 27 | Generate a temporary changelog: |
| 28 | - gbp dch --new-version=$VERSION-1 --snapshot --auto --commit debian/ |
| 29 | |
| 30 | Test the first build:: |
| 31 | - gbp buildpackage --git-ignore-new --git-pristine-tar --git-no-purge |
| 32 | |
| 33 | Regenerate the symbol file (See https://qt-kde-team.pages.debian.net/symbolfiles.html) |
| 34 | - pkgkde-symbolshelper batchpatch -v $VERSION < <path_to>/buildlog |
| 35 | |
| 36 | See https://www.debian.org/doc/manuals/maint-guide/advanced.en.html#librarysymbols |
| 37 | and dpkg-gensymbols man page |
| 38 | |
| 39 | Update the changelog: |
| 40 | - gbp dch -Ra -c |
| 41 | |
| 42 | Once everything is fine, build a source package and tag: |
| 43 | - gbp buildpackage -S --git-tag |
| 44 | |
| 45 | Push on salsa: |
| 46 | - gbp push |
| 47 | |
| 48 | For more details, see |
| 49 | https://honk.sigxcpu.org/projects/git-buildpackage/manual-html/gbp.import.upstream-git.html#gbp.import.upstream.git.notarball |
| 50 | |
| 51 | Maintainer Notes (moved from README.md) |
| 52 | ======================================= |
| 53 | |
| 54 | * the project version number is actually the SO ABI version. The release |
| 55 | point numbers (0.16-r3) isn't used for Debian. |
| 56 | |
| 57 | * it's intentional that the SONAME is libyang.so.0.16 and not libyang.so.0. |
| 58 | ABI compatibility is indicated by the first two numbers being equal; |
| 59 | the third number is incremented for compatible changes. cf. |
| 60 | CESNET/libyang#656 |
| 61 | |
| 62 | * the watch file doesn't work yet but the libyang people agreed to make |
| 63 | future release tags the same as the internal version number. At that point |
| 64 | the watch file will work. |
| 65 | |
| 66 | -- Ondřej Surý <Ondřej Surý <ondrej@debian.org>>, Tue, 21 Jul 2020 16:31:52 +0200 |