summaryrefslogtreecommitdiffstats
path: root/tags/e/epoch-change-without-comment.tag
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-14 13:42:30 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-14 13:42:30 +0000
commit75808db17caf8b960b351e3408e74142f4c85aac (patch)
tree7989e9c09a4240248bf4658a22208a0a52d991c4 /tags/e/epoch-change-without-comment.tag
parentInitial commit. (diff)
downloadlintian-75808db17caf8b960b351e3408e74142f4c85aac.tar.xz
lintian-75808db17caf8b960b351e3408e74142f4c85aac.zip
Adding upstream version 2.117.0.upstream/2.117.0upstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'tags/e/epoch-change-without-comment.tag')
-rw-r--r--tags/e/epoch-change-without-comment.tag26
1 files changed, 26 insertions, 0 deletions
diff --git a/tags/e/epoch-change-without-comment.tag b/tags/e/epoch-change-without-comment.tag
new file mode 100644
index 0000000..b5ed4bb
--- /dev/null
+++ b/tags/e/epoch-change-without-comment.tag
@@ -0,0 +1,26 @@
+Tag: epoch-change-without-comment
+Severity: warning
+Check: debian/changelog
+Explanation: The previous version of this package had a different version epoch
+ (eg. 2:1.0-1) to the current version but there's no reference to this in
+ the changelog entry.
+ .
+ Epochs exist to cope with changes to the upstream version numbering
+ scheme. Whilst they are a powerful tool, increasing or adding an epoch
+ has many downsides including causing issues with versioned dependencies,
+ being misleading to users and being aesthetically unappealing. Whilst
+ they should be avoided, valid reasons to add or increment the epoch
+ include:
+ .
+ - Upstream changed their versioning scheme in a way that makes the
+ latest version lower than the previous one.
+ - You need to permanently revert to a lower upstream version.
+ .
+ Temporary revertions (eg. after an NMU) should use not modify or
+ introduce an epoch - please use the <code>CURRENT+reallyFORMER</code> until
+ you can upload the latest version again.
+ .
+ If you are unsure whether you need to increase the epoch for a package,
+ please consult the debian-devel mailing list.
+ .
+ Lintian looks in this version's changelog entry for the phrase "epoch".