[Emacs-diffs] trunk r115592: * customize.texi (Custom Themes): Document custom-known-themes.

[Chong Yidong]

------------------------------------------------------------
revno: 115592
revision-id: address@hidden
parent: address@hidden
fixes bug: http://debbugs.gnu.org/15717
committer: Chong Yidong <address@hidden>
branch nick: trunk
timestamp: Wed 2013-12-18 22:54:24 +0800
message:
  * customize.texi (Custom Themes): Document custom-known-themes.
  
  * custom.el (custom-available-themes): Doc fix.
modified:
  doc/lispref/ChangeLog          changelog-20091113204419-o5vbwnq5f7feedwu-6155
  doc/lispref/customize.texi     
customize.texi-20091113204419-o5vbwnq5f7feedwu-6170
  lisp/ChangeLog                 changelog-20091113204419-o5vbwnq5f7feedwu-1432
  lisp/custom.el                 custom.el-20091113204419-o5vbwnq5f7feedwu-1093

=== modified file 'doc/lispref/ChangeLog'
--- a/doc/lispref/ChangeLog     2013-12-18 05:31:11 +0000
+++ b/doc/lispref/ChangeLog     2013-12-18 14:54:24 +0000
@@ -1,5 +1,8 @@
 2013-12-18  Chong Yidong  <address@hidden>
 
+       * customize.texi (Custom Themes): Document custom-known-themes
+       (Bug#15717).
+
        * modes.texi (Defining Minor Modes): Fix typo (Bug#14874).
        (Keymaps and Minor Modes): Fix binding convention (Bug#11522).
 

=== modified file 'doc/lispref/customize.texi'
--- a/doc/lispref/customize.texi        2013-01-02 16:13:04 +0000
+++ b/doc/lispref/customize.texi        2013-12-18 14:54:24 +0000
@@ -1428,6 +1428,17 @@
 it returns @code{nil}.
 @end defun
 
address@hidden custom-known-themes
+The value of this variable is a list of themes loaded into Emacs.
+Each theme is represented by a Lisp symbol (the theme name).  The
+default value of this variable is a list containing two ``dummy''
+themes: @code{(user changed)}.  The @code{changed} theme stores
+settings made before any Custom themes are applied (e.g., variables
+set outside of Customize).  The @code{user} theme stores settings the
+user has customized and saved.  Any additional themes declared with
+the @code{deftheme} macro are added to the front of this list.
address@hidden defvar
+
 @deffn Command load-theme theme &optional no-confirm no-enable
 This function loads the Custom theme named @var{theme} from its source
 file, looking for the source file in the directories specified by the

=== modified file 'lisp/ChangeLog'
--- a/lisp/ChangeLog    2013-12-18 11:52:49 +0000
+++ b/lisp/ChangeLog    2013-12-18 14:54:24 +0000
@@ -11,6 +11,7 @@
        * custom.el (custom-push-theme): If custom--inhibit-theme-enable
        is non-nil, do not create a new entry in the symbol's theme-value
        or theme-face property; update theme-settings only (Bug#14664).
+       (custom-available-themes): Doc fix.
 
        * cus-theme.el (custom-new-theme-mode-map): Add bindings
        (Bug#15674).

=== modified file 'lisp/custom.el'
--- a/lisp/custom.el    2013-12-18 08:53:22 +0000
+++ b/lisp/custom.el    2013-12-18 14:54:24 +0000
@@ -1277,7 +1277,14 @@
                (eq name 'changed)))))
 
 (defun custom-available-themes ()
-  "Return a list of available Custom themes (symbols)."
+  "Return a list of Custom themes available for loading.
+Search the directories specified by `custom-theme-load-path' for
+files named FOO-theme.el, and return a list of FOO symbols.
+
+The returned symbols may not correspond to themes that have been
+loaded, and no effort is made to check that the files contain
+valid Custom themes.  For a list of loaded themes, check the
+variable `custom-known-themes'."
   (let (sym themes)
     (dolist (dir (custom-theme--load-path))
       (when (file-directory-p dir)