GNU bug report logs - #15717
24.3.50; document `custom-available-themes', `custom-known-themes' in Elisp manual

Previous Next

Full log

Message #10 received at 15717-done <at> debbugs.gnu.org (full text, mbox):

From: Chong Yidong <cyd <at> gnu.org>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: 15717-done <at> debbugs.gnu.org
Subject: Re: bug#15717: 24.3.50;
 document `custom-available-themes', `custom-known-themes' in Elisp
 manual
Date: Wed, 18 Dec 2013 22:52:19 +0800

Drew Adams <drew.adams <at> oracle.com> writes:

> These functions are as important for programmers as is
> `custom-theme-p'.  It is especially important to distinguish them, in
> particular wrt `custom-theme-p', which uses only
> `custom-known-themes'.  An "available" theme is not necessarily a
> "known" theme.  This can be confusing.

I've added custom-known-themes to the manual, and updated the docstring
of custom-available-themes to emphasize that it's meant for things like
completion.  (I don't think custom-available-themes is suitable for the
Lisp manual, but custom-theme-load-path is already documented.)

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.