From: hertzog <hertzog@313b444b-1b9f-4f58-a734-7bb04f332e8d>
Date: Sun, 16 Jun 2002 00:30:22 +0000 (+0000)
Subject: * Sec "Writing useful descriptions". Added a sentence about the
X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=commitdiff_plain;h=08f3cd86c06f4469770a5410be254ce30af3a06e;p=developers-reference.git

* Sec "Writing useful descriptions". Added a sentence about the
  capitalization of the first letter.


git-svn-id: svn://anonscm.debian.org/ddp/manuals/trunk/developers-reference@1717 313b444b-1b9f-4f58-a734-7bb04f332e8d
---

diff --git a/developers-reference.sgml b/developers-reference.sgml
index cb022f7..bb0340c 100644
--- a/developers-reference.sgml
+++ b/developers-reference.sgml
@@ -6,7 +6,7 @@
   <!entity % commondata  SYSTEM "common.ent" > %commondata;
 
   <!-- CVS revision of this document -->
-  <!entity cvs-rev "$Revision: 1.112 $">
+  <!entity cvs-rev "$Revision: 1.113 $">
   <!-- if you are translating this document, please notate the CVS
        revision of the developers reference here -->
   <!--
@@ -2799,11 +2799,15 @@ web site if there's any. If the package is not yet considered stable
 by the author, you may also want to warn the user that the
 package is not ready for production use.
 	    <p>
+For consistency and for an aesthetic concern, you should capitalize the
+first letter of the description.
+	    <p>
 Last but not least, since the first user impression is based on
 that description, you should be careful to avoid English
 mistakes. Ensure that you spell check it.
 <prgn>ispell</prgn> has a special option (<tt>-g</tt>) for that:
-<example>ispell -d american -g debian/control</example>
+<example>ispell -d american -g debian/control</example>.
+