chiark / gitweb /
added a link to the policy, and explained the current practice in the synopsis sectio...
authorjoy <joy@313b444b-1b9f-4f58-a734-7bb04f332e8d>
Sat, 15 Feb 2003 12:03:51 +0000 (12:03 +0000)
committerjoy <joy@313b444b-1b9f-4f58-a734-7bb04f332e8d>
Sat, 15 Feb 2003 12:03:51 +0000 (12:03 +0000)
git-svn-id: svn://anonscm.debian.org/ddp/manuals/trunk/developers-reference@2157 313b444b-1b9f-4f58-a734-7bb04f332e8d

debian/changelog
developers-reference.sgml

index a7a69fb3ac90549cdc6d7c71d620c9d92c44b7fd..3cbeb0863398d81bc720308358d883c4376d2bbe 100644 (file)
@@ -14,6 +14,8 @@ developers-reference (3.3) unstable; urgency=low
       kindly provided by Daniel Kobras, closes: #166388.
     - described debdiff and dpkg-depcheck, and linked to them from the
       right places in the document, closes: #172897.
+    - describe the current practice in writing synopsis lines,
+      closes: #174161.
   * Adam Di Carlo:
     - update (c) year
     - convert to debhelper (compat mode 4); maintainer scripts no longer
index 07cc7af3b37b9c351e465de252049262df5896bc..6081314d48e92d371348b2644849ac6ad0201261 100644 (file)
@@ -6,7 +6,7 @@
   <!entity % commondata  SYSTEM "common.ent" > %commondata;
 
   <!-- CVS revision of this document -->
-  <!entity cvs-rev "$Revision: 1.173 $">
+  <!entity cvs-rev "$Revision: 1.174 $">
   <!-- if you are translating this document, please notate the CVS
        revision of the developers reference here -->
   <!--
@@ -3140,9 +3140,15 @@ to the user about a package before they install it.  It should provide
 all the required information to let the user decide whether to install
 the package.
            <p>
-For consistency and aesthetics, you should capitalize the first letter
-of the Synopsis.  Don't put a full stop (period) at the end.  The
-description itself should consist of full sentences.
+The following practices supplement the <url name="Policy on the descriptions
+of packages" id="&url-debian-policy;ch-miscellaneous.html#s-descriptions">.
+           <p>
+The synopsis line (the short description) should primarily be concise.
+You may capitalize the first letter for aesthetics. It is customary to
+make the synopsis an appositive clause (not a full sentence) in which
+case there's no need to put a full stop (period) at the end.
+           <p>
+The long description should, however, always consist of full sentences.
            <p>
 Since the first user impression is based on the description, be
 careful to avoid spelling and grammar mistakes. Ensure that you