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#55086: 28.1; Improve doc of set-fontset-font Date: Sat, 23 Apr 2022 22:07:38 +0000 Message-ID: References: <6AB2E8A8-06E9-497D-8204-C4D2BDEA06A4@gmail.com> 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="32065"; mail-complaints-to="usenet@ciao.gmane.io" To: Howard Melman , "55086@debbugs.gnu.org" <55086@debbugs.gnu.org> Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sun Apr 24 00:08:12 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 1niNvI-0008BE-CV for geb-bug-gnu-emacs@m.gmane-mx.org; Sun, 24 Apr 2022 00:08:12 +0200 Original-Received: from localhost ([::1]:33080 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1niNvH-0008LZ-43 for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 23 Apr 2022 18:08:11 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:34660) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1niNv8-0008LN-Jz for bug-gnu-emacs@gnu.org; Sat, 23 Apr 2022 18:08:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:35266) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1niNv8-0006dR-B2 for bug-gnu-emacs@gnu.org; Sat, 23 Apr 2022 18:08:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1niNv8-0006DO-31 for bug-gnu-emacs@gnu.org; Sat, 23 Apr 2022 18:08:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 23 Apr 2022 22:08:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 55086 X-GNU-PR-Package: emacs Original-Received: via spool by 55086-submit@debbugs.gnu.org id=B55086.165075166623838 (code B ref 55086); Sat, 23 Apr 2022 22:08:02 +0000 Original-Received: (at 55086) by debbugs.gnu.org; 23 Apr 2022 22:07:46 +0000 Original-Received: from localhost ([127.0.0.1]:57396 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1niNus-0006CQ-A7 for submit@debbugs.gnu.org; Sat, 23 Apr 2022 18:07:46 -0400 Original-Received: from mx0a-00069f02.pphosted.com ([205.220.165.32]:2696) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1niNup-0006CF-E3 for 55086@debbugs.gnu.org; Sat, 23 Apr 2022 18:07:44 -0400 Original-Received: from pps.filterd (m0246629.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.17.1.5/8.17.1.5) with ESMTP id 23NH5B7q023432; Sat, 23 Apr 2022 22:07:42 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=from : to : subject : date : message-id : references : in-reply-to : content-type : content-transfer-encoding : mime-version; s=corp-2021-07-09; bh=fksco/KAB3RtaTCJTVJmDHSyBsmSkSu4ZtlBKECMyno=; b=LG6IaFD+l4VlMTsASxdtgqWJYS/pLtUd6ahPM6af+7dRjEN877V4/o/3U9YFiBSBZGzl a1ZfeAUR6XVDxnqEkuV6aw0LKgoyD5ETG+uUWFn+7KYY5WqAwtcZ7HkKWd/b/MO7dWQ0 /z2y4U5O8/m27mDkIweTTfZmwB9QwsowKucM8UeOVQPYScxR7BoABSvYisIV8FONTo7K ZFOjcK/qtnJIAwKaW6gdxkeRhLMmHcm0qPbmQeE774xKrRAKLov/yJO2dJVYLkofj6cn nwgYhthGyYLDhjdXurHdxD1R6aFMmh/BpFOLW0b8ot1LdubT8x059M/zs97Pfi/YG7rL wg== Original-Received: from phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (phxpaimrmta03.appoci.oracle.com [138.1.37.129]) by mx0b-00069f02.pphosted.com (PPS) with ESMTPS id 3fmb0yrrp1-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sat, 23 Apr 2022 22:07:42 +0000 Original-Received: from pps.filterd (phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com [127.0.0.1]) by phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (8.16.1.2/8.16.1.2) with SMTP id 23NM604B013031; Sat, 23 Apr 2022 22:07:41 GMT Original-Received: from nam02-bn1-obe.outbound.protection.outlook.com (mail-bn1nam07lp2045.outbound.protection.outlook.com [104.47.51.45]) by phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com with ESMTP id 3fm7w19v2e-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sat, 23 Apr 2022 22:07:41 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=m31nZc+8dNkkyLsN/dJDkUId5QeXdMOZt9Z4ob7WRzsk3KmKD4Y3GrYsFN7Kxn9GEcA8IKo64uckeNOqcIKPANHmRFBpBGLssCZrV60QZrId/B0iJ9WJ9Tem8jr2LWVLfVL554heEY6pPNfqHiErjw6/mkppu8miMY69b31c055A7b3fi+bytDexGAV3Afq/NXK5XYmiy4Uhle6/ATS5YZ9Prjg2+UTjZN9H7+y3SXZKoI3cU2qoiRzgbBuvSScvfhtzNR2EZXdoZjEVznfsdoulHUijl9dBePp1tKi/HarxutPdCvWHVY/7pTX/yAUPYqR1733J2lVl3XjJKaKtpw== 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=fksco/KAB3RtaTCJTVJmDHSyBsmSkSu4ZtlBKECMyno=; b=gJsKGHAOU2Gl9Udha/EVQT83r6qt3lz8Fzle6bVqOzff3KtVyXZGDL0nZ41foECgdvcZ2ZoW1sDz+SgSVkj98wOUbxoJLy6WFupulyFlolOO8hSk9te2MDgt3PASExoaUQX5d5bHVSMgQBFFoyxBi+215lcM2oMtO44jZ2iKnhCZP5MoZTxEz6jfazVKhMjhh6BlOBShUY29m0aXFZ19a48/rZt+CdNdX2sz358wdcu1jL8D1EOjWIYS1O9+Cf9FN2WvsWyjH8zqZ9znCrqqpKrFnd0yNvUBaG1v7WMjdVWKUjSrgBsAw1brXyuqkzoEW7FL9fOOx9cqe1DO3yBS5A== 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=fksco/KAB3RtaTCJTVJmDHSyBsmSkSu4ZtlBKECMyno=; b=IfBH6cFDEzKVuebLP1l1oUqH3NLTeSrl7wnxveyTgPwG+A7goLhSHshf9oZCtTMsQ1qiqSWG5l6d1lWQMm5qyQjPElowz8X+BZ6YhZt/cSYYvS8BGWq1cuhQHSF8AsKQllb+bSh2VT6UMeZQg98rUgCNoVuElN+1AmBWrOrDrVw= Original-Received: from SJ0PR10MB5488.namprd10.prod.outlook.com (2603:10b6:a03:37e::19) by BN0PR10MB5077.namprd10.prod.outlook.com (2603:10b6:408:12e::17) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5186.15; Sat, 23 Apr 2022 22:07:39 +0000 Original-Received: from SJ0PR10MB5488.namprd10.prod.outlook.com ([fe80::a0e7:5f38:ab50:5123]) by SJ0PR10MB5488.namprd10.prod.outlook.com ([fe80::a0e7:5f38:ab50:5123%9]) with mapi id 15.20.5186.020; Sat, 23 Apr 2022 22:07:39 +0000 Thread-Topic: [External] : bug#55086: 28.1; Improve doc of set-fontset-font Thread-Index: AQHYV1xjkaTmAjHj2k+6/HoB+iPZiKz+C81g In-Reply-To: <6AB2E8A8-06E9-497D-8204-C4D2BDEA06A4@gmail.com> Accept-Language: en-US Content-Language: en-US x-ms-publictraffictype: Email x-ms-office365-filtering-correlation-id: 09897953-9b60-4534-a277-08da2575ae30 x-ms-traffictypediagnostic: BN0PR10MB5077: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: ObmEwvz4sxMw37t8hGckUGmyca+O3sKTGCFcMEP1Ok0WjrK6QpcebJfEu8IOuPR8zmdXZUE/B6vtSg24QhHOL94E/1/jqaF1IZP9dnpBgbcNM7wwhHds6uQx+069t5SWY2dUk2pD4Wy+WVlYJSdNuboI+NcFao66Qtz2O+6x6+JmU5H1eN64S5dez1cScHw0MgCCunW4BLW7IIhHvdlWUB5qCYVF5KSek6HOz0j6yYpZXamuD7sUA0hhOJVUhk7gsXf9XAyMjzcAU8CDxNZJkUUZ/crN4gfZyGwRnlk+sahGGSOViqFri79K9BZz8D9Tp4DCZhhuKlu+wLL6GGYvXQ6SbqTkGkCdFNiyzBzLX0IyKgKdR/6z/PAwbh9wJchcF1tf8d7A3fKZmGkYdgkxh9qYuDB3EbDwSVnqmgC+yuNBly85VbzhshWLEAp5S3QeOQcTFCmQV2q+/Kms38PX7fBbweYkWSLR+YnSnT9mOks8Kfy+5EzvmsZ4CIJwOXypR+zwnNZZxLYXcE8HPNhbB6TQf20hpAlr0Mpw/eblkzavAZL/HqN0zN8F/9nkh7Pkmy8GYb6btK4fwoET5FQI4sm/EtcoKlLqigilHdixRW5tEZoLV5f5fQyyt5wPhoZBVZFMT43HEVUdpJqup/VqXlI6Ft9IBADbXv9y2d0xF++M3k/eedg5lb5RgJLodkfqPMNlOB9nHqZ3nJUT09D1Gg== 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)(9686003)(316002)(52536014)(6506007)(110136005)(66446008)(66556008)(64756008)(83380400001)(66946007)(76116006)(66476007)(8676002)(71200400001)(122000001)(7696005)(2906002)(38070700005)(508600001)(38100700002)(5660300002)(4744005)(186003)(55016003)(33656002)(8936002)(26005)(86362001)(44832011); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: EajtaoPsmoHIaen6Ob/UCXNjG5MQse7peeoEQE3Eeo9pGnWexA6WzD7WHnM4td7tGRPmZzRyMMzof2FKY8hzozsXzToXQX6C2sKQXGf18sNvBmMTT3HmvuAymIRlS3DVD86PK35liFepsBmTFgl46qxvOjdzy4uzswN5U2gYXZRNbm3fSfo7l8/My0wlmo2j6Dl9gfr5FUg2pIbJRpkOtRuDCWj0G9FjF+YglDh+wjC+7cTJ9N+Q4Gm49VhjbF0xaXqcprkvNMbtdAwc4vaGZduDcmg0NwnE8RF+nuw8lxb91RzZg4F4cr8dnIOdgsGODJbaWLrXxTs8ww5/R12IGedwGhIrBqiU3DZNV+9jt4Gf0lKYcGvDRLfuMr5CSKSWLC/xL3Sb0gL+PytbTSaXRn9zXUroFw6aUaogBjQ1chNv4DHfjaQyrMMZYafyisZSrmF90o6p4h8EApbI5srmFeK75C2cfuRYvzbmtfWCjhz6BXR0LFYMzTNi1v5LaLmrqDa2/ZR88Tq9VzSLFoqhZwam6LtvSlMmEeyGgTnpj1iTkZmixYkzdApeX6h/17Rq3wxNTqC2cAvI+r6n6cc8UkFxKqEiip/JpG7Y1uzWJUeDCSmTb+gIYKWj6HGikIGnXwG2yzyFL20cpKgICOnnDEz7sXO8RLqRrSAIs+UftRGW8UBdziF7fIXY4yes3ntfGgPYVmmh+CwbtoHDinFaKL/dFkb5cJ6AhZOfzrrDil2wq0U2yXNIqo5hoI 5lLHL3uiFri/2H/QHnsO4quSBDtGwGXcHQYkFSlMqZmHDcIj9/R4k3ZHoCAS7obzYDhhFzGYVyzOaYc3yMp9GI7emSnbq6q+j+ 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: 09897953-9b60-4534-a277-08da2575ae30 X-MS-Exchange-CrossTenant-originalarrivaltime: 23 Apr 2022 22:07:38.9702 (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: jFQbygHzfP6IBxD3bnaC//8zYCMw51XplqM3rQkSj8VpwsGCDXhMiPApghtTylXdZN0prfMvYllwtGwLfSHCcg== X-MS-Exchange-Transport-CrossTenantHeadersStamped: BN0PR10MB5077 X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:6.0.486, 18.0.858 definitions=2022-04-23_01:2022-04-22, 2022-04-23 signatures=0 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 bulkscore=0 mlxlogscore=732 suspectscore=0 malwarescore=0 adultscore=0 spamscore=0 mlxscore=0 phishscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2202240000 definitions=main-2204230107 X-Proofpoint-ORIG-GUID: sCXjgctXZ97aWcGy0cSHx4dkzC2TyWRK X-Proofpoint-GUID: sCXjgctXZ97aWcGy0cSHx4dkzC2TyWRK 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:230524 Archived-At: > The eldoc string for set-fontset-font in Emacs 28 is >=20 > (NAME TARGET FONT-SPEC &optional FRAME ADD) >=20 > I found NAME and TARGET to be unhelpfully generic. The > docstring does say that name is the name of a fontset and > that TARGET is about characters. >=20 > The elisp manual names the params as: >=20 > set-fontset-font name character font-spec &optional frame add >=20 > character is an improvement but it should be plural. >=20 > I think they should be the same in both places and > this would be clearer: >=20 > (FONTSET CHARACTERS FONT-SPEC &optional FRAME ADD) +1 for that renaming. (It's also OK to use just CHARS.) The first doc line also doesn't really respect the convention of describing args in order. (Not a biggee, IMO.) That could maybe be remedied also - perhaps something like this (67 chars): Modify FONTSET for use on CHARACTERS so that it respects FONT-SPEC.