diff options
Diffstat (limited to 'docs/chapters/import.sgml')
-rw-r--r-- | docs/chapters/import.sgml | 9 |
1 files changed, 9 insertions, 0 deletions
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. <replaceable>%(version%-%\%)s</replaceable> will replace <replaceable>-</replaceable> with <replaceable>%</replaceable>, transforming <replaceable>1-A.B.C</replaceable> to <replaceable>1%A.B.C</replaceable>. Only a single replacement is supported and it can only replace a single character. + <warning> + <para> + Since some of the possible mangling characters + like <replaceable>_</replaceable> and <replaceable>%</replaceable> 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. + </para> + </warning> </para> <para>If you're using &pristine-tar;, you can make &gbp-buildpackage; commit the generated tarball back to the |