[Emacs-diffs] trunk r116413: * doc/lispref/package.texi (Simple Packages): Describe URL and Keywords headers

[Glenn Morris]

------------------------------------------------------------
revno: 116413
revision-id: address@hidden
parent: address@hidden
committer: Glenn Morris <address@hidden>
branch nick: trunk
timestamp: Tue 2014-02-11 20:43:35 -0500
message:
  * doc/lispref/package.texi (Simple Packages): Describe URL and Keywords 
headers
modified:
  doc/lispref/ChangeLog          changelog-20091113204419-o5vbwnq5f7feedwu-6155
  doc/lispref/package.texi       package.texi-20100825202226-iq7hwjiir2jpyd4g-1

=== modified file 'doc/lispref/ChangeLog'
--- a/doc/lispref/ChangeLog     2014-02-10 02:37:43 +0000
+++ b/doc/lispref/ChangeLog     2014-02-12 01:43:35 +0000
@@ -1,3 +1,7 @@
+2014-02-12  Glenn Morris  <address@hidden>
+
+       * package.texi (Simple Packages): Describe URL and Keywords headers.
+
 2014-02-10  Lars Ingebrigtsen  <address@hidden>
 
        * text.texi (User-Level Deletion): Document

=== modified file 'doc/lispref/package.texi'
--- a/doc/lispref/package.texi  2014-01-01 07:43:34 +0000
+++ b/doc/lispref/package.texi  2014-02-12 01:43:35 +0000
@@ -141,7 +141,8 @@
 ;; Author: J. R. Hacker <jrh@@example.com>
 ;; Version: 1.3
 ;; Package-Requires: ((flange "1.0"))
-;; Keywords: frobnicate
+;; Keywords: multimedia, frobnicate
+;; URL: http://example.com/jrhacker/superfrobnicate
 
 @dots{}
 
@@ -177,6 +178,11 @@
 Headers}, for a description of the @samp{Package-Requires} header.  If
 the header is omitted, the package has no dependencies.
 
+  The @samp{Keywords} and @samp{URL} headers are optional, but recommended.
+The command @code{describe-package} uses these to add links to its
+output.  The @samp{Keywords} header should contain at least one
+standard keyword from the @code{finder-known-keywords} list.
+
   The file ought to also contain one or more autoload magic comments,
 as explained in @ref{Packaging Basics}.  In the above example, a magic
 comment autoloads @code{superfrobnicator-mode}.