[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] Changes to emacs/lispref/customize.texi
From: |
Bill Wohler |
Subject: |
[Emacs-diffs] Changes to emacs/lispref/customize.texi |
Date: |
Fri, 14 Apr 2006 00:49:01 +0000 |
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