diff options
author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-13 21:12:02 +0000 |
---|---|---|
committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-13 21:12:02 +0000 |
commit | 77e50caaf2ef81cd91075cf836fed0e75718ffb4 (patch) | |
tree | 53b7b411290b63192fc9e924a3b6b65cdf67e9d0 /debian/README.source | |
parent | Adding upstream version 1.8.3. (diff) | |
download | dnsdist-77e50caaf2ef81cd91075cf836fed0e75718ffb4.tar.xz dnsdist-77e50caaf2ef81cd91075cf836fed0e75718ffb4.zip |
Adding debian version 1.8.3-2.debian/1.8.3-2
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to '')
-rw-r--r-- | debian/README.source | 71 |
1 files changed, 71 insertions, 0 deletions
diff --git a/debian/README.source b/debian/README.source new file mode 100644 index 0000000..1272bc5 --- /dev/null +++ b/debian/README.source @@ -0,0 +1,71 @@ +Architecture restriction +------------------------ + +All binary packages have an Architecture: list set. This is done because dnsdist +requires 64bit time_t support, and only 64bit archs have this in Debian, at +the time of writing (*). + +A better way of restricting package builds to such architectures would be +very welcome. + +* Tue, 01 Nov 2022 14:23:48 +0000 + + +Building from source +-------------------- +Install "git-buildpackage" and run the following steps: + + gbp clone https://salsa.debian.org/dns-team/dnsdist.git + cd dnsdist + gbp buildpackage + +We recommend you use sbuild to make sure you build in a clean environment. +Example call: + + gbp buildpackage --git-builder='sbuild -d unstable -j8' + +Changelog +--------- +This package uses gbp dch for automatically generating debian/changelog entries +from the corresponding git commits. This makes cherry-picking, merging, and +rebasing much simpler. + +Thus, for any packaging change *do not* modify debian/changelog. Just write a +meaningful git commit message with proper bug references (ex: "Closes: #12345" +on the last line). For doing a release, run + + gbp dch --auto --release + +then beautify the generated debian/changelog and commit it. + +Patch handling +-------------- +This package uses gbp pq for maintaining patches with a git-like workflow in a +"patch-queue/<branch>" local branch and then exporting them as quilt series. +For working on patches you run + + gbp pq import --force + +Then you are in the patch-queue branch and can git log, commit, cherry-pick +upstream commits, rebase, etc. there. After you are done, run + + gbp pq export + +which will put you back into master and update debian/patches/ (including +series). You need to git add etc. new patches, possibly other +packaging changes, and then git commit as usual. + +This package tends to have few patches, so all of them go into the default +series. + +Synchronized packaging with upstream +------------------------------------ +Upstream ships Debian and Ubuntu packages aligned with Debian's packaging +at https://repo.powerdns.com/. Packaging sources for those can be found at +https://github.com/PowerDNS/pdns/tree/master/builder-support/debian . + +While there are some minor differences, the general goal is to stay aligned. +Recently, we have tried to align the used Lua versions too. + +-- +(This document is based off Debian's systemd README.source. Thank you!) |