aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorDaniel Gröber <dxld@darkboxed.org>2021-03-07 23:52:59 +0100
committerBozhidar Batsov <bozhidar.batsov@gmail.com>2021-05-24 15:45:18 +0300
commit9923c3f0176dc9f0e8579ceedd06148ecdacefe2 (patch)
treee319e5105b55c831eccdb7ecd6cc730bced8c025 /doc
parent96d187be5c56dc5c157de3289b26cafce771b7b4 (diff)
Add project detection for Debian packaging directories
This adds project detection for unpacked Debian source packages. We detect this by checking for the presence of a debian/control file even though technically we should probably check for all of debian/{rules,contro,changelog}. I found documenting this too cumbersome so I went with just the control file. In Debian there's two main (lightweight) ways of building packages: dpkg-buildpackage and debuild. The latter is pretty much just a wrapper for the former that also runs static checks across the resulting package. Developers usually use debuild so that's what we use here. The -uc -us options we hardcode are extremely common. They disable codesigning which you'd usually not want to do for a simple developmnet build since it can always be done using debsign before uploading the package. Since tests usually run as part of the Debian package build and there isn't a unified way to run just the tests we don't add a :test command. Technically there's autopkgtest for running special 'as installed' tests after the package build, but this requires setting up some virtualisation drivers beforehand so it doesn't make much sense here either.
Diffstat (limited to 'doc')
-rw-r--r--doc/modules/ROOT/pages/projects.adoc3
1 files changed, 3 insertions, 0 deletions
diff --git a/doc/modules/ROOT/pages/projects.adoc b/doc/modules/ROOT/pages/projects.adoc
index db6d9c2..9901f44 100644
--- a/doc/modules/ROOT/pages/projects.adoc
+++ b/doc/modules/ROOT/pages/projects.adoc
@@ -126,6 +126,9 @@ are the configuration files of various build tools. Out of the box the following
| WORKSPACE
| Bazel workspace file
+
+| debian/control
+| Debian package dpkg control file
|===
There's also Projectile's own `.projectile` which serves both as a project marker