path: root/debian/README.Debian

config-links for Debian
----------------------

There's a Vagrantfile to make maintenance easier.  To start, use `vagrant up`,
then `vagrant ssh`.  The project will be in /vagrant; kill the VM using
`vagrant destroy -f` when you're done.

There're a bunch of useful one-liners in Makefile.  Everything is built in
debian/build-area/.

  * Merge the new version to the debian branch:

      git merge TAG

  * Add a changelog entry (you'll need to fix the version manually):

      make dch

  * To test, make a source package:

      make src
      make src/test  # Ignores uncommitted changes.

  * To test, make a binary package:

      make bin
      make bin/test  # Ignores uncommmited changes.

  * Commit the changes:

      git add changelog
      make commit
      make tag

  * You can push the changes to GitHub now, and it should take care of the
    rest.  Otherwise, you can upload the package to Launchpad manually as
    described below.

  * Upload the source package to the PPA:

      make upload

    To make the package available for different Ubuntu distributions, copy the
    package binaries on Launchpad.  I dread the day when this becomes
    impossible.

  * Make a binary package using pbuilder (useful for testing that the package
    builds on a particular distribution):

      make DIST=focal dist/create
      make DIST=focal dist/update
      make DIST=focal dist
      make DIST=focal dist/test  # Ignores uncommitted changes.

 -- Egor Tensin <Egor.Tensin@gmail.com>  Wed, 28 Apr 2021 21:14:04 +0000