Bug#990822: debian-policy: Please document version scheme for derivatives
Package: debian-policy
Version: 4.5.1.0
Severity: wishlist
Hi,
Paragraph 5.6.12. Version describes the version parts epoch,
upstream_version, and debian_revision. But it does not describe how to
use the Debian revision in Debian itself and in derivatives like Ubuntu.
To make packages in derivatives work seamlessly with Debian, I propose
following scheme (which is used in Ubuntu, in-house, and by me
personally):
The derivative selects a name for using in the debian_revision (e.g.
Ubuntu uses "ubuntu", we use "ionos" in-house, and I use "bd" for
personal builds). Then following rules apply:
* no change in the package version when using the source package
unmodified (e.g. 1.2-3)
* Add <derivative>X to the Debian package version starting with X=1 and
incrementing X on every new upload when the source package is
modified (e.g. 1.2-3ubuntu1)
* If the upstream version is not packaged for Debian yet, use
0<derivative>X as debian_revision with X=1 and incrementing X on
every new upload (e.g. 1.3-0ubuntu1).
* If the Debian package is backported to an older derivative and needs
changes for it, add ~<derivative>X to the debian_revision (e.g.
1.2-3~bd1).
Is the Debian policy the correct place to document that?
--
Benjamin Drung
Senior DevOps Engineer and Debian & Ubuntu Developer
Compute Platform Operations
1&1 IONOS SE | Greifswalder Str. 207 | 10405 Berlin | Deutschland
E-Mail: benjamin.drung@ionos.com | Web: www.ionos.de
Hauptsitz Montabaur, Amtsgericht Montabaur, HRB 24498
Vorstand: Hüseyin Dogan, Dr. Martin Endreß, Claudia Frese, Henning
Kettler, Arthur Mai, Matthias Steinberg, Achim Weiß
Aufsichtsratsvorsitzender: Markus Kadelke
Member of United Internet
Reply to: