From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#53664: 26.3; Doc of the font of a given face Date: Mon, 31 Jan 2022 15:57:23 +0000 Message-ID: Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="19075"; mail-complaints-to="usenet@ciao.gmane.io" To: 53664@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Mon Jan 31 17:13:49 2022 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1nEZJK-0004fk-U1 for geb-bug-gnu-emacs@m.gmane-mx.org; Mon, 31 Jan 2022 17:13:47 +0100 Original-Received: from localhost ([::1]:39610 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1nEZJC-0005h3-Ke for geb-bug-gnu-emacs@m.gmane-mx.org; Mon, 31 Jan 2022 11:13:43 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:57390) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nEZ47-00032i-2N for bug-gnu-emacs@gnu.org; Mon, 31 Jan 2022 10:58:03 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:47466) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1nEZ46-00045L-CL for bug-gnu-emacs@gnu.org; Mon, 31 Jan 2022 10:58:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1nEZ46-0003kx-8l for bug-gnu-emacs@gnu.org; Mon, 31 Jan 2022 10:58:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 31 Jan 2022 15:58:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 53664 X-GNU-PR-Package: emacs X-Debbugs-Original-To: "bug-gnu-emacs@gnu.org" Original-Received: via spool by submit@debbugs.gnu.org id=B.164364467614422 (code B ref -1); Mon, 31 Jan 2022 15:58:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 31 Jan 2022 15:57:56 +0000 Original-Received: from localhost ([127.0.0.1]:40369 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nEZ40-0003kV-2C for submit@debbugs.gnu.org; Mon, 31 Jan 2022 10:57:56 -0500 Original-Received: from lists.gnu.org ([209.51.188.17]:53548) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nEZ3z-0003kP-6X for submit@debbugs.gnu.org; Mon, 31 Jan 2022 10:57:55 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:57278) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nEZ3w-0002sU-Nx for bug-gnu-emacs@gnu.org; Mon, 31 Jan 2022 10:57:54 -0500 Original-Received: from mx0b-00069f02.pphosted.com ([205.220.177.32]:42874) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nEZ3r-0003zE-43 for bug-gnu-emacs@gnu.org; Mon, 31 Jan 2022 10:57:52 -0500 Original-Received: from pps.filterd (m0246630.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.16.1.2/8.16.1.2) with SMTP id 20VFjEwh009520 for ; Mon, 31 Jan 2022 15:57:27 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=from : to : subject : date : message-id : content-type : content-transfer-encoding : mime-version; s=corp-2021-07-09; bh=NapE/7kJBKLpgybWnyMlHtvoNE6OIlvUxiBbvhqKrQ8=; b=DFq5v178BJxu7Bdb8ttPINsH/Gfqt5xCeigVXN5PjOw+d/1swDbpVxCJxTbpw6jAvswV Ih9RuXPva3vgRd95PDHXr1UPSqjyb/S24P2NVyRxAz/kDfWhbYVSYdzmGEVaierAcmGa 1qzRR5Lvk0mOwcd/TnvL0+Z2UAlBMSucEBnpLtMrfH3AAi7CktV1otM36cyY3BPgeEVx CDO5BrJkc5uMILkF3w2mPTVaBtfWjcF/YncwN/MrEeYonJiRUd5knq2Vx2KOzhIWrAeQ UYcsIey6Qk+YguBtHIT+tInRIx5DeY4mM8Isqa9TzDyPnq0+P2DHP8/EKIVXxieUS/oN Ag== Original-Received: from userp3020.oracle.com (userp3020.oracle.com [156.151.31.79]) by mx0b-00069f02.pphosted.com with ESMTP id 3dxj9w845f-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Mon, 31 Jan 2022 15:57:26 +0000 Original-Received: from pps.filterd (userp3020.oracle.com [127.0.0.1]) by userp3020.oracle.com (8.16.1.2/8.16.1.2) with SMTP id 20VFuFf9076044 for ; Mon, 31 Jan 2022 15:57:25 GMT Original-Received: from nam11-dm6-obe.outbound.protection.outlook.com (mail-dm6nam11lp2170.outbound.protection.outlook.com [104.47.57.170]) by userp3020.oracle.com with ESMTP id 3dvy1n03rm-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Mon, 31 Jan 2022 15:57:25 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=Uw1acHbvQpJEp9VrT+ID8Q1MMrBkuusx4a+cVuEXwbDitfw/6IXZ3XrYE0PQYDFJq7TLBMDZkheDWHkTZGetiSXNmgLr53e0Bfowmxm+b0LoRlLw9diFwI+xQVimHM4ukj7vFujj2VWn4wADme04OxHpDXNBFE8SslQA9XlkWQkrrf5sEoqczG9UdJ4KxjbXzwbhFL6ZypcK/Uryr4HbHH/0aJO4HVqy7q8tqHMNTDN+J4OxnJaZKtf6jbXfk5MBytLTCNEUomA/mCB8cj0NIwMuEZ+ifCE7rD3TnsDBYJpXtmtRX03Uehx5ulEYxbS+apSt3zXUEy5ZU3BONhtL5w== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=NapE/7kJBKLpgybWnyMlHtvoNE6OIlvUxiBbvhqKrQ8=; b=Qcpkb1EdcyLKfBpSkqVa/zbbDc+8+COjzQHKUqneZDxTlDa/AbzS2qxEXtqdKXqVXxbV2KjeaQyHkiZ5sa153SwF3jzVo5SDYvd7FBPt6ezHcQc3yzQfphwJu86YDrhRfJZCav8pwdHhIzmB/qbvgLABIJrcMRQEsoctEByP09HyYu0OaEDdxhNIm09mRXXzCVxdCHsalf5lmKIt36XwOHVp9C5UxxwJjiNN+5mXNRHHBADW8KnmgBbz9duZ8vcde4X4BkAQMYyDPh73Dht52TpwsQVeiHs8YaDRzydcMYb/Ihfkvywm3bIrnmdXorVaXhNLhAX7Ez4PQ32JNOQYig== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=none; dmarc=none; dkim=none; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.onmicrosoft.com; s=selector2-oracle-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=NapE/7kJBKLpgybWnyMlHtvoNE6OIlvUxiBbvhqKrQ8=; b=RKkMumVhQMYTu+rVPW9+NZ6uVO6XiTXaAGJpRSEd1p/SQIXDiVjNu2BLB4s9TDLn5KUHW0Fqrr4yVoF5PSSe5LSPTcfOgM4KVb0ozuDd/kS8gBEBII7Sn9dVEsrNByZSAaX4N9rQJe6qzN+LvCQgsXBA6f3XGeuVxtNd6zlsFV0= Original-Received: from SJ0PR10MB5488.namprd10.prod.outlook.com (2603:10b6:a03:37e::19) by PH0PR10MB5706.namprd10.prod.outlook.com (2603:10b6:510:148::10) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4930.20; Mon, 31 Jan 2022 15:57:23 +0000 Original-Received: from SJ0PR10MB5488.namprd10.prod.outlook.com ([fe80::99a4:696f:5f30:36b3]) by SJ0PR10MB5488.namprd10.prod.outlook.com ([fe80::99a4:696f:5f30:36b3%6]) with mapi id 15.20.4930.022; Mon, 31 Jan 2022 15:57:23 +0000 Thread-Topic: 26.3; Doc of the font of a given face Thread-Index: AdgWuy7kvgadODteQGK/Ai4F2yCA7g== Accept-Language: en-US Content-Language: en-US x-ms-publictraffictype: Email x-ms-office365-filtering-correlation-id: 76608180-79f8-4b07-eaef-08d9e4d25ed2 x-ms-traffictypediagnostic: PH0PR10MB5706:EE_ x-microsoft-antispam-prvs: x-ms-oob-tlc-oobclassifiers: OLM:7691; x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: /LBBMpJlmU/UqRcqBEyd5ZvgCQWCGUKTgoAaJ8w+A4wr/rXpV9Z2ic7YJx8vHa44ICIItuTkdKIk97n20Ru7n4lbtGDyZDcznIWnw9cgCGSzAh0W5jEm25704Y4jalftdY1wQeEoICDfhSXbNxFg9vpJCbWUgi0C43ov0oQK74iR4hR9qWB02Ib74jV+vNQGdOVL9vhJXA/38EHPHwe8DM0UJEoSZjBhKuLDMtxJHyRmfF6OiO1NCSDkocPU1xQRmje+jmmMQX8xjzzfHaYTUuaJE4a4QMBM3WJdlv7K0VB841SRYV+eZyQLa493IEKVkjNQiZAJ0qD70NYPkVNgYJLxrFJkCYGo8HHVAyDUfnpF3nhQRXFMkWWPAfz9aXj7q1xcR0zs6570uHQDgJRdWQb0nVv9b/r/g/HrjXytPHkflW5XadHzvnmODpJhFHl1ZGsOy0eXEQ/VtnFqFGMWfOkEJGP5fs4KRUbMB1ETPk5xPukjqTkODTZSpCoh6v0nBol/MVVcZvYhxLvhpDaHCW3ieYriJXPnG6v4AqwsZ6PMLvLbzHM7AmcQDIXTCihWHmwwjszy00SuFfC1rnMxC5c7vMgfsdkOYvwv+jQwSwM/axja51jsW+TQo6HUU2Q993Zqgyj/HMRAqc9CpsVXLsbQh+nA3YND1bNu3AkQGjEj6unlk+/4W1w0r9zWIj/f7jLeu7qKgIhK6WJxr/+YSA== x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:SJ0PR10MB5488.namprd10.prod.outlook.com; PTR:; CAT:NONE; SFS:(13230001)(366004)(38100700002)(122000001)(52536014)(508600001)(5660300002)(44832011)(8936002)(2906002)(76116006)(64756008)(66446008)(66476007)(66556008)(316002)(186003)(8676002)(66946007)(26005)(71200400001)(45080400002)(9686003)(7696005)(6506007)(38070700005)(33656002)(86362001)(55016003)(6916009)(20210929001); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: +b3CGYUznvoYf9O0QeDlf78hf7JHLPcZiVsO1vHNoIknA2AoG5x+mC3ZI/f0hWHmrEfVp2Ck2paXP9jfnznqogt0kyG7x4JvjDM6ecTCNeW3ZILAuolvHBEPKTBYtxQuo2iO8HRSAZuHm44QG4gNLKr+dcIBjGD18iwyaAur+rNNGTPndiI5YEq54AwmxXJ3BeIfG8aetU0D7gT1Ds3Gkx3iDuRvsWoMIh3dYn7K3W/GRaDbfTeSjz4YwmBjUe9oiTBFhitFLrCN+fYn3DPPyeErgWs7/PMlw1FVeTMQ4YBViNWy0aEHLWOHOPS1dSPHpoY+lUodb8XHVXZ7RsBSbuaqNbV4VfHMd2gRR6n6C3oyEn1K2pqakF9CcwbbPSIC41bEDYMARW+/H/PtaGlZ09/dLsQloPQSHmzP+PehNdru9GzSKSZVzZB9psFAQIbtghpEpWQ2VhVbM5B+OcpdBuqU0nangqrlNrUaOF/fTNzoqyMZqiuWFGYLQI7/0bGW70CeXw+cB8lcrKKimhp3/9h6hS2fFjtZGXLpcvarxIweIvJ+boiwHPzRlgNg81U5PyIwtS+jTf7yUYzQhnw8lSOmNm787gncL4l5TRFBvjIvIPfCQ5y3QZ1pk/I3iHHeU667od+nMvHPl1ave3EqcVsyWtUoySdv3K3rrcSbpC9wGhrx7HTUoqPGST3LHh/TZI8xbhIly4cJZwcpgjtNiyTj+x5yIEow2XyZY+TUD+miAPZEXDxD4HHhdL Z6iboKqkDjqrjbKyTIE5rgbzjR43j5BnUQklksLBiIHW3jAe79uPzocaBrua05iimoR73oaH/5h6tKfmT7h7co1rnIqvPoOTcP X-OriginatorOrg: oracle.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-AuthSource: SJ0PR10MB5488.namprd10.prod.outlook.com X-MS-Exchange-CrossTenant-Network-Message-Id: 76608180-79f8-4b07-eaef-08d9e4d25ed2 X-MS-Exchange-CrossTenant-originalarrivaltime: 31 Jan 2022 15:57:23.4000 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: 4e2c6054-71cb-48f1-bd6c-3a9705aca71b X-MS-Exchange-CrossTenant-mailboxtype: HOSTED X-MS-Exchange-CrossTenant-userprincipalname: uR2Mgafve3xbq8m0KDuyZGSCV2/Fcod3gljBsH5T1aI5IHD6WVRQIRpYFH6orcGXROt4qSvDlfF73jp2oPoSnw== X-MS-Exchange-Transport-CrossTenantHeadersStamped: PH0PR10MB5706 X-Proofpoint-Virus-Version: vendor=nai engine=6300 definitions=10244 signatures=673430 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=0 mlxscore=0 spamscore=0 bulkscore=0 adultscore=0 mlxlogscore=999 phishscore=0 malwarescore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2201110000 definitions=main-2201310104 X-Proofpoint-ORIG-GUID: 7ovKsRdkEsk_zOMftLzgKiU3AzeODEqT X-Proofpoint-GUID: 7ovKsRdkEsk_zOMftLzgKiU3AzeODEqT Received-SPF: pass client-ip=205.220.177.32; envelope-from=drew.adams@oracle.com; helo=mx0b-00069f02.pphosted.com X-Spam_score_int: -27 X-Spam_score: -2.8 X-Spam_bar: -- X-Spam_report: (-2.8 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_LOW=-0.7, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list 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-mx.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.io gmane.emacs.bugs:225680 Archived-At: The Elisp manual doc about the font(s) of a given face is clear, if you read it carefully and completely. But it could be a bit more clear, in particular when it comes to a face having more than one font. This can happen if attribute :font is a fontset. But a face has only one :font attribute, and by itself the name :font can be a bit misleading. The description of function `face-font'says that the same face can use different fonts for different chars, but it starts by talking about "the font": This function returns the name of the font of face FACE. ^^^^^^^^ ... the font name used for CHARACTER. ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ That first sentence can mislead. Maybe say something like "the font of FACE for a given character, or for all characters if its :font attribute is not a fontset"? The description doesn't say anything about fontsets currently. Maybe it should, to make the relation clear here. Maybe we could add something like this? The name of FACE can be different for different chars if the :font attribute for FACE is a fontset. Other parts of the doc about faces: ':font' The font used to display the face. ^^^^^^^^ Its value should be a font object or a fontset. It might help to put that info in the first line: The font or fontset used to display the face. The description of `set-face-font' says that it sets the :font attribute, which is correct, and if you consult the doc for that attribute you find that the value could be a fontset. But it might help if the description of `set-face-font' said something like this: This sets the :font attribute of FACE to FONT, which is a font or a fontset. In GNU Emacs 26.3 (build 1, x86_64-w64-mingw32) of 2019-08-29 Repository revision: 96dd0196c28bc36779584e47fffcca433c9309cd Windowing system distributor `Microsoft Corp.', version 10.0.19043 Configured using: `configure --without-dbus --host=3Dx86_64-w64-mingw32 --without-compress-install 'CFLAGS=3D-O2 -static -g3''