From unknown Sat Aug 16 15:57:49 2025 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-Mailer: MIME-tools 5.509 (Entity 5.509) Content-Type: text/plain; charset=utf-8 From: bug#15717 <15717@debbugs.gnu.org> To: bug#15717 <15717@debbugs.gnu.org> Subject: Status: 24.3.50; document `custom-available-themes', `custom-known-themes' in Elisp manual Reply-To: bug#15717 <15717@debbugs.gnu.org> Date: Sat, 16 Aug 2025 22:57:49 +0000 retitle 15717 24.3.50; document `custom-available-themes', `custom-known-th= emes' in Elisp manual reassign 15717 emacs submitter 15717 Drew Adams severity 15717 minor thanks From debbugs-submit-bounces@debbugs.gnu.org Fri Oct 25 11:39:43 2013 Received: (at submit) by debbugs.gnu.org; 25 Oct 2013 15:39:43 +0000 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 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 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 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=0.8 required=5.0 tests=BAYES_50 autolearn=disabled version=3.3.2 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 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 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 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 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 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 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 MIME-Version: 1.0 Message-ID: Date: Fri, 25 Oct 2013 08:39:02 -0700 (PDT) From: Drew Adams To: bug-gnu-emacs@gnu.org Subject: 24.3.50; document `custom-available-themes', `custom-known-themes' in Elisp manual X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.8 (707110) [OL 12.0.6680.5000 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable 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-Received-From: 2001:4830:134:3::11 X-Spam-Score: -4.0 (----) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -4.0 (----) 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' From debbugs-submit-bounces@debbugs.gnu.org Wed Dec 18 09:52:25 2013 Received: (at 15717-done) by debbugs.gnu.org; 18 Dec 2013 14:52:25 +0000 Received: from localhost ([127.0.0.1]:56724 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1VtIU4-0005e5-P6 for submit@debbugs.gnu.org; Wed, 18 Dec 2013 09:52:25 -0500 Received: from mail-pa0-f53.google.com ([209.85.220.53]:35876) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1VtIU2-0005dx-Hn for 15717-done@debbugs.gnu.org; Wed, 18 Dec 2013 09:52:23 -0500 Received: by mail-pa0-f53.google.com with SMTP id hz1so5999917pad.26 for <15717-done@debbugs.gnu.org>; Wed, 18 Dec 2013 06:52:21 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=sender:from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version:content-type; bh=mylQqFvmzj8fbnvbxL6zldH57ILEXVlW0mWerOOxTM8=; b=xJEb2izuUMTGUgOtrAh/uI/wfHPVL2ipBrwHrD4rYcrE3kyA50Gv9fl7/C3o+z2bel EGCxv9VvUTsP11pkHnY33Y4D1gdmBCmaAgxMtcyoqxs6VxBZTr/0hDUx0+pA08iRjvsR txP1npG+XStT5CZ1c+rpti3O0lwHlYT1s8qUPHxd3BoOOHoWFk8klSsbUdSamrfhdD2S w5vZ6mAmPnZ0T05Ss/VY6SbpHd9eI/IklqkO98U7F1GRDu5pEXlwqu8/FyqjtLbPBbON 6RHw0y6uVWOiTkN0x6mCM8LefFGuDOAwZCde+nBpxgcR59LSaaRLAXfbSDSWwP2+/fsy tugQ== X-Received: by 10.66.2.234 with SMTP id 10mr33942379pax.39.1387378341463; Wed, 18 Dec 2013 06:52:21 -0800 (PST) Received: from tsparkle ([155.69.2.31]) by mx.google.com with ESMTPSA id qw8sm523217pbb.27.2013.12.18.06.52.19 for (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Wed, 18 Dec 2013 06:52:20 -0800 (PST) From: Chong Yidong To: Drew Adams Subject: Re: bug#15717: 24.3.50; document `custom-available-themes', `custom-known-themes' in Elisp manual References: Date: Wed, 18 Dec 2013 22:52:19 +0800 In-Reply-To: (Drew Adams's message of "Fri, 25 Oct 2013 08:39:02 -0700 (PDT)") Message-ID: <87vbymfbz0.fsf@gnu.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.3.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -0.7 (/) X-Debbugs-Envelope-To: 15717-done Cc: 15717-done@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -0.7 (/) Drew Adams 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.) From unknown Sat Aug 16 15:57:49 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Thu, 16 Jan 2014 12:24:04 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator