Skip to content

Draft: Document the unconventional source layout

Andrej Shadura requested to merge document-source-layout into apertis/v2025dev3

This package deviates from the Debian convention of native packages strictly using native package versions (without the Debian revision suffix) for practical reasons described in the Debian bug #684431. Since gbp does not support this workflow directly, it needs to be tricked into accepting it by having the same content on both upstream/* and debian/* branches just as if it were a non-native package.

Since native packages don’t have orig tarballs, but the non-native package version suggests there should be, the Debian tarball is used as one, but renamed accordingly, e.g. python3-defaults_3.9.2-2.tar.gz to python3-defaults_3.9.2.tar.gz.

When importing new versions, only import the new "upstream" versions (incrementing the version before dash) to upstream/* branches, while incremental updates (with changes in the Debian revision only) should go to debian/* only.

The package uses 1.0 format, so any new changes to the package with the same "upstream" version can be represented in the Debian diff, even if they touch files outside of debian/.

This merge request documents this situation directly in the source package.

Merge request reports

Loading