21.4.14 "Reasonable Discussion".

[chise/xemacs-chise.git.1] / man / xemacs / packages.texi

diff --git a/man/xemacs/packages.texi b/man/xemacs/packages.texi
index fef6391..32adac7 100644 (file)
--- a/man/xemacs/packages.texi
+++ b/man/xemacs/packages.texi
@@ -565,7 +565,7 @@ infrastructure.
    priority high
    category CATEGORY
    dump nil
    priority high
    category CATEGORY
    dump nil

-   description "description"        ; a one-line description string
+   description "DESCRIPTION"        ; one-line period-terminated string

    filename FILENAME
    md5sum MD5SUM
    size SIZE
    filename FILENAME
    md5sum MD5SUM
    size SIZE

@@ -580,11 +580,13 @@ the name of your package as an unquoted symbol.  Normally it is the name
 of the main Lisp file or principal feature provided.  The allowed values
 for distribution are @code{xemacs} and @code{mule}.  Write them as
 unquoted symbols.  The @code{description} is a quoted Lisp string; use
 of the main Lisp file or principal feature provided.  The allowed values
 for distribution are @code{xemacs} and @code{mule}.  Write them as
 unquoted symbols.  The @code{description} is a quoted Lisp string; use

-the usual conventions.  The value for @code{provides} is a list of
-feature symbols (written unquoted).  All of the features provided by
-libraries in your package should be elements of this list.  Implementing
-an automatic method for generating the @file{provides} line is
-desirable, but as yet undone.
+the usual conventions.  The first letter should be capitalized, and the
+string should end in a period.  It need not be a complete sentence
+grammatically.  The value for @code{provides} is a list of feature
+symbols (written unquoted).  All of the features provided by libraries
+in your package should be elements of this list.  Implementing an
+automatic method for generating the @file{provides} line is desirable,
+but as yet undone.

 
 The variables in upper-case are references to variables set in the
 @file{Makefile} or automatically generated.  Do not change them; they
 
 The variables in upper-case are references to variables set in the
 @file{Makefile} or automatically generated.  Do not change them; they