lintian: r388 - in trunk: checks debian

[marc@marcbrockschmidt.de]

Author: he
Date: 2004-12-23 23:29:51 +0100 (Thu, 23 Dec 2004)
New Revision: 388

Modified:
   trunk/checks/description
   trunk/checks/description.desc
   trunk/debian/changelog
Log:
* checks/description
  + [HE] Warn if the short description start with an article or a capital
    letter. Patch by Tobias Toedter <t.toedter@gmx.net>, thanks. (Closes:
    #258824)

Also: Ident my changelog entries properly.



Modified: trunk/checks/description
===================================================================
--- trunk/checks/description	2004-12-21 11:39:11 UTC (rev 387)
+++ trunk/checks/description	2004-12-23 22:29:51 UTC (rev 388)
@@ -59,6 +59,12 @@
     if ($synopsis =~ m/\.\s*$/) {
 	tag "description-synopsis-might-not-be-phrased-properly", "";
     }
+    if ($synopsis =~ m/^\s*[A-Z]/) {
+	print "W: $pkg $type: description-synopsis-starts-with-a-capital-letter\n";
+    }
+    if ($synopsis =~ m/^\s*([Tt]he|[Aa]n?)\b/) {
+	print "W: $pkg $type: description-synopsis-starts-with-an-article\n";
+    }
     if ($synopsis =~ m/\t/) {
 	tag "description-contains-tabs", "" unless $tabs++;
     }

Modified: trunk/checks/description.desc
===================================================================
--- trunk/checks/description.desc	2004-12-21 11:39:11 UTC (rev 387)
+++ trunk/checks/description.desc	2004-12-23 22:29:51 UTC (rev 388)
@@ -89,6 +89,21 @@
  field.
 Ref: policy 3.4.1
 
+Tag: description-synopsis-starts-with-a-capital-letter
+Type: warning
+Info: The synopsis (first line in the package "Description:" field, the
+ short description) starts with a letter in uppercase. It is recommended
+ to use lowercase instead.
+Ref: devref 6.2.2
+
+Tag: description-synopsis-starts-with-an-article
+Type: warning
+Info: The synopsis (first line in the package "Description:" field, the
+ short description) starts with an article, either definite ("the") or
+ indefinite ("a" or "an"). It is recommended to use a synopsis without
+ the article instead.
+Ref: devref 6.2.2
+
 Tag: description-synopsis-is-duplicated
 Type: error
 Info: The first line of the extended Description: should not repeat the

Modified: trunk/debian/changelog
===================================================================
--- trunk/debian/changelog	2004-12-21 11:39:11 UTC (rev 387)
+++ trunk/debian/changelog	2004-12-23 22:29:51 UTC (rev 388)
@@ -2,14 +2,18 @@
 
   The "i'm really bad with names, you know" unrelease 
 
+  * checks/description
+    + [HE] Warn if the short description start with an article or a capital
+      letter. Patch by Tobias Toedter <t.toedter@gmx.net>, thanks. (Closes:
+      #258824)
   * checks/manpages:
     + [HE] Don't compare the manpage filename extension and the content of
-    .TH case-sensitive. Report + patch by Jay Berkenbilt <ejb@ql.org>,
-    thanks. (Closes: #285335)
+      .TH case-sensitive. Report + patch by Jay Berkenbilt <ejb@ql.org>,
+      thanks. (Closes: #285335)
   * checks/md5sums: 
     + [HE] Strip off ./ at the beginning of the filenames in md5sums
-    files (this seems to happen on some systems, though we don't know
-    how). (Closes: #284728)
+      files (this seems to happen on some systems, though we don't know
+      how). (Closes: #284728)
   * checks/standards-version:
     + [CW] By definition, udebs aren't required to conform to policy, so
       don't issue no-standards-version-field for them. (If they happen to