From unknown Fri Aug 15 21:25:30 2025 X-Loop: help-debbugs@gnu.org Subject: bug#15717: 24.3.50; document `custom-available-themes', `custom-known-themes' in Elisp manual 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: To: 15717@debbugs.gnu.org X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.13827155836012 (code B ref -1); Fri, 25 Oct 2013 15:40:01 +0000 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 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-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 unknown Fri Aug 15 21:25:30 2025 MIME-Version: 1.0 X-Mailer: MIME-tools 5.503 (Entity 5.503) X-Loop: help-debbugs@gnu.org From: help-debbugs@gnu.org (GNU bug Tracking System) To: Drew Adams Subject: bug#15717: closed (Re: bug#15717: 24.3.50; document `custom-available-themes', `custom-known-themes' in Elisp manual) Message-ID: References: <87vbymfbz0.fsf@gnu.org> X-Gnu-PR-Message: they-closed 15717 X-Gnu-PR-Package: emacs Reply-To: 15717@debbugs.gnu.org Date: Wed, 18 Dec 2013 14:53:02 +0000 Content-Type: multipart/mixed; boundary="----------=_1387378382-21764-1" This is a multi-part message in MIME format... ------------=_1387378382-21764-1 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Your bug report #15717: 24.3.50; document `custom-available-themes', `custom-known-themes' = in Elisp manual which was filed against the emacs package, has been closed. The explanation is attached below, along with your original report. If you require more details, please reply to 15717@debbugs.gnu.org. --=20 15717: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D15717 GNU Bug Tracking System Contact help-debbugs@gnu.org with problems ------------=_1387378382-21764-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit 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.) ------------=_1387378382-21764-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit 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' ------------=_1387378382-21764-1--