From 8e2e5f288336c344e0362c22a02ed3dc80b7b03c Mon Sep 17 00:00:00 2001 From: TFA-N Date: Thu, 26 May 2022 10:00:11 +0200 Subject: [PATCH] Clarify and expand Debian Package build instructions --- README | 4 ++++ README.debian | 14 +++++++++++++- 2 files changed, 17 insertions(+), 1 deletion(-) diff --git a/README b/README index 2954eebe74..552c9c6ec4 100644 --- a/README +++ b/README @@ -74,6 +74,10 @@ python/examples. There is an experimental Java library which can be built by running configure with --enable-java-libs. +## Build it yourself + +There are some instructions on how to build Debian packages in the [README.debian](README.debian) + ## Credits The AUTHORS files contains a list of code contributors. A [full list of diff --git a/README.debian b/README.debian index 131c6a5dad..0af2599926 100644 --- a/README.debian +++ b/README.debian @@ -22,6 +22,17 @@ If autoreconf reports missing things, you can add the -i option. Running configure might report missing utilities and libraries. You can install these with apt-get. +You should not run debuild as root, as it will fail tests. You can disable testing by editing `debian/rules` and adding +``` +override_dh_auto_configure: + dh_auto_configure -- --disable-unittests +``` + +If you are not a package maintainer, it is recommend to disable package signing and linting: +`debuild --no-lintian -us -uc` +On newer debuild releases (Ubuntu 22.04+) you might also want to add `--no-tgz-check`. +Otherwise you can rename `ola-0.X.Y.tar.gz` to `ola_0.X.Y.orig.tar.gz` to satisfy debuild requirements. + The list below is probably not complete. Some of the package-names may differ between Debian and Debian-like distributions. Adjust as necessary. @@ -30,7 +41,8 @@ $ sudo apt-get install libcppunit-dev libcppunit-1.13-0 uuid-dev pkg-config \ libncurses5-dev libtool autoconf automake g++ libmicrohttpd-dev \ libmicrohttpd10 protobuf-compiler libprotobuf-lite10 python-protobuf \ libprotobuf-dev libprotoc-dev zlib1g-dev bison flex make libftdi-dev \ - libftdi1 libusb-1.0-0-dev liblo-dev libavahi-client-dev python-numpy + libftdi1 libusb-1.0-0-dev liblo-dev libavahi-client-dev python-numpy \ + bash-completion dh-autoreconf debhelper devscripts Note: Some distributions may offer older or newer versions of packages. For example, libprotobuf-lite6 or libprotobuf-lite7 instead of libprotobuf-lite8.