summaryrefslogtreecommitdiffstats
path: root/tags/e/epoch-change-without-comment.tag
blob: b5ed4bb1a9e4edc373dcb15c31d6d6025af60c7b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
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".