From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#15717: 24.3.50; document `custom-available-themes', `custom-known-themes' in Elisp manual Date: Fri, 25 Oct 2013 08:39:02 -0700 (PDT) Message-ID: NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1382715625 1688 80.91.229.3 (25 Oct 2013 15:40:25 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 25 Oct 2013 15:40:25 +0000 (UTC) To: 15717@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Oct 25 17:40:28 2013 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1VZjUw-00026w-O2 for geb-bug-gnu-emacs@m.gmane.org; Fri, 25 Oct 2013 17:40:26 +0200 Original-Received: from localhost ([::1]:59784 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VZjUw-000692-CZ for geb-bug-gnu-emacs@m.gmane.org; Fri, 25 Oct 2013 11:40:26 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:56212) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VZjUj-00064B-3S for bug-gnu-emacs@gnu.org; Fri, 25 Oct 2013 11:40:23 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1VZjUY-0003oh-OD for bug-gnu-emacs@gnu.org; Fri, 25 Oct 2013 11:40:13 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:57852) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VZjUY-0003oT-Ku for bug-gnu-emacs@gnu.org; Fri, 25 Oct 2013 11:40:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1VZjUX-0001a0-TC for bug-gnu-emacs@gnu.org; Fri, 25 Oct 2013 11:40:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 25 Oct 2013 15:40:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 15717 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.13827155836012 (code B ref -1); Fri, 25 Oct 2013 15:40:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 25 Oct 2013 15:39:43 +0000 Original-Received: from localhost ([127.0.0.1]:43638 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1VZjUE-0001Yn-HL for submit@debbugs.gnu.org; Fri, 25 Oct 2013 11:39:43 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:54388) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1VZjUB-0001YS-E4 for submit@debbugs.gnu.org; Fri, 25 Oct 2013 11:39:40 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1VZjTw-0003fd-4T for submit@debbugs.gnu.org; Fri, 25 Oct 2013 11:39:34 -0400 Original-Received: from lists.gnu.org ([2001:4830:134:3::11]:36950) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VZjTw-0003fZ-22 for submit@debbugs.gnu.org; Fri, 25 Oct 2013 11:39:24 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:56033) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VZjTn-0005x4-GJ for bug-gnu-emacs@gnu.org; Fri, 25 Oct 2013 11:39:24 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1VZjTd-0003YQ-Tb for bug-gnu-emacs@gnu.org; Fri, 25 Oct 2013 11:39:15 -0400 Original-Received: from aserp1040.oracle.com ([141.146.126.69]:36615) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VZjTd-0003YM-N3 for bug-gnu-emacs@gnu.org; Fri, 25 Oct 2013 11:39:05 -0400 Original-Received: from ucsinet21.oracle.com (ucsinet21.oracle.com [156.151.31.93]) by aserp1040.oracle.com (Sentrion-MTA-4.3.1/Sentrion-MTA-4.3.1) with ESMTP id r9PFd48s006739 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Fri, 25 Oct 2013 15:39:04 GMT Original-Received: from userz7021.oracle.com (userz7021.oracle.com [156.151.31.85]) by ucsinet21.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id r9PFd38Y019192 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Fri, 25 Oct 2013 15:39:03 GMT Original-Received: from abhmt106.oracle.com (abhmt106.oracle.com [141.146.116.58]) by userz7021.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id r9PFd3GY019177 for ; Fri, 25 Oct 2013 15:39:03 GMT X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.8 (707110) [OL 12.0.6680.5000 (x86)] X-Source-IP: ucsinet21.oracle.com [156.151.31.93] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x X-Received-From: 140.186.70.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:79646 Archived-At: 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. For example, I was doing this at first: (defcustom doremi-custom-themes () "*List of custom themes to cycle through using `doremi-custom-themes+'." :type '(repeat (restricted-sexp :match-alternatives (custom-theme-p))) :group 'doremi-misc-commands) But what I really needed was the following, because the "available" themes are not necessarily available from the outset - the set of "known" themes is too limited for use here. (defcustom doremi-custom-themes () "*List of custom themes to cycle through using `doremi-custom-themes+'." :type '(repeat (restricted-sexp :match-alternatives ((lambda (s) (memq s (custom-available-themes)))))) :group 'doremi-misc-commands) In GNU Emacs 24.3.50.1 (i686-pc-mingw32) of 2013-10-19 on LEG570 Bzr revision: 114715 rgm@gnu.org-20131019023520-s8mwtib7xcx9e05w Windowing system distributor `Microsoft Corp.', version 6.1.7601 Configured using: `configure --enable-checking 'CFLAGS=3D-O0 -g3' CPPFLAGS=3D-DGLYPH_DEBUG= =3D1'