From: tomo <tomo>
Date: Sat, 1 Nov 2003 10:32:56 +0000 (+0000)
Subject: 21.4.14 "Reasonable Discussion".
X-Git-Tag: r21-4-14~1^4
X-Git-Url: http://git.chise.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=0c4e0f9629e1f9947bb743da518d3ec62e698707;p=chise%2Fxemacs-chise.git

21.4.14 "Reasonable Discussion".
---

diff --git a/man/lispref/packaging.texi b/man/lispref/packaging.texi
index f682baa..fec092c 100644
--- a/man/lispref/packaging.texi
+++ b/man/lispref/packaging.texi
@@ -747,7 +747,7 @@ infrastructure.
    priority high
    category CATEGORY                ; Makefile
    dump nil
-   description "description"        ; a one-line description string
+   description "DESCRIPTION"        ; a one-line period-terminated string
    filename FILENAME                ; obsolete
    md5sum MD5SUM                    ; generated
    size SIZE                        ; generated
@@ -761,11 +761,13 @@ infrastructure.
 @end example
 
 You should replace NAME, DISTRIBUTION, DESCRIPTION, and FEATURE ... with
-appropriate values, according to the comments.  Fields marked as
-@samp{obsolete} can be ignored.  Fields marked as @samp{generated} are
-generated by the package construction process, and will be filled in
-automatically.  Fields marked as @samp{Makefile} should be set as
-variables in the @file{Makefile}.
+appropriate values, according to the comments.  As a matter of style,
+the first letter of the description should be capitalized, and the
+string should end with a period.  It need not be a complete sentence
+grammatically.  Fields marked as @samp{obsolete} can be ignored.  Fields
+marked as @samp{generated} are generated by the package construction
+process, and will be filled in automatically.  Fields marked as
+@samp{Makefile} should be set as variables in the @file{Makefile}.
 
 The @samp{provides} can be done automatically, but currently aren't.  It
 would probably be a good idea to set them in the @file{Makefile} (they