# HG changeset patch
# User Bill Wohler <wohler@newt.com>
# Date 1144975741 0
# Node ID 80d80d23ec24f35b5e6ab096e9305090b8bf8828
# Parent  34e6282ccc276f968f47495b03c3ea1cdd0a8d15
(Common Keywords): Use dotted notation for :package-version value.
Improve documentation for customize-package-emacs-version-alist.

diff -r 34e6282ccc27 -r 80d80d23ec24 lispref/ChangeLog
--- a/lispref/ChangeLog	Fri Apr 14 00:47:00 2006 +0000
+++ b/lispref/ChangeLog	Fri Apr 14 00:49:01 2006 +0000
@@ -1,3 +1,9 @@
+2006-04-13  Bill Wohler  <wohler@newt.com>
+
+	* customize.texi (Common Keywords): Use dotted notation for
+	:package-version value. Improve documentation for
+	customize-package-emacs-version-alist.
+
 2006-04-12  Bill Wohler  <wohler@newt.com>
 
 	* customize.texi (Common Keywords): Move description of
diff -r 34e6282ccc27 -r 80d80d23ec24 lispref/customize.texi
--- a/lispref/customize.texi	Fri Apr 14 00:47:00 2006 +0000
+++ b/lispref/customize.texi	Fri Apr 14 00:49:01 2006 +0000
@@ -131,12 +131,14 @@
 version @var{version}, or that its default value was changed in that
 version.  The value @var{version} must be a string.
 
-@item :package-version '(@var{package} @var{version})
+@item :package-version '(@var{package} . @var{version})
 This option specifies that the item was first introduced in
 @var{package} version @var{version}, or that its default value was
 changed in that version.  This keyword takes priority over :version.
 The @var{package} and @var{version} must appear in the alist
-@code{customize-package-emacs-version-alist}.
+@code{customize-package-emacs-version-alist}.  Since @var{package} must
+be unique and the user might see it in an error message, a good choice
+is the official name of the package, such as MH-E or Gnus.
 
 @end table
 
@@ -144,17 +146,30 @@
 the @code{customize-package-emacs-version-alist} variable.
 
 @defvar customize-package-emacs-version-alist
-This alist maps packages to alists that map all package versions used
-with the @code{:package-version} keyword to Emacs versions.  Packages
-are symbols and versions are strings.  For example, the MH-E package
-updates this alist with the following:
+This alist provides a mapping for the versions of Emacs that are
+associated with versions of a package listed in the
+@code{:package-version} keyword.  Its elements look like this:
+
+@example
+(@var{package} (@var{pversion} . @var{eversion})@dots{})
+@end example
+
+For each @var{package}, which is a symbol, there are one or more
+elements that contain a package version @var{pversion} with an
+associated Emacs version @var{eversion}.  These versions are strings.
+For example, the MH-E package updates this alist with the following:
 
 @smallexample
 (add-to-list 'customize-package-emacs-version-alist
-             '(MH-E ("6.0" "22.1") ("6.1" "22.1") ("7.0" "22.1")
-                    ("7.1" "22.1") ("7.2" "22.1") ("7.3" "22.1")
-                    ("7.4" "22.1") ("8.0" "22.1")))
+             '(MH-E ("6.0" . "22.1") ("6.1" . "22.1") ("7.0" . "22.1")
+                    ("7.1" . "22.1") ("7.2" . "22.1") ("7.3" . "22.1")
+                    ("7.4" . "22.1") ("8.0" . "22.1")))
 @end smallexample
+
+The value of @var{package} needs to be unique and it needs to match
+the @var{package} value appearing in the @code{:package-version}
+keyword.  Since the user might see the value in a error message, a good
+choice is the official name of the package, such as MH-E or Gnus.
 @end defvar
 
 @node Group Definitions