21.4.14 "Reasonable Discussion".

diff --git a/man/lispref/packaging.texi b/man/lispref/packaging.texi
index f682baa..fec092c 100644 (file)
--- 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