aboutsummaryrefslogtreecommitdiff
path: root/bpkg/system-package-manager-debian.hxx
diff options
context:
space:
mode:
Diffstat (limited to 'bpkg/system-package-manager-debian.hxx')
-rw-r--r--bpkg/system-package-manager-debian.hxx10
1 files changed, 9 insertions, 1 deletions
diff --git a/bpkg/system-package-manager-debian.hxx b/bpkg/system-package-manager-debian.hxx
index 7f91d38..cbf4828 100644
--- a/bpkg/system-package-manager-debian.hxx
+++ b/bpkg/system-package-manager-debian.hxx
@@ -57,7 +57,8 @@ namespace bpkg
// -common packages. They normally have the same version.
//
// The first group is called the main group and the first package in the
- // group is called the main package.
+ // group is called the main package. Note that all the groups are consumed
+ // (installed) but only the main group is produced (packaged).
//
// We allow/recommend specifying the -dev package instead of the main
// package for libraries (the name starts with lib), seeing that we are
@@ -71,6 +72,13 @@ namespace bpkg
// as extras but in the future we may decide to sort them out like the main
// group (see parse_name_value() for details).
//
+ // The Debian package version has the [<epoch>:]<upstream>[-<revision>] form
+ // (see deb-version(5) for details). If no explicit mapping to bpkg version
+ // is specified with the debian-to-downstream-version manifest values (or
+ // alike), then we fallback to using the <upstream> part as bpkg version. If
+ // explicit mapping is specified, then we match it against the
+ // <epoch>:<upstream> parts ignoring <revision>.
+ //
struct system_package_status_debian: system_package_status
{
string main;