[Emacs-diffs] Changes to emacs/lispref/customize.texi

[Bill Wohler]

Index: emacs/lispref/customize.texi
diff -u emacs/lispref/customize.texi:1.55 emacs/lispref/customize.texi:1.56
--- emacs/lispref/customize.texi:1.55   Wed Apr 12 22:12:29 2006
+++ emacs/lispref/customize.texi        Fri Apr 14 00:49:01 2006
@@ -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.
 
address@hidden :package-version '(@var{package} @var{version})
address@hidden :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
address@hidden
address@hidden  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
address@hidden:package-version} keyword.  Its elements look like this:
+
address@hidden
+(@var{package} (@var{pversion} . @var{eversion})@dots{})
address@hidden 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