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#54114: 26.3; Doc of `face-remap-add-relative' in (elisp) `Face Remapping' Date: Tue, 22 Feb 2022 17:22:32 +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="30169"; mail-complaints-to="usenet@ciao.gmane.io" To: 54114@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Tue Feb 22 18:25:34 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 1nMYur-0007fB-PO for geb-bug-gnu-emacs@m.gmane-mx.org; Tue, 22 Feb 2022 18:25:33 +0100 Original-Received: from localhost ([::1]:58850 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1nMYuq-0000gZ-Oy for geb-bug-gnu-emacs@m.gmane-mx.org; Tue, 22 Feb 2022 12:25:32 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:57086) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nMYsR-00061w-29 for bug-gnu-emacs@gnu.org; Tue, 22 Feb 2022 12:23:03 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:48625) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1nMYsQ-0007vb-Ou for bug-gnu-emacs@gnu.org; Tue, 22 Feb 2022 12:23:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1nMYsQ-0003kY-K7 for bug-gnu-emacs@gnu.org; Tue, 22 Feb 2022 12:23: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: Tue, 22 Feb 2022 17:23:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 54114 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.164555057714384 (code B ref -1); Tue, 22 Feb 2022 17:23:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 22 Feb 2022 17:22:57 +0000 Original-Received: from localhost ([127.0.0.1]:42522 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nMYsK-0003jv-Ib for submit@debbugs.gnu.org; Tue, 22 Feb 2022 12:22:57 -0500 Original-Received: from lists.gnu.org ([209.51.188.17]:32998) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nMYsI-0003jp-Fq for submit@debbugs.gnu.org; Tue, 22 Feb 2022 12:22:54 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:57028) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nMYsH-0005qI-Py for bug-gnu-emacs@gnu.org; Tue, 22 Feb 2022 12:22:53 -0500 Original-Received: from mx0b-00069f02.pphosted.com ([205.220.177.32]:10106) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nMYsE-0007sj-LB for bug-gnu-emacs@gnu.org; Tue, 22 Feb 2022 12:22: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 21MFTaJp024367 for ; Tue, 22 Feb 2022 17:22:35 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=k9xwojE9LAbVmA/MDCxhSBvyOTCSF5x0c7sHKNIxruw=; b=hrqNZSU8oZJWlXElcjMhtekLKuzgE43Aai3bsjNc1nkR/e7fjZMVUFGdJqOeQFY77Ujp bKa4oKw/QMjBA8KFHjSxQauNsHjLb78zo6W4KvnCthKCJBqqSAG/y9BGOTw83hGcUzjr yKKOUIHX/ufWF4zT73KhJLisp+u5fjbZzEXnuDg+UQxaRVYX4jBuF1toF+pA7G6Ss7C0 m5IlGFMK5ll85yPQADttkm+vmxdfRh2iIul+DlXRUQNagXqWksADvZS5uAVVCwEpiXsC 6/EcsJJmuhNIJ0gNOhah3HEatqNX8wVTumi4WiI/AVnCgVyPW2l/S1nvXhA01o4qqfS3 mQ== Original-Received: from aserp3020.oracle.com (aserp3020.oracle.com [141.146.126.70]) by mx0b-00069f02.pphosted.com with ESMTP id 3ecvar1haa-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Tue, 22 Feb 2022 17:22:35 +0000 Original-Received: from pps.filterd (aserp3020.oracle.com [127.0.0.1]) by aserp3020.oracle.com (8.16.1.2/8.16.1.2) with SMTP id 21MHASg3152064 for ; Tue, 22 Feb 2022 17:22:34 GMT Original-Received: from nam11-co1-obe.outbound.protection.outlook.com (mail-co1nam11lp2171.outbound.protection.outlook.com [104.47.56.171]) by aserp3020.oracle.com with ESMTP id 3eb4818tav-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Tue, 22 Feb 2022 17:22:34 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=MGEJlrB55Kc0norkui2HRWAoLz43bM056qrRWoOO4fEWlUPNQ8H+6r0R6EK5GAplmOmZI4yk2qyklrfj3X+Ie12kMwbM8o8boVJ+Hv1DkbvKKSG7Ix/KA5mGRhZvGeplmpfG3rHhaU1eEk1IuMBe4XjT57dU4jzoyRHmNuzrgJcnyZ5csTytXTyux36zsXInwyiXsG7a1bihs6R9xUIkzWp8OJc08xWU20WXDJcj8yUk+jwmfNUX1ScG251qd7A3Y8rdOqymbt7x2XEeRsW2JRLwZ94hRgu9rVjX6q26TrIU0WGWXkl/tcFaNYFzogVyXro7vk0RyZbWrkM8l1MzHQ== 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=k9xwojE9LAbVmA/MDCxhSBvyOTCSF5x0c7sHKNIxruw=; b=Jndb95l1vz1tFfjzKLFgavS2aqVj2PnzrCfVxIBnqIdhGHMHi6SzefQz82TEyICoNHXNbOquHGWn9nrbn9LM/dEoDsvPneGLE3dP4w41yIsrxNAo7wa8ktllqRiXc48FoiqNUQAKiIUGxryMorlNLv7OVVAJOqA03ll/rQIt3gwoepYs1bJk11Vh6Wq68pi+ANplvZfrGE3MIGqlH/Bw6PC2cyAzHVWKGHYiTko/TguPO5cQNwMziccLyHfA6E9hdn3TitBK33putnNMmxndq4IaSXb6wUXJGe7yzATaO8KC1KqCyHBTdwbj70Rj9wKv2z6karjrBCxaU4vx/pmsGQ== 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=k9xwojE9LAbVmA/MDCxhSBvyOTCSF5x0c7sHKNIxruw=; b=OjKNDjys3YC8UmxQH8Eec82eSd5w6ww9Jfhbsex2+YgtY+VF6gBwZH/T93CcXJNS1+jTcSaPu3Q3uoqHVyQ0M6vldDHwg1STR1mQAdQb6qlvdf7uwVYxt4TVEWeJzNeBxnJuWLrOVXQYxyD5J6lhphwDs9jYH6FPZM19poTBTag= Original-Received: from SJ0PR10MB5488.namprd10.prod.outlook.com (2603:10b6:a03:37e::19) by DM6PR10MB3706.namprd10.prod.outlook.com (2603:10b6:5:178::19) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4995.22; Tue, 22 Feb 2022 17:22:32 +0000 Original-Received: from SJ0PR10MB5488.namprd10.prod.outlook.com ([fe80::6d28:e29d:4c51:6d04]) by SJ0PR10MB5488.namprd10.prod.outlook.com ([fe80::6d28:e29d:4c51:6d04%5]) with mapi id 15.20.4995.027; Tue, 22 Feb 2022 17:22:32 +0000 Thread-Topic: 26.3; Doc of `face-remap-add-relative' in (elisp) `Face Remapping' Thread-Index: AdgoELv70Ekvu7COTbit+G5qsym6cQ== Accept-Language: en-US Content-Language: en-US x-ms-publictraffictype: Email x-ms-office365-filtering-correlation-id: b1d6a22b-68e0-4aec-fe5d-08d9f627e928 x-ms-traffictypediagnostic: DM6PR10MB3706:EE_ x-microsoft-antispam-prvs: x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: /lk4ZB1vwco1xn8a9LmzGjJawBTbY+9x1XiUfNMTOctdkL7qE2PCmeEvN9SqXytiL670D4JqXr9OQytcz9brP6YT56iCLaqcVpeYtztz3RBMKOPxwfy5bR/F4u+HDvuuIUsfTbAqQVmxp6qZNF0JN+OpDzxrOwEzAYWYxZ0M6PnA9DvhESByMcbHXAVnpng8FyrPUPV/DSpk1YeQeEUhxw7tpuMFXiMITIV7cXpBrMuwaN9i6iiGFBEdQDcXd1RbGANQrN3wwb748STqc3lgI3iEVEnRayd5XCparIBVU1q1eEXxn1ae8/TGEqxxTAKn7jhKJEuopR9J+7xbPdoBT8GbjU0R7f5JYDHie8uh0tYozulR9In4kjqSxc1jB/ye7LdBK41K+Sw5G3hTG/0FBWMsguW+bzzBLMWepbt171eqHCuzZRDfKckB1MpJ9dorV2NQ5VTHt7cjqSb70i+z3DLc53O+X/IjuEk7+yCzedYDQUIlwJ9dkL3tfl2k/AhvWFsJH6nGrrXgz6zlHRD/fk/NCi0SjK6eM/9EBywUfxyFXutxfleZH1y26CMu9CDqwSwSCzb5A+X/sW5feOWmbAT9RkQzc+Gh2kPAFbjZxe8XF9CtWDBZLkMdhL3VOdDPNkMe0483nH7mmM5xHh9Hn2gtSIUU2H+WaNjcVwVus9SmR15gD8a7jCr9wT0hZjDax6jJBVQhuAE3b/nYTOQxdYofmzUvjXrFGiib4vs6sSs= 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)(186003)(45080400002)(26005)(66946007)(9686003)(76116006)(66556008)(66476007)(6506007)(7696005)(6916009)(508600001)(316002)(71200400001)(86362001)(66446008)(64756008)(122000001)(8676002)(52536014)(38070700005)(38100700002)(55016003)(5660300002)(8936002)(33656002)(2906002)(44832011)(4744005)(81973001); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: +9Envbt/Qauq9KJG4S+FI/3STBMWWPtGseFdhtgp3LIFU3xSYbmb3YPbgYndOMDyHryamhbhUCwX5zXcZHUL+DCKlNwgk012kOm+0/EAZrnzQeZUuiGHNzI6uDCmayG0ZONILVdue19tFLS6114TFu18gF7rWLe9KuqIbdnXPqkyO6kXZHIhxh+DCByhoWAtYnm+zpTdoD45J4zO1FwX06zcwuUluxSF9VEsVu9qkAMy7Uz62VbalBWesyWnaSQZ/O8lvnG3kuiZb3t13UoPIyROxKc5qvLJpp1GhB3zESlhpH8i4Mkz1ehhBKrUhQg3oNTeq4IiuTId5R6zXTqbqvfU2qMH1KPl/GbVAkoV2DqCe00mwkVewq4/sBSqcIjz6dpS7m+SXUUKXW2Gww8VdVsAryKlwnfZgcSF/Wpu+qZ5y8/W1mxTJGfJROcq1vrYzfsL+vzbMYkS88sSS6vPADq+jvov2DnJ98aHCXVqsKyypJ0fmuwySYr9rirwy3mDmAwv0OmZzPgYgO/kl7OdyZOD3nste/svmLsVjCvx9m80enzstWNhF9yLgVhBE+RX8cKgvcIj+xFNIzv2+fXPfT49Ws5Dt/isrNsRDlvo0TQtqoxSKcSz+E76X/YWibSc7LNqasHwgj0IX0GEXhDSRfMzqLB1Zf2SmYmN06imrFcxV6Ptp+LlKMWc+QY1HsGLk4MmqG0nsBAgwqX560RJ5gqcafO6GhwC7OMdLE2JDaInk00G91AEzggsg9 LmghNq5sXov4QrrkruAFrXXXj1UjuuYiWzy1uPcgPzGG6yYQT88a4hB2Jp6EbZgpbLozCxDrOI3kAlB1uEpNGvyOfpgedbwJ0o 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: b1d6a22b-68e0-4aec-fe5d-08d9f627e928 X-MS-Exchange-CrossTenant-originalarrivaltime: 22 Feb 2022 17:22:32.4633 (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: 2Hi/OBWsBjbQ88A729LXx3saVqUQzkWLvJtfraJwKPToyToZ4htLoLGcwDJ5WuCzJbKIoiu7g059DuKtBfV6Qw== X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM6PR10MB3706 X-Proofpoint-Virus-Version: vendor=nai engine=6300 definitions=10266 signatures=677939 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 mlxscore=0 malwarescore=0 mlxlogscore=999 adultscore=0 bulkscore=0 phishscore=0 suspectscore=0 spamscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2201110000 definitions=main-2202220106 X-Proofpoint-GUID: e-qDSEINXd5KJJXk6e8_r4-dCpFOCpLf X-Proofpoint-ORIG-GUID: e-qDSEINXd5KJJXk6e8_r4-dCpFOCpLf 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_H5=0.001, RCVD_IN_MSPIKE_WL=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:227448 Archived-At: In this text: -- Function: face-remap-add-relative face &rest specs This function adds the face spec in SPECS as relative remappings for face FACE in the current buffer. The remaining arguments, SPECS, should form either a list of face names, or a property list of attribute/value pairs. please consider removing this: "The remaining arguments,". This should just say "SPECS should form...". SPECS and FACE were already introduced in the first sentence. And the `&rest' makes clear that SPECS is the remaining args _after argument FACE_. Talking about "remaining arguments out of the blue, without saying they are what come ("remain") _after FACE_, is not comprehensible. 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''