From 0b317eeb649090ab8bdd8507c189477670a91cd1 Mon Sep 17 00:00:00 2001 From: Guido Günther Date: Wed, 16 Nov 2016 14:12:24 +0100 Subject: docs: Use version mangling with care --- docs/chapters/import.sgml | 9 +++++++++ docs/common.ent | 1 + 2 files changed, 10 insertions(+) diff --git a/docs/chapters/import.sgml b/docs/chapters/import.sgml index c42279c9..a64e644f 100644 --- a/docs/chapters/import.sgml +++ b/docs/chapters/import.sgml @@ -297,6 +297,15 @@ upstream-tag = v%(version%.%_)s you have to escape it. E.g. %(version%-%\%)s will replace - with %, transforming 1-A.B.C to 1%A.B.C. Only a single replacement is supported and it can only replace a single character. + + + Since some of the possible mangling characters + like _ and % are also used to denote epochs and tilde revisions + these versions can't be reconstructed when mapping from &git; tags back to &debian; versions and will therefore break other tools + like &gbp-dch;. So use version mangling with care. It's better to come up with a Debian compatible tag format upstream, + see &dep14; for the currently used expansion rules for Debian versions. + + If you're using &pristine-tar;, you can make &gbp-buildpackage; commit the generated tarball back to the diff --git a/docs/common.ent b/docs/common.ent index a7832f91..0d118074 100644 --- a/docs/common.ent +++ b/docs/common.ent @@ -58,3 +58,4 @@ GPL"> Python format string"> + DEP-14"> \ No newline at end of file -- cgit v1.2.3