From debbugs-submit-bounces@debbugs.gnu.org Sat Dec 17 15:58:00 2022 Received: (at submit) by debbugs.gnu.org; 17 Dec 2022 20:58:00 +0000 Received: from localhost ([127.0.0.1]:57948 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1p6eFs-0001co-2c for submit@debbugs.gnu.org; Sat, 17 Dec 2022 15:58:00 -0500 Received: from lists.gnu.org ([209.51.188.17]:37758) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1p6eFp-0001ci-5P for submit@debbugs.gnu.org; Sat, 17 Dec 2022 15:57:58 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1p6eFo-0004GH-W1 for bug-gnu-emacs@gnu.org; Sat, 17 Dec 2022 15:57:57 -0500 Received: from mx0a-00069f02.pphosted.com ([205.220.165.32]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1p6eFn-0003SE-Br for bug-gnu-emacs@gnu.org; Sat, 17 Dec 2022 15:57:56 -0500 Received: from pps.filterd (m0246627.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.17.1.19/8.17.1.19) with ESMTP id 2BHIjFYt013036 for ; Sat, 17 Dec 2022 20:57:53 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-2022-7-12; bh=xf078joZfBny5EtySThC6Q7YsUIG/ElClez6/rkNUuk=; b=aVYybxKIhjviDebJdizv9sSJIzuxh1b/9gq5duWI4AagcrPRmMZmLyyWTMxD9lSgtsVm WqSBw0Bd2a22bxfkSv3/Wno0vpLXhuBJ4SY8ohvSNnB/LOXYmgo40W9nrvhLOweqpgCo cZr6v1HjjV04y1RnNGMQWRgNTgdPuRGsRPW2lkVX0sYhSF8VhmcuzLVEeBB8+3PdgzYl oT5mOWeYDLdew5YoMLcMaAVgqp8Vq4BVZwQXFbm8Wg+hnDT9IlgzuHGEoDOWqFvE2jUj r9MelUWVtBrHSrfCciO176qfozNxH8dCUQdGQfj/49W1LgYHUbGz7icD/hrgEmv9t6g2 6Q== Received: from phxpaimrmta02.imrmtpd1.prodappphxaev1.oraclevcn.com (phxpaimrmta02.appoci.oracle.com [147.154.114.232]) by mx0b-00069f02.pphosted.com (PPS) with ESMTPS id 3mh6tqrpmy-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Sat, 17 Dec 2022 20:57:53 +0000 Received: from pps.filterd (phxpaimrmta02.imrmtpd1.prodappphxaev1.oraclevcn.com [127.0.0.1]) by phxpaimrmta02.imrmtpd1.prodappphxaev1.oraclevcn.com (8.17.1.5/8.17.1.5) with ESMTP id 2BHKWJ5K012675 for ; Sat, 17 Dec 2022 20:57:52 GMT Received: from nam02-bn1-obe.outbound.protection.outlook.com (mail-bn1nam02lp2044.outbound.protection.outlook.com [104.47.51.44]) by phxpaimrmta02.imrmtpd1.prodappphxaev1.oraclevcn.com (PPS) with ESMTPS id 3mh471wu7w-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Sat, 17 Dec 2022 20:57:52 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=JSq7WV16HgbwEgFLyHw3dQTJRysj7Q7aruqFqO1E7I09jvd0/VX2RCmBXamv/G3d4t86Zd+q5QIrYFYf32x48As1SBG4j1nH5O9w9BzCtloVo0kiurRB9zQTXC/XgTb0SrLFjRAe1+r7RBKHmDOTW+//ss/vBZXc2w52JHaDi3r2Rcjmn/+qYhDmRvNV5ChbvXhX8Mf1d+kExO5W9bwgxON0n2Rd0I9mdKPJ8yQSQy6HNfCOxLzQ1Xv5etw+dltXT0XkaWrWCVJNmQOGeryEleJ30kqOwC9c6D9iMg6fF+ozipT92gLconePC5lqt13bWUpZAHUY1j3a8PzXMQ0ARg== 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=xf078joZfBny5EtySThC6Q7YsUIG/ElClez6/rkNUuk=; b=OCSBgKC009aKyobUj6dp0269KYj9VVC6zYfS6OtXMlPsf8iz3VIjFJdUz4hqExH7vx+F8/utXK83wtkSv3RNArTFKoqpTizYzX8kBjCVTK0rl72sOdAyQgx+eGK7fVVl7UvYk32hKDuF+yUguB567SfbrCozI7dthF4PWH3DcqF/fUVUx22jMQ+su1igK5iRywM3kBp/7TlMxGT1dLsC8zwI7/fX+YJylc9s4VvzGULzS9JWaBl34pCf7yp+kni+c2ofCRqLoIlDtNAMLATZ+fx1cYMAF4wqVjUN5KJgr66qbO5+gr3szXECmAU30sw1UOvAsK+AzxywcA62YMi8Zg== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=oracle.com; dmarc=pass action=none header.from=oracle.com; dkim=pass header.d=oracle.com; 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=xf078joZfBny5EtySThC6Q7YsUIG/ElClez6/rkNUuk=; b=ShsFStTDWy11dROn/wIZAyQ/ogVSa4SUmNayHaY2tTB/AkvPb/XyHuOnX5xeJYVaGa+MtT4r2B3q6ghP+7w12sibref8k4lWAcS7+nGyh9nvnte2GZCtTkjAT4LLJnteKU/4OD1WloJSHn719FMQmRjd+reHjsJz4F7J1qgjnJs= Received: from SJ0PR10MB5488.namprd10.prod.outlook.com (2603:10b6:a03:37e::19) by SJ0PR10MB5766.namprd10.prod.outlook.com (2603:10b6:a03:3ee::12) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5924.16; Sat, 17 Dec 2022 20:57:48 +0000 Received: from SJ0PR10MB5488.namprd10.prod.outlook.com ([fe80::176d:3689:aa5b:91b]) by SJ0PR10MB5488.namprd10.prod.outlook.com ([fe80::176d:3689:aa5b:91b%2]) with mapi id 15.20.5924.016; Sat, 17 Dec 2022 20:57:48 +0000 From: Drew Adams To: "bug-gnu-emacs@gnu.org" Subject: 28.2; Doc string of `face-spec-recalc' Thread-Topic: 28.2; Doc string of `face-spec-recalc' Thread-Index: AdkSWfhIqxAgtk5YRHaAgfxYBsyE/g== Date: Sat, 17 Dec 2022 20:57:48 +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-traffictypediagnostic: SJ0PR10MB5488:EE_|SJ0PR10MB5766:EE_ x-ms-office365-filtering-correlation-id: 0528b002-4345-4073-3e13-08dae0715ad9 x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: +lANd3GN6+Xq1aRoLaT/2pzrg8EG8hupFiCwHVT7zN0G90n4ToI3KNAux4lSWYMshLoqUsQhzUS5yRjV6LEEESjfMUg6oAEDIsUIIkzBSFKmsRDV3Le/Jgr4od90lp8twxw79rKoH0yU9JShMzHNphk0ic/iYx8Vg5Cx1OmyTeVAswKQc59dNvvS8snAAvgQ8kkLOsm8S8c21o3g7M6kYWj0plIljsq1dhYwVhP5TcDOLllcamhdIdVdrXyQRJpJ4TZlTVv7kQHRs/OdqRH1uOsoep26ejWy/DCT6tthuOU3VpO8aDOvqkCTzmyJ5Fe6hrPTFFQKM9yM6WNXRqAXw1dJx2VtNgotTFI7Q4IGnhGv0XsZMQzaya8Y8pzv3C5zQf7ErhZayZwmN65ebbfLKMaiJnDtSUT0C54Fz/ey59Dq93AwT5aBUCmezxTKvnskyKknDy4UtHXD/reT5c1orP8ANEszWhcC4KVoS4n3I/0QLWvElxw7FWjtzTmhwwopwlYZ1y8WMY6oFLz1nEOjeUvS/G1DJHgtpcQVhr7oewyihYgBBC4ODJ40ZOyue6PQasN5j+FbvGBd6fPaauaYimdJof050vIL9fgMyqLsBdPjhkdUNY0hrRDHNwzBk5RHClBYoqhiTxQxBYO54xySdtKhhDpHUrrjKpL7kI2GTcf6ukMfZQNJxC2baM2Ml9pGRQs1hGgZ/LeUP6YWBmRqWsoMC7IW0Pp+y9yZHbcYCB4= 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:(13230022)(346002)(376002)(396003)(39860400002)(366004)(136003)(451199015)(7696005)(6506007)(86362001)(33656002)(186003)(26005)(9686003)(38100700002)(122000001)(38070700005)(55016003)(5660300002)(2906002)(52536014)(45080400002)(71200400001)(44832011)(8936002)(66476007)(64756008)(66556008)(66446008)(41300700001)(316002)(6916009)(8676002)(76116006)(66946007)(478600001)(81973001); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: =?us-ascii?Q?OSpCelVTlEdlyez1SQYvTH0o/GJQ/6mExpetFPNs7Rah5Ie/VTZAZZBkh5kp?= =?us-ascii?Q?Old2eeel89dHeyySJg2lyUJftiCUjnqTXzOWZA+O2rONID7dGkHIRfuq8vcH?= =?us-ascii?Q?+07VpxrwfVqf02YtX8vCpLjFS/YTCmJenaxP56yVGawo3LlefbjY5hiQGfbm?= =?us-ascii?Q?Jb1nkDz64ZSvPIpUTkesh643BV4Y0QQ/tB36FrcdFMVVIbw58G/NNzFnjAv0?= =?us-ascii?Q?xXZa8Ye+1ci0fq7DQOO0ovazIWVYuxyoyHdYz8LKdoZz3GarxbPLj2E9X39f?= =?us-ascii?Q?BltM5sxpA/98haXNoVKUiCtn9yYnx6nSBsUDpm3LzxQukvYgYXCjm2N0M+nV?= =?us-ascii?Q?pb9zLwcy9zJpulKrYVDhbLbAwE+4YFEb6UPlYOzPho3CGU3CF2U2jJcGT8sY?= =?us-ascii?Q?lO23nGUYUM71IL0x0UNgSwIqN9tiCjZoRThivv+c6TZyHjEdkm9WNoJGe+M2?= =?us-ascii?Q?Ag/HoxM+kM2X/ofQYNKJP/pIyE9JUXC9gAgUWSehNcxo2f2lqQ0aPYnNruZ6?= =?us-ascii?Q?eGR1tMqzwE/haqwzWBgLyAMl4L8VoUekXtqrxXZwQc16ObGLD64YFAXm6WdJ?= =?us-ascii?Q?6KT+oJZbMwNtBnBbv+m8Wv4MXm5Sif6H3AWwzbGLmv3jQyx1drPyhxzZK8xV?= =?us-ascii?Q?g2iKCE23MYNK8DY69ow+fpr0rxTkgYfn+rF37iQhvpwk6Q3AusyyitFpd7CR?= =?us-ascii?Q?6qfm6ZbS/8YiMttLW3+8oGmCs/LRVhESC2WYffYHkWXif4BPvRfqa7kc89yt?= =?us-ascii?Q?KgDItkVWxYpDta2T9cNDuMNR4c+uibNCiLgpugwoWl9kmJuXWfX/w6/RPktu?= =?us-ascii?Q?DnwOnDUQ2t4Wrxioos3aG4r6rIOm4FIuGBmAtohJN7l4Yc6GGeF121vIsH3G?= =?us-ascii?Q?og8+tl15p+rXuud3UJd/nEvmRyaaZ9z44gx/kgvAcr2cgBfvA5JhSN/gFgSC?= =?us-ascii?Q?Hfvb/YMKg03c2Xd+rBZVxeG/eRJPpmH+1ncOgwKBl4cC5ar+KLfbhrXuYBKM?= =?us-ascii?Q?vSOBsgNUXy7ghNyTJnoH0FKeJfSByzQw55UUX8ZEo9nsfft/HTbIXxSAYKSQ?= =?us-ascii?Q?UFWUWYfBCzR+kFSRo+4OENIyxVtqSlqpewqKbq1xTy7elbA0Z4WMmbxkwkJp?= =?us-ascii?Q?fYk3X8LH8jgOoBfH+W0ckHgYiSXjrW+smlcbAWzfuwFpqWixsADKIwhREEpk?= =?us-ascii?Q?d7yFHDgXQCcQ4dekzzIx3u6snu898hRsccaux4ehsmvGKXD04tu8BRN4Wp1m?= =?us-ascii?Q?nlFwQHj8/uTxR6+nq80jOV7q3lmye0SD3Lf+inLxs2rC9LnawdcXqdbnbynU?= =?us-ascii?Q?8tbeDmE+zHZ/0lbu4lnSpK2Wor9FqlEJ2KBR/vDuf75AK8R/83kBijcg3wvQ?= =?us-ascii?Q?oFI58/SXImBfilMhUXg7/v9SnDBHFWJ/jo+VmFjiMaSATBS7lvw0vEaC5myD?= =?us-ascii?Q?JXtuUrX65Bteqg64+HmO/olPNw76ZEnGCwJ/q8PD4siCFR1PJQy1cPwJttAW?= =?us-ascii?Q?44ezCbcKxUKYg/NWhB1fEZq3aZpyS2Gttn0neFOaNWJnvSpFEDOYp4jsAAuM?= =?us-ascii?Q?oN0EeJJi8arepMPr0AgVof1rVIRnlo8JjjehKYmb?= 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: 0528b002-4345-4073-3e13-08dae0715ad9 X-MS-Exchange-CrossTenant-originalarrivaltime: 17 Dec 2022 20:57:48.5990 (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: tOwhwMve7HkLUdwwhQClaHGAgrNwQYG2QJyCGOHlKz89bteJC1nqHbXSoELGqbe34Ayju3lQ7N9Grk/SC9Oo6A== X-MS-Exchange-Transport-CrossTenantHeadersStamped: SJ0PR10MB5766 X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.205,Aquarius:18.0.923,Hydra:6.0.545,FMLib:17.11.122.1 definitions=2022-12-17_09,2022-12-15_02,2022-06-22_01 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 bulkscore=0 phishscore=0 suspectscore=0 adultscore=0 malwarescore=0 spamscore=0 mlxlogscore=815 mlxscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2212070000 definitions=main-2212170196 X-Proofpoint-GUID: 2dDF_nuMFYo9B4nkejgnQPOmeiurAJnl X-Proofpoint-ORIG-GUID: 2dDF_nuMFYo9B4nkejgnQPOmeiurAJnl Received-SPF: pass client-ip=205.220.165.32; envelope-from=drew.adams@oracle.com; helo=mx0a-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 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 (--) I don't understand this doc string. What is the meaning of the indented occurrences of `|'? How is one supposed to read this? Are there 3 sources? 5 sources? 6 sources? Is `|' supposed to separate the sources (so there are only 3)? If so, how to understand the one that starts with `(theme...)' and ends with `(X resources...)'? Why are some things - which clearly are NOT code - in parens? Of what use are the parens here? Why `(defface default spec)' (parens) but `defface override spec' (no parens)? And lest someone claim that this is just a "helper" function or "internal": this is the meat of what `face-spec-set' does. If this isn't described here then it should be described for `face-spec-set'. (And in any case, the doc string here needs to be fixed or removed.) In GNU Emacs 28.2 (build 2, x86_64-w64-mingw32) of 2022-09-13 built on AVALON Windowing system distributor 'Microsoft Corp.', version 10.0.19044 System Description: Microsoft Windows 10 Pro (v10.0.2009.19044.2251) Configured using: 'configure --with-modules --without-dbus --with-native-compilation --without-compress-install CFLAGS=3D-O2' Configured features: ACL GIF GMP GNUTLS HARFBUZZ JPEG JSON LCMS2 LIBXML2 MODULES NATIVE_COMP NOTIFY W32NOTIFY PDUMPER PNG RSVG SOUND THREADS TIFF TOOLKIT_SCROLL_BARS XPM ZLIB (NATIVE_COMP present but libgccjit not available) From debbugs-submit-bounces@debbugs.gnu.org Sun Dec 18 04:01:13 2022 Received: (at 60168) by debbugs.gnu.org; 18 Dec 2022 09:01:13 +0000 Received: from localhost ([127.0.0.1]:60983 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1p6pXl-0003i9-9g for submit@debbugs.gnu.org; Sun, 18 Dec 2022 04:01:13 -0500 Received: from eggs.gnu.org ([209.51.188.92]:36706) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1p6pXj-0003hy-Kh; Sun, 18 Dec 2022 04:01:11 -0500 Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1p6pXe-0000M9-0K; Sun, 18 Dec 2022 04:01:06 -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=o1P7gPRhW6sNAp1DuU4rC4+/Q825PiYKgH9oJiuGG74=; b=qdl6ZOkXbRG0 iVv+P7tahzKuhbrJ86bH/aoTyyt21UYLHYekj7AJKsX5fSAlxhlcnjXGWQQRM1pid/8PjU+XbcYjn CD9It9eForoMsx8/rzSn2BS7d6Jsp5ja4rK7CDoir7YwFFIMj0wFmEdIoCeMXZL/CyOBNQPN9rUHk STbmU7pG4B0GJrEBW2jyj4lOVaDJV6h9xkOA5CIM3jWWrFqyoAGB5cK2wbd/+QNn0cznDWzDW8xx8 R/+YM3jSEOUsKgLF1IIbvpoo+GdnhYPWv+GmKyJwX5xuhJy/Pvj+XRUtYNjEKnCccWuRVOcPzfyTr CIa8FM1RkDW2VrmfB4xbJw==; Received: from [87.69.77.57] (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 1p6pXd-0000Hu-Cf; Sun, 18 Dec 2022 04:01:05 -0500 Date: Sun, 18 Dec 2022 11:01:12 +0200 Message-Id: <83v8m9f5lz.fsf@gnu.org> From: Eli Zaretskii To: Drew Adams In-Reply-To: (message from Drew Adams on Sat, 17 Dec 2022 20:57:48 +0000) Subject: Re: bug#60168: 28.2; Doc string of `face-spec-recalc' References: X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 60168 Cc: 60168@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 (---) tags 60168 notabug wontfix close 60168 thanks > From: Drew Adams > Date: Sat, 17 Dec 2022 20:57:48 +0000 > > I don't understand this doc string. You aren't supposed to, unless you are hacking on the face-related code (in which case the doc string is crystal clear). > And lest someone claim that this is just a "helper" function or > "internal": this is the meat of what `face-spec-set' does. If this > isn't described here then it should be described for `face-spec-set'. face-spec-set has its own doc string that explains what it does. Its doc string doesn't reference face-spec-recalc. The "meat" you mention is basically internal implementation details of how face spec is calculated and applied, something that doesn't belong to doc strings. If you have specific questions needed to understand how to define and use faces in Lisp programs, please ask those specific questions (probably in another thread). Or if you have specific questions regarding the face implementation and face spec (re-)calculation, please ask specific questions on emacs-devel. > (And in any case, the doc string here needs to be fixed or removed.) I disagree. There's no bug here that I can see. Closing. From unknown Mon Aug 18 19:31:37 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Sun, 15 Jan 2023 12:24:09 +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