From unknown Sat Jun 21 10:46:28 2025 X-Loop: help-debbugs@gnu.org Subject: bug#14647: 24.3.50; doc of `set-face-font' Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 18 Jun 2013 03:47:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 14647 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 14647@debbugs.gnu.org X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.137152718224370 (code B ref -1); Tue, 18 Jun 2013 03:47:02 +0000 Received: (at submit) by debbugs.gnu.org; 18 Jun 2013 03:46:22 +0000 Received: from localhost ([127.0.0.1]:51892 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Uoms9-0006Kz-OQ for submit@debbugs.gnu.org; Mon, 17 Jun 2013 23:46:22 -0400 Received: from eggs.gnu.org ([208.118.235.92]:58673) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Uoms7-0006Kf-9k for submit@debbugs.gnu.org; Mon, 17 Jun 2013 23:46:19 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Uoms0-0008PX-Hf for submit@debbugs.gnu.org; Mon, 17 Jun 2013 23:46:13 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-100.5 required=5.0 tests=BAYES_05, USER_IN_WHITELIST autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:47688) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Uoms0-0008PS-FB for submit@debbugs.gnu.org; Mon, 17 Jun 2013 23:46:12 -0400 Received: from eggs.gnu.org ([2001:4830:134:3::10]:60391) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Uomrz-0002KR-9Q for bug-gnu-emacs@gnu.org; Mon, 17 Jun 2013 23:46:12 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Uomry-0008OE-EF for bug-gnu-emacs@gnu.org; Mon, 17 Jun 2013 23:46:11 -0400 Received: from userp1040.oracle.com ([156.151.31.81]:18356) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Uomry-0008O8-7d for bug-gnu-emacs@gnu.org; Mon, 17 Jun 2013 23:46:10 -0400 Received: from acsinet22.oracle.com (acsinet22.oracle.com [141.146.126.238]) by userp1040.oracle.com (Sentrion-MTA-4.3.1/Sentrion-MTA-4.3.1) with ESMTP id r5I3k5Y5002644 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Tue, 18 Jun 2013 03:46:06 GMT Received: from userz7021.oracle.com (userz7021.oracle.com [156.151.31.85]) by acsinet22.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id r5I3k71S021932 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Tue, 18 Jun 2013 03:46:08 GMT Received: from abhmt118.oracle.com (abhmt118.oracle.com [141.146.116.70]) by userz7021.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id r5I3k7TK016457 for ; Tue, 18 Jun 2013 03:46:07 GMT MIME-Version: 1.0 Message-ID: <4430da9a-9455-46dd-bc0d-1177123e147e@default> Date: Mon, 17 Jun 2013 20:46:06 -0700 (PDT) From: Drew Adams X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.7 (607090) [OL 12.0.6668.5000 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable 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: 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 (----) 1. Neither the Elisp manual (node `Attribute Functions') nor the doc string says what form the string FONT must or may take. 2. The manual says that this command sets the :font attribute. The doc string says instead that it sets attributes :family, :foundry, :width, :height, :weight, and :slant. Which is it? 3. #1 is all the more imporatnt because the doc string of `x-list-fonts' says that it returns a list of strings that are "suitable as arguments to `set-face-font'. Really? Just what kind of strings are so suitable? I think, but am not sure, that FONT must be in XLFD form. Whatever the acceptable form(s), the doc needs to spell this out. In GNU Emacs 24.3.50.1 (i686-pc-mingw32) of 2013-06-13 on ODIEONE Bzr revision: 112978 xfq.free@gmail.com-20130613224333-3yfl8navh3c1vmxy Windowing system distributor `Microsoft Corp.', version 6.1.7601 Configured using: `configure --prefix=3D/c/Devel/emacs/binary --enable-checking=3Dyes,glyphs CFLAGS=3D'-O0 -g3' CPPFLAGS=3D'-Ic:/Devel/emacs/include' LDFLAGS=3D'-Lc:/Devel/emacs/lib'' From unknown Sat Jun 21 10:46:28 2025 X-Loop: help-debbugs@gnu.org Subject: bug#14647: 24.3.50; doc of `set-face-font' Resent-From: Lars Ingebrigtsen Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 08 Feb 2014 07:07:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 14647 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Drew Adams Cc: 14647@debbugs.gnu.org Received: via spool by 14647-submit@debbugs.gnu.org id=B14647.139184322013205 (code B ref 14647); Sat, 08 Feb 2014 07:07:02 +0000 Received: (at 14647) by debbugs.gnu.org; 8 Feb 2014 07:07:00 +0000 Received: from localhost ([127.0.0.1]:56314 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WC20A-0003Qt-R5 for submit@debbugs.gnu.org; Sat, 08 Feb 2014 02:06:59 -0500 Received: from hermes.netfonds.no ([80.91.224.195]:46142) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WC207-0003Qi-AW for 14647@debbugs.gnu.org; Sat, 08 Feb 2014 02:06:56 -0500 Received: from [204.14.154.233] (helo=building.gnus.org) by hermes.netfonds.no with esmtpsa (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.72) (envelope-from ) id 1WC1zs-00073y-RH; Sat, 08 Feb 2014 08:06:41 +0100 From: Lars Ingebrigtsen References: <4430da9a-9455-46dd-bc0d-1177123e147e@default> Date: Fri, 07 Feb 2014 23:05:32 -0800 In-Reply-To: <4430da9a-9455-46dd-bc0d-1177123e147e@default> (Drew Adams's message of "Mon, 17 Jun 2013 20:46:06 -0700 (PDT)") Message-ID: <87lhxmw0cj.fsf@building.gnus.org> User-Agent: Gnus/5.13001 (Ma Gnus v0.10) Emacs/24.3.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-MailScanner-ID: 1WC1zs-00073y-RH X-Netfonds-MailScanner: Found to be clean X-Netfonds-MailScanner-From: larsi@gnus.org MailScanner-NULL-Check: 1392448001.34468@vXVkYspGnuNoSTfQ1lJ/Yw X-Spam-Status: No X-Spam-Score: 0.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: 0.0 (/) Drew Adams writes: > 1. Neither the Elisp manual (node `Attribute Functions') nor the doc > string says what form the string FONT must or may take. Good question. The function is barely used in the Emacs source code tree. The only usage I could find that set it to something was this: (defvar gamegrid-font "-*-courier-medium-r-*-*-*-140-100-75-*-*-iso8859-*" "Name of the font used in X mode.") > 2. The manual says that this command sets the :font attribute. The doc > string says instead that it sets attributes :family, :foundry, :width, > :height, :weight, and :slant. Which is it? Yeah. > 3. #1 is all the more imporatnt because the doc string of `x-list-fonts' > says that it returns a list of strings that are "suitable as arguments > to `set-face-font'. Really? Just what kind of strings are so suitable? > > I think, but am not sure, that FONT must be in XLFD form. Whatever the > acceptable form(s), the doc needs to spell this out. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog http://lars.ingebrigtsen.no/ From unknown Sat Jun 21 10:46:28 2025 X-Loop: help-debbugs@gnu.org Subject: bug#14647: 24.3.50; doc of `set-face-font' Resent-From: Lars Ingebrigtsen Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 01 Nov 2019 17:30:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 14647 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Drew Adams Cc: 14647@debbugs.gnu.org Received: via spool by 14647-submit@debbugs.gnu.org id=B14647.157262939511368 (code B ref 14647); Fri, 01 Nov 2019 17:30:02 +0000 Received: (at 14647) by debbugs.gnu.org; 1 Nov 2019 17:29:55 +0000 Received: from localhost ([127.0.0.1]:57035 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iQakF-0002xE-0c for submit@debbugs.gnu.org; Fri, 01 Nov 2019 13:29:55 -0400 Received: from quimby.gnus.org ([80.91.231.51]:39958) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iQakD-0002x2-KJ for 14647@debbugs.gnu.org; Fri, 01 Nov 2019 13:29:54 -0400 Received: from cm-84.212.202.86.getinternet.no ([84.212.202.86] helo=marnie) by quimby.gnus.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1iQak8-00007H-5q; Fri, 01 Nov 2019 18:29:51 +0100 From: Lars Ingebrigtsen References: <4430da9a-9455-46dd-bc0d-1177123e147e@default> <87lhxmw0cj.fsf@building.gnus.org> Date: Fri, 01 Nov 2019 18:29:47 +0100 In-Reply-To: <87lhxmw0cj.fsf@building.gnus.org> (Lars Ingebrigtsen's message of "Fri, 07 Feb 2014 23:05:32 -0800") Message-ID: <87k18jwlmc.fsf@gnus.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Report: Spam detection software, running on the system "quimby.gnus.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see @@CONTACT_ADDRESS@@ for details. Content preview: Lars Ingebrigtsen writes: > Drew Adams writes: > >> 1. Neither the Elisp manual (node `Attribute Functions') nor the doc >> string says what form the string FONT must or may take. > > Good question. The [...] Content analysis details: (-2.9 points, 5.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -1.0 ALL_TRUSTED Passed through trusted hosts only via SMTP -1.9 BAYES_00 BODY: Bayes spam probability is 0 to 1% [score: 0.0000] X-Spam-Score: 0.0 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 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: -1.0 (-) Lars Ingebrigtsen writes: > Drew Adams writes: > >> 1. Neither the Elisp manual (node `Attribute Functions') nor the doc >> string says what form the string FONT must or may take. > > Good question. The function is barely used in the Emacs source code > tree. The only usage I could find that set it to something was this: > > (defvar gamegrid-font "-*-courier-medium-r-*-*-*-140-100-75-*-*-iso8859-*" > "Name of the font used in X mode.") But it's basically any string that describes a font on your system, depending on what font system you have. So "futura:size=20" works fine, too. >> 2. The manual says that this command sets the :font attribute. The doc >> string says instead that it sets attributes :family, :foundry, :width, >> :height, :weight, and :slant. Which is it? > > Yeah. It looks like it's the latter, so I've altered the documentation in the manual. >> 3. #1 is all the more imporatnt because the doc string of `x-list-fonts' >> says that it returns a list of strings that are "suitable as arguments >> to `set-face-font'. Really? Just what kind of strings are so suitable? >> >> I think, but am not sure, that FONT must be in XLFD form. Whatever the >> acceptable form(s), the doc needs to spell this out. I don't think so -- we aren't told what the form is, because that seems unnecessary. If we're curious for some reason, we can just call the function. So I'm closing this bug report. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no From debbugs-submit-bounces@debbugs.gnu.org Fri Nov 01 13:29:59 2019 Received: (at control) by debbugs.gnu.org; 1 Nov 2019 17:29:59 +0000 Received: from localhost ([127.0.0.1]:57040 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iQakJ-0002xj-C3 for submit@debbugs.gnu.org; Fri, 01 Nov 2019 13:29:59 -0400 Received: from quimby.gnus.org ([80.91.231.51]:39972) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iQakH-0002xT-Ui for control@debbugs.gnu.org; Fri, 01 Nov 2019 13:29:58 -0400 Received: from cm-84.212.202.86.getinternet.no ([84.212.202.86] helo=marnie) by quimby.gnus.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1iQakF-00007O-5W for control@debbugs.gnu.org; Fri, 01 Nov 2019 18:29:57 +0100 Date: Fri, 01 Nov 2019 18:29:54 +0100 Message-Id: <87imo3wlm5.fsf@gnus.org> To: control@debbugs.gnu.org From: Lars Ingebrigtsen Subject: control message for bug #14647 X-Spam-Report: Spam detection software, running on the system "quimby.gnus.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see @@CONTACT_ADDRESS@@ for details. Content preview: tags 14647 fixed close 14647 27.1 quit Content analysis details: (-2.9 points, 5.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -1.0 ALL_TRUSTED Passed through trusted hosts only via SMTP -1.9 BAYES_00 BODY: Bayes spam probability is 0 to 1% [score: 0.0000] X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: control X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 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: -1.0 (-) tags 14647 fixed close 14647 27.1 quit From unknown Sat Jun 21 10:46:28 2025 X-Loop: help-debbugs@gnu.org Subject: bug#14647: 24.3.50; doc of `set-face-font' Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 02 Nov 2019 10:50:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 14647 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: fixed To: Lars Ingebrigtsen Cc: drew.adams@oracle.com, 14647@debbugs.gnu.org Received: via spool by 14647-submit@debbugs.gnu.org id=B14647.15726917495008 (code B ref 14647); Sat, 02 Nov 2019 10:50:01 +0000 Received: (at 14647) by debbugs.gnu.org; 2 Nov 2019 10:49:09 +0000 Received: from localhost ([127.0.0.1]:58237 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iQqxw-0001Ii-Fw for submit@debbugs.gnu.org; Sat, 02 Nov 2019 06:49:08 -0400 Received: from eggs.gnu.org ([209.51.188.92]:35735) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iQqxu-0001IE-49 for 14647@debbugs.gnu.org; Sat, 02 Nov 2019 06:49:07 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:52210) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1iQqxo-0000Vo-IX; Sat, 02 Nov 2019 06:49:00 -0400 Received: from [176.228.60.248] (port=1517 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1iQqxm-0001Ii-QE; Sat, 02 Nov 2019 06:48:59 -0400 Date: Sat, 02 Nov 2019 12:49:04 +0200 Message-Id: <834kzmk0yn.fsf@gnu.org> From: Eli Zaretskii In-reply-to: <87k18jwlmc.fsf@gnus.org> (message from Lars Ingebrigtsen on Fri, 01 Nov 2019 18:29:47 +0100) References: <4430da9a-9455-46dd-bc0d-1177123e147e@default> <87lhxmw0cj.fsf@building.gnus.org> <87k18jwlmc.fsf@gnus.org> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Spam-Score: -2.3 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 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: -3.3 (---) > From: Lars Ingebrigtsen > Date: Fri, 01 Nov 2019 18:29:47 +0100 > Cc: 14647@debbugs.gnu.org > > Lars Ingebrigtsen writes: > > > Drew Adams writes: > > > >> 1. Neither the Elisp manual (node `Attribute Functions') nor the doc > >> string says what form the string FONT must or may take. > > > > Good question. The function is barely used in the Emacs source code > > tree. The only usage I could find that set it to something was this: > > > > (defvar gamegrid-font "-*-courier-medium-r-*-*-*-140-100-75-*-*-iso8859-*" > > "Name of the font used in X mode.") > > But it's basically any string that describes a font on your system, > depending on what font system you have. So "futura:size=20" works fine, > too. That's inaccurate. The function accepts any form of the :font attribute, including font objects etc., but this is a command, and interactively it only allows strings. Also, "futura:size=20" might not work on MS-Windows, where these forms are emulated by Emacs (since there's no Fontconfig); you may need to use "Futura-20" instead. > >> 2. The manual says that this command sets the :font attribute. The doc > >> string says instead that it sets attributes :family, :foundry, :width, > >> :height, :weight, and :slant. Which is it? Both, actually. > > Yeah. > > It looks like it's the latter, so I've altered the documentation in the > manual. I've now altered the docs again to say that :font is set, and the other attributes are also set. > >> 3. #1 is all the more imporatnt because the doc string of `x-list-fonts' > >> says that it returns a list of strings that are "suitable as arguments > >> to `set-face-font'. Really? Just what kind of strings are so suitable? > >> > >> I think, but am not sure, that FONT must be in XLFD form. Whatever the > >> acceptable form(s), the doc needs to spell this out. > > I don't think so -- we aren't told what the form is, because that seems > unnecessary. If we're curious for some reason, we can just call the > function. The various forms are documented in the Emacs manual, under "Fonts". A cross-reference leads there from the ELisp manual.