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#60168: 28.2; Doc string of `face-spec-recalc' Date: Sat, 17 Dec 2022 20:57:48 +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="17495"; mail-complaints-to="usenet@ciao.gmane.io" To: 60168@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sat Dec 17 21:58:13 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 1p6eG5-0004Nu-61 for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 17 Dec 2022 21:58:13 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1p6eFw-0004Gr-0m; Sat, 17 Dec 2022 15:58:04 -0500 Original-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 1p6eFv-0004Gb-63 for bug-gnu-emacs@gnu.org; Sat, 17 Dec 2022 15:58:03 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1p6eFu-0003Sf-UX for bug-gnu-emacs@gnu.org; Sat, 17 Dec 2022 15:58:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1p6eFu-0001d4-BD for bug-gnu-emacs@gnu.org; Sat, 17 Dec 2022 15: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: Sat, 17 Dec 2022 20:58:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 60168 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.16713106806254 (code B ref -1); Sat, 17 Dec 2022 20:58:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 17 Dec 2022 20:58:00 +0000 Original-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 Original-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 Original-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 Original-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 Original-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== Original-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 Original-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 Original-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= Original-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 Original-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 Thread-Topic: 28.2; Doc string of `face-spec-recalc' Thread-Index: AdkSWfhIqxAgtk5YRHaAgfxYBsyE/g== Accept-Language: en-US Content-Language: en-US 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: OSpCelVTlEdlyez1SQYvTH0o/GJQ/6mExpetFPNs7Rah5Ie/VTZAZZBkh5kpOld2eeel89dHeyySJg2lyUJftiCUjnqTXzOWZA+O2rONID7dGkHIRfuq8vcH+07VpxrwfVqf02YtX8vCpLjFS/YTCmJenaxP56yVGawo3LlefbjY5hiQGfbmJb1nkDz64ZSvPIpUTkesh643BV4Y0QQ/tB36FrcdFMVVIbw58G/NNzFnjAv0xXZa8Ye+1ci0fq7DQOO0ovazIWVYuxyoyHdYz8LKdoZz3GarxbPLj2E9X39fBltM5sxpA/98haXNoVKUiCtn9yYnx6nSBsUDpm3LzxQukvYgYXCjm2N0M+nVpb9zLwcy9zJpulKrYVDhbLbAwE+4YFEb6UPlYOzPho3CGU3CF2U2jJcGT8sYlO23nGUYUM71IL0x0UNgSwIqN9tiCjZoRThivv+c6TZyHjEdkm9WNoJGe+M2Ag/HoxM+kM2X/ofQYNKJP/pIyE9JUXC9gAgUWSehNcxo2f2lqQ0aPYnNruZ6eGR1tMqzwE/haqwzWBgLyAMl4L8VoUekXtqrxXZwQc16ObGLD64YFAXm6WdJ6KT+oJZbMwNtBnBbv+m8Wv4MXm5Sif6H3AWwzbGLmv3jQyx1drPyhxzZK8xVg2iKCE23MYNK8DY69ow+fpr0rxTkgYfn+rF37iQhvpwk6Q3AusyyitFpd7CR6qfm6ZbS/8YiMttLW3+8oGmCs/LRVhESC2WYffYHkW Xif4BPvRfqa7kc89ytKgDItkVWxYpDta2T9cNDuMNR4c+uibNCiLgpugwoWl9kmJuXWfX/w6/RPktuDnwOnDUQ2t4Wrxioos3a 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-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-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.bugs:251313 Archived-At: 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)