From debbugs-submit-bounces@debbugs.gnu.org Mon Jan 31 10:57:56 2022 Received: (at submit) by debbugs.gnu.org; 31 Jan 2022 15:57:56 +0000 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 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 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 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 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== 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 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 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= 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 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 From: Drew Adams To: "bug-gnu-emacs@gnu.org" Subject: 26.3; Doc of the font of a given face Thread-Topic: 26.3; Doc of the font of a given face Thread-Index: AdgWuy7kvgadODteQGK/Ai4F2yCA7g== Date: Mon, 31 Jan 2022 15:57:23 +0000 Message-ID: Accept-Language: en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: 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: =?us-ascii?Q?+b3CGYUznvoYf9O0QeDlf78hf7JHLPcZiVsO1vHNoIknA2AoG5x+mC3ZI/f0?= =?us-ascii?Q?hWHmrEfVp2Ck2paXP9jfnznqogt0kyG7x4JvjDM6ecTCNeW3ZILAuolvHBEP?= =?us-ascii?Q?KTBYtxQuo2iO8HRSAZuHm44QG4gNLKr+dcIBjGD18iwyaAur+rNNGTPndiI5?= =?us-ascii?Q?YEq54AwmxXJ3BeIfG8aetU0D7gT1Ds3Gkx3iDuRvsWoMIh3dYn7K3W/GRaDb?= =?us-ascii?Q?fTeSjz4YwmBjUe9oiTBFhitFLrCN+fYn3DPPyeErgWs7/PMlw1FVeTMQ4YBV?= =?us-ascii?Q?iNWy0aEHLWOHOPS1dSPHpoY+lUodb8XHVXZ7RsBSbuaqNbV4VfHMd2gRR6n6?= =?us-ascii?Q?C3oyEn1K2pqakF9CcwbbPSIC41bEDYMARW+/H/PtaGlZ09/dLsQloPQSHmzP?= =?us-ascii?Q?+PehNdru9GzSKSZVzZB9psFAQIbtghpEpWQ2VhVbM5B+OcpdBuqU0nangqrl?= =?us-ascii?Q?NrUaOF/fTNzoqyMZqiuWFGYLQI7/0bGW70CeXw+cB8lcrKKimhp3/9h6hS2f?= =?us-ascii?Q?FjtZGXLpcvarxIweIvJ+boiwHPzRlgNg81U5PyIwtS+jTf7yUYzQhnw8lSOm?= =?us-ascii?Q?Nm787gncL4l5TRFBvjIvIPfCQ5y3QZ1pk/I3iHHeU667od+nMvHPl1ave3Eq?= =?us-ascii?Q?cVsyWtUoySdv3K3rrcSbpC9wGhrx7HTUoqPGST3LHh/TZI8xbhIly4cJZwcp?= =?us-ascii?Q?gjtNiyTj+x5yIEow2XyZY+TUD+miAPZEXDxD4HHhdLZ6iboKqkDjqrjbKyTI?= =?us-ascii?Q?E5rgbzjR43j5BnUQklksLBiIHW3jAe79uPzocaBrua05iimoR73oaH/5h6tK?= =?us-ascii?Q?fmT7h7co1rnIqvPoOTcPJgII7jwsMHSl3TYnZY0j4K2U4o6knY3OUHhhSQZV?= =?us-ascii?Q?VQx8drPwROq0Gj8/h7XGBprxBZimUKnTu/yopWZfa/55huw0WR832zaOGbS1?= =?us-ascii?Q?EnXnOATfrjVNnNuBFB75KxqOkDpEFQjnNVFWqMQYnET6I1k4lSR/Fbwx3nEI?= =?us-ascii?Q?R0j3w4abMdFMDcFnW2dalyC48zDGnZy9L4j034kDROwDBlW8D/NcTlTmqTGm?= =?us-ascii?Q?jD9pZEqbecDYZyd3q/q3CBj2xHEFXtec/Q+TrgApxgrDSFihD12m8Kl4iP53?= =?us-ascii?Q?S0bw55DfcT6B7O5e18p0x5j8grio/L8ZM9bjqHI7zncWiZs7oncTvY1Oz1l5?= =?us-ascii?Q?TfNroiP/oHOZWCGkb19XxGog6iUDDyz0N9m4BX2pegChzsPdcuzJ8DPrDSlo?= =?us-ascii?Q?Q21JLijQYvGHBn/8GfQlXsIKwio0xqa48t1aTgu1j0DCsLY4zsrsVuYuxqOd?= =?us-ascii?Q?iL1d6MAnKG/u7Eq6vsOwKoLT8Mz8pZ0hATJb2umCoDovFilLK1B6+YvVCo5A?= =?us-ascii?Q?vRb8yKrWBBW/I8nlFOo3J9SrnKCS4fwR2N4tiJhnjGDmJjK0/h5ZltE2eQqe?= =?us-ascii?Q?f3oi9B1GidZjJsaIbHwxYtA0I/qnUCiASZ1IPiYyKbIb/cmW2q07k+XYJn4r?= =?us-ascii?Q?TnIVwclD5PRUjnJVG0tz4krP2WRxflZLkPs7uChN1aMwO03/P+opT1NrfAyA?= =?us-ascii?Q?FvEZLKuxfPydSJkimjp3RFiC0IUxdRnnWvBn9VIZJsdqi8cX+c2KcBQOA6Tl?= =?us-ascii?Q?zQ=3D=3D?= Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 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-Spam-Score: -1.3 (-) X-Debbugs-Envelope-To: submit 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: -2.3 (--) 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'' From debbugs-submit-bounces@debbugs.gnu.org Mon Jan 31 12:41:19 2022 Received: (at 53664-done) by debbugs.gnu.org; 31 Jan 2022 17:41:19 +0000 Received: from localhost ([127.0.0.1]:40661 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nEag2-0001Ux-Sr for submit@debbugs.gnu.org; Mon, 31 Jan 2022 12:41:19 -0500 Received: from eggs.gnu.org ([209.51.188.92]:52158) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nEag1-0001Ud-Ia for 53664-done@debbugs.gnu.org; Mon, 31 Jan 2022 12:41:18 -0500 Received: from [2001:470:142:3::e] (port=52048 helo=fencepost.gnu.org) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nEafu-0004mt-M5; Mon, 31 Jan 2022 12:41:12 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=ggcHJi2a5iQBMicCuOwLcmZ2LRb7FRZ2gspiEruX1Is=; b=XxwS4qU5fL8s HBhJ+W0HcSiqnVSA4gHrbJV+ouviZ9SL6ADlthNF8rwhAV8SW7TmAK/83tfwPox/cfiGp0SsGG5Y0 +RoqnxiWi3KetLHt4UDJ4KTjh2VW67+a6wlC8ivuUQ7cKSifk0nC+oZnUMb6Af6vb1OqqHa/qqtG6 h7/DxdNXBcom2lQCV6G6A+abq6Q4Nf625gJBgk5NZdhhwGoGgoSOgwXyoPmfmfhpuxPk+z3yPkoP1 ADxgH2d/Hu+zXAvTimUbOs7u4CuUIu58eG32kF2lQ8oXb8qGBO3jJM3AaP8u3dgsQWwJ/msCBxC7Q WeNenz1aqnHw6jgDPqghDw==; Received: from [87.69.77.57] (port=4931 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nEafs-0008G5-MI; Mon, 31 Jan 2022 12:41:10 -0500 Date: Mon, 31 Jan 2022 19:41:05 +0200 Message-Id: <83fsp3951q.fsf@gnu.org> From: Eli Zaretskii To: Drew Adams In-Reply-To: (message from Drew Adams on Mon, 31 Jan 2022 15:57:23 +0000) Subject: Re: bug#53664: 26.3; Doc of the font of a given face References: X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 53664-done Cc: 53664-done@debbugs.gnu.org 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: Drew Adams > Date: Mon, 31 Jan 2022 15:57:23 +0000 > > 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. Note: A face always has more than one font: if the user didn't specify a fontset, Emacs will use the default fontset for characters that cannot be displayed by the face's font. > 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 of the function in the manual is quite short, and we expect the readers to read it in its entirety, not just the first sentence. It is customary in our documentation to start with describing the default behavior, and only go into the details of non-default one later -- this usually makes the description clearer and easier to understand for the usual case. So I didn't make the first sentence fuzzier, but instead fixed the description of how CHARACTER arg is used (because it was inaccurate). > 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. That is incorrect: fontsets don't affect face names. Maybe you meant FONT instead of FACE, but then this just repeats what the documentation already says in other words. > 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. I'd rather not go there. What exactly happens when you specify a fontset for the :font attribute is complicated, and doesn't really do what you think it does. I did add there a note that if the value is a font, it's for ASCII characters. > 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. I don't want to advertise this possibility, it wasn't supposed to be used by applications. And with that, I'm closing this bug report. From unknown Fri Aug 15 19:28:58 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Tue, 01 Mar 2022 12:24:08 +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