[lintian] 01/01: checks/changelog-file.desc: Update text for epoch-change-without-comment, making it much clearer for skim-readers to not use epochs for reverts.

[Chris Lamb <chris@chris-lamb.co.uk>]

This is an automated email from the git hooks/post-receive script.

lamby pushed a commit to branch master
in repository lintian.

commit f0c2a8a95fa95d581e9d35a045e0316d9d32dca7
Author: Chris Lamb <lamby@debian.org>
Date:   Thu Feb 8 08:45:56 2018 +0000

    checks/changelog-file.desc: Update text for epoch-change-without-comment, making it much clearer for skim-readers to not use epochs for reverts.
---
 checks/changelog-file.desc | 15 +++++++++------
 1 file changed, 9 insertions(+), 6 deletions(-)

diff --git a/checks/changelog-file.desc b/checks/changelog-file.desc
index 6fd4f92..9843234 100644
--- a/checks/changelog-file.desc
+++ b/checks/changelog-file.desc
@@ -430,15 +430,18 @@ Info: The previous version of this package had a different version epoch
  .
  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 being misleading to users and being
- aesthetically unappealing. Whilst they should be avoided, valid reasons
- to add or increment the epoch include:
+ 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 should use <tt>CURRENT+reallyFORMER</tt> until you can
-    upload the latest version again.
+  - 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 <tt>CURRENT+reallyFORMER</tt> 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.

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/lintian/lintian.git