From unknown Sat Jun 21 16:08:06 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#12912 <12912@debbugs.gnu.org> To: bug#12912 <12912@debbugs.gnu.org> Subject: Status: 24.3.50; doc string for `read-face-name' Reply-To: bug#12912 <12912@debbugs.gnu.org> Date: Sat, 21 Jun 2025 23:08:06 +0000 retitle 12912 24.3.50; doc string for `read-face-name' reassign 12912 emacs submitter 12912 "Drew Adams" severity 12912 minor thanks From debbugs-submit-bounces@debbugs.gnu.org Fri Nov 16 19:38:44 2012 Received: (at submit) by debbugs.gnu.org; 17 Nov 2012 00:38:44 +0000 Received: from localhost ([127.0.0.1]:49687 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TZWQl-0001AB-Cx for submit@debbugs.gnu.org; Fri, 16 Nov 2012 19:38:44 -0500 Received: from eggs.gnu.org ([208.118.235.92]:56161) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TZWQj-0001A3-Ay for submit@debbugs.gnu.org; Fri, 16 Nov 2012 19:38:41 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1TZWPt-0001PC-1J for submit@debbugs.gnu.org; Fri, 16 Nov 2012 19:37:52 -0500 Received: from lists.gnu.org ([208.118.235.17]:53151) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TZWPs-0001P8-Ud for submit@debbugs.gnu.org; Fri, 16 Nov 2012 19:37:48 -0500 Received: from eggs.gnu.org ([208.118.235.92]:55514) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TZWPp-00025R-SM for bug-gnu-emacs@gnu.org; Fri, 16 Nov 2012 19:37:48 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1TZWPm-0001No-Po for bug-gnu-emacs@gnu.org; Fri, 16 Nov 2012 19:37:45 -0500 Received: from aserp1040.oracle.com ([141.146.126.69]:39637) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TZWPm-0001NV-Jg for bug-gnu-emacs@gnu.org; Fri, 16 Nov 2012 19:37:42 -0500 Received: from acsinet22.oracle.com (acsinet22.oracle.com [141.146.126.238]) by aserp1040.oracle.com (Sentrion-MTA-4.2.2/Sentrion-MTA-4.2.2) with ESMTP id qAH0beHE028586 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Sat, 17 Nov 2012 00:37:41 GMT Received: from acsmt356.oracle.com (acsmt356.oracle.com [141.146.40.156]) by acsinet22.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id qAH0bdXC001635 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Sat, 17 Nov 2012 00:37:40 GMT Received: from abhmt111.oracle.com (abhmt111.oracle.com [141.146.116.63]) by acsmt356.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id qAH0bdx4017848 for ; Fri, 16 Nov 2012 18:37:39 -0600 Received: from dradamslap1 (/10.159.229.77) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Fri, 16 Nov 2012 16:37:39 -0800 From: "Drew Adams" To: Subject: 24.3.50; doc string for `read-face-name' Date: Fri, 16 Nov 2012 16:37:34 -0800 Message-ID: <516312D8C1444CE28E4459BC7115A1BA@us.oracle.com> MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Mailer: Microsoft Office Outlook 11 Thread-Index: Ac3EW7yEGVGsPF2XQTWDae/Cd/AnSg== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6157 X-Source-IP: acsinet22.oracle.com [141.146.126.238] 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: GNU/Linux 2.6.x X-Received-From: 208.118.235.17 X-Spam-Score: -3.4 (---) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -4.7 (----) This doc seems to be incomplete and unclear wrt DEFAULT. It speaks of a case where DEFAULT is not a string. It does not say what else it must/can be (besides nil). Can it be a symbol - e.g., a face symbol? Can it be a list of strings, i.e., multiple defaults? A list of faces (symbols)? What's more, there is nothing in the doc string that indicates that the face name(s) is/are read using `completing-read-multiple'. Not that that implementation detail need be mentioned explicitly, but its _behavior_, i.e., what the behavior of `read-face-name' is, should be described. In GNU Emacs 24.3.50.1 (i386-mingw-nt5.1.2600) of 2012-11-05 on MS-W7-DANI Bzr revision: 110809 lekktu@gmail.com-20121105172930-a5gn0bwi4lndchhw Windowing system distributor `Microsoft Corp.', version 5.1.2600 Configured using: `configure --with-gcc (4.7) --no-opt --enable-checking --cflags -I../../libs/libXpm-3.5.10/include -I../../libs/libXpm-3.5.10/src -I../../libs/libpng-1.2.37-lib/include -I../../libs/zlib-1.2.5 -I../../libs/giflib-4.1.4-1-lib/include -I../../libs/jpeg-6b-4-lib/include -I../../libs/tiff-3.8.2-1-lib/include -I../../libs/libxml2-2.7.8-w32-bin/include/libxml2 -I../../libs/gnutls-3.0.9-w32-bin/include -I../../libs/libiconv-1.9.2-1-lib/include' From debbugs-submit-bounces@debbugs.gnu.org Fri Nov 16 19:51:28 2012 Received: (at 12912) by debbugs.gnu.org; 17 Nov 2012 00:51:28 +0000 Received: from localhost ([127.0.0.1]:49692 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TZWd6-0001RL-HM for submit@debbugs.gnu.org; Fri, 16 Nov 2012 19:51:28 -0500 Received: from aserp1040.oracle.com ([141.146.126.69]:44686) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TZWd3-0001RB-88 for 12912@debbugs.gnu.org; Fri, 16 Nov 2012 19:51:26 -0500 Received: from acsinet22.oracle.com (acsinet22.oracle.com [141.146.126.238]) by aserp1040.oracle.com (Sentrion-MTA-4.2.2/Sentrion-MTA-4.2.2) with ESMTP id qAH0oYZf003480 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for <12912@debbugs.gnu.org>; Sat, 17 Nov 2012 00:50:35 GMT Received: from acsmt356.oracle.com (acsmt356.oracle.com [141.146.40.156]) by acsinet22.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id qAH0oXP7015691 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for <12912@debbugs.gnu.org>; Sat, 17 Nov 2012 00:50:34 GMT Received: from abhmt105.oracle.com (abhmt105.oracle.com [141.146.116.57]) by acsmt356.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id qAH0oXXi023983 for <12912@debbugs.gnu.org>; Fri, 16 Nov 2012 18:50:33 -0600 Received: from dradamslap1 (/10.159.229.77) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Fri, 16 Nov 2012 16:50:33 -0800 From: "Drew Adams" To: <12912@debbugs.gnu.org> References: <516312D8C1444CE28E4459BC7115A1BA@us.oracle.com> Subject: RE: bug#12912: 24.3.50; doc string for `read-face-name' Date: Fri, 16 Nov 2012 16:50:28 -0800 Message-ID: <823BAC8AF13644A688E3F122559CE0D3@us.oracle.com> MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Mailer: Microsoft Office Outlook 11 In-reply-to: <516312D8C1444CE28E4459BC7115A1BA@us.oracle.com> Thread-Index: Ac3EW7yEGVGsPF2XQTWDae/Cd/AnSgAAYQHw X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6157 X-Source-IP: acsinet22.oracle.com [141.146.126.238] X-Spam-Score: 0.7 (/) X-Debbugs-Envelope-To: 12912 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: 0.7 (/) The doc string is also bad wrt PROMPT. It correctly says that it should not end in a space, but it should also say that it should not end in a colon. In fact, it would be far more understandable if it said (as I think we say elsewhere for such silly prompt handling) that ": " will automatically be appended to PROMPT. That tells you the reason and everything you need to know. From debbugs-submit-bounces@debbugs.gnu.org Wed Jan 09 04:47:24 2013 Received: (at 12912-done) by debbugs.gnu.org; 9 Jan 2013 09:47:24 +0000 Received: from localhost ([127.0.0.1]:57912 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TssFn-0002D5-Ic for submit@debbugs.gnu.org; Wed, 09 Jan 2013 04:47:23 -0500 Received: from mail-pb0-f46.google.com ([209.85.160.46]:50643) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TssFj-0002Co-Ne for 12912-done@debbugs.gnu.org; Wed, 09 Jan 2013 04:47:20 -0500 Received: by mail-pb0-f46.google.com with SMTP id wy7so835797pbc.19 for <12912-done@debbugs.gnu.org>; Wed, 09 Jan 2013 01:47:04 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=x-received:sender:from:to:cc:subject:references:date:in-reply-to :message-id:user-agent:mime-version:content-type; bh=Ke2R+b2YVaVZJBGaPgEXaRgE3tsDa2Q3u10VkcIoAr8=; b=oCuGP718geqGppC3nuFsZZGtTklg8vCayFy0AQG3+FdMc5bZDNOV9a56GClmwkwLDg cqEcBr3RL++LIQMyCpXWfJJsBhm/VOgIT79qZkoDaRbW/QFPXt42l3omeM7C/TlmXWg9 9lNn6FnUHYiV5QareTgVgXfnrTpnf35DiXeI3M788ZRBHkryAoKeCKoVSdCYvYQ81y3y zqHuZ6zWzdEXh4ntyh+xZPRPGi94Je2y29MqZL39oe1HCfMdPSI7Y0DxvrC0sfT70RB+ KfTOh0TVh1txH9JSQEz7glN0Ez3deRjo6F452XUKx/QOpFyecR/RPQ0o57eTHyk8gRV5 N+TA== X-Received: by 10.66.75.100 with SMTP id b4mr188335765paw.0.1357724824074; Wed, 09 Jan 2013 01:47:04 -0800 (PST) Received: from tsparkle ([155.69.17.48]) by mx.google.com with ESMTPS id pm8sm41345262pbb.29.2013.01.09.01.47.00 (version=SSLv3 cipher=OTHER); Wed, 09 Jan 2013 01:47:02 -0800 (PST) From: Chong Yidong To: "Drew Adams" Subject: Re: bug#12912: 24.3.50; doc string for `read-face-name' References: <516312D8C1444CE28E4459BC7115A1BA@us.oracle.com> Date: Wed, 09 Jan 2013 17:46:57 +0800 In-Reply-To: <516312D8C1444CE28E4459BC7115A1BA@us.oracle.com> (Drew Adams's message of "Fri, 16 Nov 2012 16:37:34 -0800") Message-ID: <87bocy4rji.fsf@gnu.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.2.91 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: 0.1 (/) X-Debbugs-Envelope-To: 12912-done Cc: 12912-done@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -2.6 (--) "Drew Adams" writes: > This doc seems to be incomplete and unclear wrt DEFAULT. > > It speaks of a case where DEFAULT is not a string. It does not say what > else it must/can be (besides nil). Can it be a symbol - e.g., a face > symbol? Can it be a list of strings, i.e., multiple defaults? A list > of faces (symbols)? > > What's more, there is nothing in the doc string that indicates that the > face name(s) is/are read using `completing-read-multiple'. Not that > that implementation detail need be mentioned explicitly, but its > _behavior_, i.e., what the behavior of `read-face-name' is, should be > described. Should be fixed now, thanks. From unknown Sat Jun 21 16:08:06 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Wed, 06 Feb 2013 12:24:03 +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