1 files changed, 54 insertions, 0 deletions
diff --git a/debian/README.Debian b/debian/README.Debian
new file mode 100644
index 0000000..1f259f7
--- /dev/null
+++ b/debian/README.Debian
@@ -0,0 +1,54 @@
+config-links for Debian
+----------------------
+
+There's a Vagrantfile to make maintenance easier.  To start, use `vagrant up`,
+then `vagrant ssh`.
+
+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/create DIST=focal
+      make dist/update DIST=focal
+      make dist        DIST=focal
+      make dist/test   DIST=focal  # Ignores uncommitted changes.
+
+ -- Egor Tensin <Egor.Tensin@gmail.com>  Wed, 28 Apr 2021 21:14:04 +0000