From 60148a76d2c75089c0c90ee55e93c6db21345734 Mon Sep 17 00:00:00 2001 From: Silvio Rhatto Date: Tue, 18 Mar 2025 13:50:15 -0300 Subject: Additional references on installation, building and testing --- docs/installation/README.md | 13 +++++++++++++ docs/packaging/building.md | 7 +++++++ docs/packaging/testing.md | 14 ++++++++++++++ mkdocs.yml | 1 + 4 files changed, 35 insertions(+) create mode 100644 docs/packaging/testing.md diff --git a/docs/installation/README.md b/docs/installation/README.md index e16162d..35243de 100644 --- a/docs/installation/README.md +++ b/docs/installation/README.md @@ -1,5 +1,18 @@ # Debian installation +## Basic + References, tips and notes about installing Debian-based systems: * [InstallingDebianOn - Debian Wiki](https://wiki.debian.org/InstallingDebianOn) + +## Minimal + +Minimal Debian installations: + +* [GitHub - debuerreotype/debuerreotype: reproducible, snapshot-based Debian rootfs builder](https://github.com/debuerreotype/debuerreotype) + +## Tuning + +* `dpkg`: + * [Save disk space by excluding useless files with dpkg](https://raphaelhertzog.com/2010/11/15/save-disk-space-by-excluding-useless-files-with-dpkg/) diff --git a/docs/packaging/building.md b/docs/packaging/building.md index e29e742..dcfa8ad 100644 --- a/docs/packaging/building.md +++ b/docs/packaging/building.md @@ -2,8 +2,15 @@ ## Standard build +With `cowbuilder`: + DIST=bookworm sudo -E cowbuilder --build $package*.dsc +With `sbuild`: + +* [sbuild - Debian Package Tracker](https://tracker.debian.org/pkg/sbuild) +* [sbuild - Debian Wiki](https://wiki.debian.org/sbuild) + ## Signing To sign both the `.dsc` and the `.changes` files: diff --git a/docs/packaging/testing.md b/docs/packaging/testing.md new file mode 100644 index 0000000..61b0625 --- /dev/null +++ b/docs/packaging/testing.md @@ -0,0 +1,14 @@ +# Testing + +## autopkgtest + +* [autopkgtest - Debian Package Tracker](https://tracker.debian.org/pkg/autopkgtest) +* [ContinuousIntegration/autopkgtest - Debian Wiki](https://wiki.debian.org/ContinuousIntegration/autopkgtest) +* [Autopkgtest - Defining tests for Debian packages](https://people.debian.org/~eriberto/README.package-tests.html) +* [autopkgtest](https://perl-team.pages.debian.net/autopkgtest.html) +* [autopkgtest — Debian LTS team documentation](https://lts-team.pages.debian.net/wiki/TestSuites/autopkgtest.html) + * [autodep8(1) — autodep8 — Debian unstable — Debian Manpages](https://manpages.debian.org/unstable/autodep8/autodep8.1.en.html) + +## piuparts + +* [piuparts(1) — piuparts 0.98 documentation](https://piuparts.debian.org/doc/html/piuparts/piuparts.1.html#cmdoption-piuparts-i) diff --git a/mkdocs.yml b/mkdocs.yml index 4b5a5bf..7415bdd 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -88,6 +88,7 @@ nav: - packaging/env.md - packaging/checking.md - packaging/building.md + - packaging/testing.md - packaging/repositories.md - packaging/cross.md - packaging/custom/python.md -- cgit v1.2.3