[SCM] Debian package checker branch, master, updated. 2.2.17-29-g600fa8d

["Russ Allbery" <rra@debian.org>]

The following commit has been merged in the master branch:
commit 600fa8db14835b1c249c70508284086860f30038
Author: Russ Allbery <rra@debian.org>
Date:   Thu Nov 12 15:16:54 2009 -0800

    Man page improvements
    
    * man/lintian.1:
      + [RA] Add additional explanation of experimental tags.  Remove the
        comment that pedantic tags are frequently wrong; that's not what
        they're for.  Improve the explanation for -i to not imply that
        everything Lintian finds is a Policy violation.

diff --git a/debian/changelog b/debian/changelog
index a46f427..5e81b72 100755
--- a/debian/changelog
+++ b/debian/changelog
@@ -77,6 +77,12 @@ lintian (2.2.18) UNRELEASED; urgency=low
   * data/files/fonts:
     + [ADB] Refresh against unstable.
 
+  * man/lintian.1:
+    + [RA] Add additional explanation of experimental tags.  Remove the
+      comment that pedantic tags are frequently wrong; that's not what
+      they're for.  Improve the explanation for -i to not imply that
+      everything Lintian finds is a Policy violation.
+
   * private/refresh-perl-provides:
     + [ADB] Special-case libio-compress-perl; the package contains the
       modules which used to be in libio-compress-* but does not contain
diff --git a/man/lintian.1 b/man/lintian.1
index 70f04a1..68d8040 100644
--- a/man/lintian.1
+++ b/man/lintian.1
@@ -154,9 +154,9 @@ Behaviour options for
 
 .TP
 .BR \-i ", " \-\-info
-Print explanatory information about discovered policy violations in
-addition to the lintian error tags. To print a long tag description
-without running lintian, see
+Print explanatory information about each problem discovered in addition to
+the lintian error tags. To print a long tag description without running
+lintian, see
 .BR lintian\-info (1).
 
 .TP
@@ -169,15 +169,21 @@ Display informational ("I:") tags as well.  They are normally suppressed.
 .BR \-E ", " \-\-display\-experimental
 Display experimental ("X:") tags as well.  They are normally suppressed.
 
+If a tag is marked experimental, this means that the code that generates
+this message is not as well tested as the rest of Lintian, and might still
+give surprising results.  Feel free to ignore Experimental messages that
+do not seem to make sense, though of course bug reports are always
+welcomed (particularly if they include fixes).
+
 .TP
 .BR \-\-pedantic
 Display pedantic ("P:") tags as well.  They are normally suppressed.
 
 Pedantic tags are Lintian at its most pickiest and include checks for
-particular Debian packaging styles, checks that are very frequently wrong,
-and checks that many people disagree with.  Expect false positives and
-Lintian tags that you don't consider useful if you use this option.
-Adding overrides for pedantic tags is probably not worth the effort.
+particular Debian packaging styles and checks that many people disagree
+with.  Expect false positives and Lintian tags that you don't consider
+useful if you use this option.  Adding overrides for pedantic tags is
+probably not worth the effort.
 
 .TP
 .BR \-L " [+|-|=][>=|>|<|<=][S|C|S/C], " \-\-display\-level " [+|-|=][>=|>|<|<=][S|C|S/C]"

-- 
Debian package checker