From unknown Thu Jun 19 14:16:20 2025 X-Loop: help-debbugs@gnu.org Subject: bug#55086: 28.1; Improve doc of set-fontset-font Resent-From: Howard Melman Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 23 Apr 2022 21:52:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 55086 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 55086@debbugs.gnu.org X-Debbugs-Original-To: GNU Emacs Received: via spool by submit@debbugs.gnu.org id=B.165075068622288 (code B ref -1); Sat, 23 Apr 2022 21:52:02 +0000 Received: (at submit) by debbugs.gnu.org; 23 Apr 2022 21:51:26 +0000 Received: from localhost ([127.0.0.1]:57380 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1niNf4-0005nQ-KK for submit@debbugs.gnu.org; Sat, 23 Apr 2022 17:51:26 -0400 Received: from lists.gnu.org ([209.51.188.17]:34476) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1niNf3-0005nJ-MY for submit@debbugs.gnu.org; Sat, 23 Apr 2022 17:51:26 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:60700) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1niNf3-00023K-FH for bug-gnu-emacs@gnu.org; Sat, 23 Apr 2022 17:51:25 -0400 Received: from mail-qk1-x732.google.com ([2607:f8b0:4864:20::732]:37656) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1niNf1-0004MQ-UQ for bug-gnu-emacs@gnu.org; Sat, 23 Apr 2022 17:51:25 -0400 Received: by mail-qk1-x732.google.com with SMTP id b68so8339959qkc.4 for ; Sat, 23 Apr 2022 14:51:23 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=from:content-transfer-encoding:mime-version:subject:message-id:date :to; bh=MHHYbEgl1Ag53HaWNxJSgEQl7w5i3Rf0Niwo80eeJP4=; b=X7Mlo8W/QV8r0DlOIYmr9RGo+RMaKWZJG4B/0HklmjHLiOLO+hrIsJORp3wrcVXiu8 NdiWZuu/Gkl4MnYS/GPpm9Yy3uO65imbFs/663fbdwb8F9Z5kAwfCojY0Jyg5gLH7QVl +DcU8IjYfpfGBrSE7uOa1jZ8VMLejjczy0z3gZQmNPT4hWEkbdX/Sv7ZyQQtB7GjYaYX 7J0jz973wM+A7sNjynkIMjTd/PM409NrOPzoiBLzRCBTTDV44bXQ6D0QfYQ9+JZDRwxi KZsQ4603vwKWE0T8vYVtTmGsSvGbVMs9c4f4ONmwxBQnlxLQRWROPJfxHnxAReobQRZM NvxQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:content-transfer-encoding:mime-version :subject:message-id:date:to; bh=MHHYbEgl1Ag53HaWNxJSgEQl7w5i3Rf0Niwo80eeJP4=; b=HTG+ZWGZk2zw9ydwS02H72nLjwpijTsZWBU5D/3gdcb3BmMCW9Nnotr/9rdTSALU67 7GqGDz24NL6IRAEJJWkDspprEsC9DeJlJQe0uv6c/eNcH3g9ZmJW69n8xJKmU2107vBY ZUTXGp+bXwVWqCUFMSJSWaVOSYTVMQo/gT5GZjebfvD+yhDvALlfK4GnGmON13Lg+207 nUXaj6flPfg34V2lTEYABjwYU0kEUrUEcyQRpGobJE0Jdydpx8zrB3BBUhGzHTjV6q6Q 0cD1zOjkao30ymHiPByPAP6Euv+uo1PQtESmV8+hKpgVTf5YvnUt7zxs1YoglDr7TvuL pWOA== X-Gm-Message-State: AOAM5305aXkf1YVsLxuqE5Zh1TVqqp15oLC+AxTXOHFwJS6RXulNfJ4T U+zcXzflS01pQHGEErq2nRdLwDnvVmoYdw== X-Google-Smtp-Source: ABdhPJyrxbzjnSoFYtSd4wu5G/RfriGf5iw6QPYl/h/VF3baGRbPwg89PsEBPSbvY70y6wW7PJQAYw== X-Received: by 2002:a37:55c2:0:b0:479:8293:d7d0 with SMTP id j185-20020a3755c2000000b004798293d7d0mr6496042qkb.182.1650750682625; Sat, 23 Apr 2022 14:51:22 -0700 (PDT) Received: from smtpclient.apple (pool-108-26-204-101.bstnma.fios.verizon.net. [108.26.204.101]) by smtp.gmail.com with ESMTPSA id x2-20020a379502000000b0069d14dabad6sm2747950qkd.79.2022.04.23.14.51.21 for (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Sat, 23 Apr 2022 14:51:22 -0700 (PDT) From: Howard Melman Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Mime-Version: 1.0 (Mac OS X Mail 14.0 \(3654.120.0.1.13\)) Message-Id: <6AB2E8A8-06E9-497D-8204-C4D2BDEA06A4@gmail.com> Date: Sat, 23 Apr 2022 17:51:21 -0400 X-Mailer: Apple Mail (2.3654.120.0.1.13) Received-SPF: pass client-ip=2607:f8b0:4864:20::732; envelope-from=hmelman@gmail.com; helo=mail-qk1-x732.google.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 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, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, 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-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 eldoc string for set-fontset-font in Emacs 28 is (NAME TARGET FONT-SPEC &optional FRAME ADD) 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. The elisp manual names the params as: Function: set-fontset-font name character font-spec &optional frame add character is an improvement but it should be plural. I think they should be the same in both places and this would be clearer: (FONTSET CHARACTERS FONT-SPEC &optional FRAME ADD) Howard From unknown Thu Jun 19 14:16:20 2025 X-Loop: help-debbugs@gnu.org Subject: bug#55086: 28.1; Improve doc of set-fontset-font 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 X-GNU-PR-Keywords: To: Howard Melman , "55086@debbugs.gnu.org" <55086@debbugs.gnu.org> Received: via spool by 55086-submit@debbugs.gnu.org id=B55086.165075166623838 (code B ref 55086); Sat, 23 Apr 2022 22:08:02 +0000 Received: (at 55086) by debbugs.gnu.org; 23 Apr 2022 22:07:46 +0000 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 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 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== 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 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 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= 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 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 From: Drew Adams Thread-Topic: [External] : bug#55086: 28.1; Improve doc of set-fontset-font Thread-Index: AQHYV1xjkaTmAjHj2k+6/HoB+iPZiKz+C81g Date: Sat, 23 Apr 2022 22:07:38 +0000 Message-ID: References: <6AB2E8A8-06E9-497D-8204-C4D2BDEA06A4@gmail.com> In-Reply-To: <6AB2E8A8-06E9-497D-8204-C4D2BDEA06A4@gmail.com> 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: 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/dFkb5cJ6AhZOfzrrDil2wq0U2yXNIqo5hoI5lLHL3uiFri/2H/QHnsO4quSBDtGwGXcHQYkFSlMqZmHDcIj9/R4k3ZHoCAS7obzYDhhFzGYVyzOaYc3yMp9GI7emSnbq6q+j++jB6F7DfMMbUXOlyNqnW8cto1RR0ijkLdRJdiuRMNJngrqs5ofKXPwI37KMkR3Xt043wHH0Oq5YQiGdep6+aZJ5gHUt36FMbbGNz0JCiBpbtx2AQEuzWMNh0e2mIw1iqfdpGEVDGY7/ULKkvOq6hxrlTDGnDi/zzztWenxNdFzfoR1dMEYWrHPRsRdHmeIxpFiAONbRyGp/dYBcD9xdGTLh6p6ue75fObqk4DdCOSBz/LB/YQLbPTcz5e7DVHcGI6eMWvHPEMcIUhAXVK+Y/y6QCl7ZG1LjwZOapLK4VrTbRRoCTkIG2i5mlwFp6w059XYkL3R5M8sIqJxsn0/lxeWspEsfra5q0faNXvCroCzvBhykQKvKlR7EUDSHu5+uOTvjHZc6gFFX/kQfW9yDr4gSjUm6QYWuphegK5tjLgrtA1MXXOo9zOTxxmZMFD54YwfD7nVThnzxNwgZR+QdD1Y/YIp3FdA6LO1h3YcOcAR8AS/7HcPi3+wvVMvR1+xXL5yu6YxJohxVtiN9WtJfxJOD/nLheeEh/PpPpx85/Vl4kRJV3vKj9EdZBnaJtptx0ErPXGZ9it89+8CBLmAezFRsq5/JkRs75G3ZdZ3bqUPVU2NeVpc8nfBwkTUeb5oLA396MQPAFere9HxBerE4GD+KJwpFCcexTJnZwjQJtqtbcw3w7lF17ase06D61xcboKTaEfkzFOAcacWN8VcVoq9dviP2Zf4dw3Qd/n24AyMhyZ7z7rXFSzgUitg5vHIL8HC5q/S+G0AIeMbalE2Pm2gmg3oIslIgVmsXBSLmSMTpSryx1Ay/Jw7g2nZtWBvyi/8q88YYooY+OfM3yCRkpQnavBWslmd3D1OBIWlmUDr2aVbO1DZRNPLmV/Q== 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: 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-Spam-Score: -0.7 (/) 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: -1.7 (-) > 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. From unknown Thu Jun 19 14:16:20 2025 MIME-Version: 1.0 X-Mailer: MIME-tools 5.505 (Entity 5.505) X-Loop: help-debbugs@gnu.org From: help-debbugs@gnu.org (GNU bug Tracking System) To: Howard Melman Subject: bug#55086: closed (Re: bug#55086: 28.1; Improve doc of set-fontset-font) Message-ID: References: <83czh7nf3c.fsf@gnu.org> <6AB2E8A8-06E9-497D-8204-C4D2BDEA06A4@gmail.com> X-Gnu-PR-Message: they-closed 55086 X-Gnu-PR-Package: emacs Reply-To: 55086@debbugs.gnu.org Date: Sun, 24 Apr 2022 06:58:01 +0000 Content-Type: multipart/mixed; boundary="----------=_1650783481-20870-1" This is a multi-part message in MIME format... ------------=_1650783481-20870-1 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Your bug report #55086: 28.1; Improve doc of set-fontset-font which was filed against the emacs package, has been closed. The explanation is attached below, along with your original report. If you require more details, please reply to 55086@debbugs.gnu.org. --=20 55086: https://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D55086 GNU Bug Tracking System Contact help-debbugs@gnu.org with problems ------------=_1650783481-20870-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at 55086-done) by debbugs.gnu.org; 24 Apr 2022 06:57:56 +0000 Received: from localhost ([127.0.0.1]:57563 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1niWBw-0005QL-Br for submit@debbugs.gnu.org; Sun, 24 Apr 2022 02:57:56 -0400 Received: from eggs.gnu.org ([209.51.188.92]:44016) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1niWBu-0005Q7-MB for 55086-done@debbugs.gnu.org; Sun, 24 Apr 2022 02:57:55 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:42472) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1niWBp-0007WC-Bd; Sun, 24 Apr 2022 02:57:49 -0400 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=VhItU3sSQLMm7PAG9MjZyj8Hg/2sWe4r2BRDustyB40=; b=LFbTJCBSTgZm mGsVkbwoD6ls83VB0EzDirkUUTu8nEr6+pu8ac2/pznFd/09T6aXtutpSxiam3AB6wgczd4JiTU2B z1NxG88Rqf3fSkRxQ2vUFv0pCdhWoQF/r2My2N19Zy3YFI6wHManut9zWyAoOx5yEsUrQ7P83kz2n LkbvqvW8e/pQhohtFyyAmYPQY5J8X0ddd27iXf93BeP2JRm73gK0871gPuJnMN12SvsQM638xzi+K uuA/7fVtpDMF79aA4I3znj/qL6vsq3DcJcZN21AsA6LBZvtyhiRMbox21pWcEHaXOZljSho0Ibr8S CCI60IpS16SFKJWkX37jiw==; Received: from [87.69.77.57] (port=1732 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 1niWBm-0000i3-2h; Sun, 24 Apr 2022 02:57:49 -0400 Date: Sun, 24 Apr 2022 09:57:27 +0300 Message-Id: <83czh7nf3c.fsf@gnu.org> From: Eli Zaretskii To: Howard Melman In-Reply-To: <6AB2E8A8-06E9-497D-8204-C4D2BDEA06A4@gmail.com> (message from Howard Melman on Sat, 23 Apr 2022 17:51:21 -0400) Subject: Re: bug#55086: 28.1; Improve doc of set-fontset-font References: <6AB2E8A8-06E9-497D-8204-C4D2BDEA06A4@gmail.com> X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 55086-done Cc: 55086-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: Howard Melman > Date: Sat, 23 Apr 2022 17:51:21 -0400 > > The eldoc string for set-fontset-font in Emacs 28 is > > (NAME TARGET FONT-SPEC &optional FRAME ADD) > > 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. > > The elisp manual names the params as: > > Function: set-fontset-font name character font-spec &optional frame add > > character is an improvement but it should be plural. > > I think they should be the same in both places and > this would be clearer: > > (FONTSET CHARACTERS FONT-SPEC &optional FRAME ADD) Thanks, done. ------------=_1650783481-20870-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at submit) by debbugs.gnu.org; 23 Apr 2022 21:51:26 +0000 Received: from localhost ([127.0.0.1]:57380 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1niNf4-0005nQ-KK for submit@debbugs.gnu.org; Sat, 23 Apr 2022 17:51:26 -0400 Received: from lists.gnu.org ([209.51.188.17]:34476) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1niNf3-0005nJ-MY for submit@debbugs.gnu.org; Sat, 23 Apr 2022 17:51:26 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:60700) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1niNf3-00023K-FH for bug-gnu-emacs@gnu.org; Sat, 23 Apr 2022 17:51:25 -0400 Received: from mail-qk1-x732.google.com ([2607:f8b0:4864:20::732]:37656) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1niNf1-0004MQ-UQ for bug-gnu-emacs@gnu.org; Sat, 23 Apr 2022 17:51:25 -0400 Received: by mail-qk1-x732.google.com with SMTP id b68so8339959qkc.4 for ; Sat, 23 Apr 2022 14:51:23 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=from:content-transfer-encoding:mime-version:subject:message-id:date :to; bh=MHHYbEgl1Ag53HaWNxJSgEQl7w5i3Rf0Niwo80eeJP4=; b=X7Mlo8W/QV8r0DlOIYmr9RGo+RMaKWZJG4B/0HklmjHLiOLO+hrIsJORp3wrcVXiu8 NdiWZuu/Gkl4MnYS/GPpm9Yy3uO65imbFs/663fbdwb8F9Z5kAwfCojY0Jyg5gLH7QVl +DcU8IjYfpfGBrSE7uOa1jZ8VMLejjczy0z3gZQmNPT4hWEkbdX/Sv7ZyQQtB7GjYaYX 7J0jz973wM+A7sNjynkIMjTd/PM409NrOPzoiBLzRCBTTDV44bXQ6D0QfYQ9+JZDRwxi KZsQ4603vwKWE0T8vYVtTmGsSvGbVMs9c4f4ONmwxBQnlxLQRWROPJfxHnxAReobQRZM NvxQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:content-transfer-encoding:mime-version :subject:message-id:date:to; bh=MHHYbEgl1Ag53HaWNxJSgEQl7w5i3Rf0Niwo80eeJP4=; b=HTG+ZWGZk2zw9ydwS02H72nLjwpijTsZWBU5D/3gdcb3BmMCW9Nnotr/9rdTSALU67 7GqGDz24NL6IRAEJJWkDspprEsC9DeJlJQe0uv6c/eNcH3g9ZmJW69n8xJKmU2107vBY ZUTXGp+bXwVWqCUFMSJSWaVOSYTVMQo/gT5GZjebfvD+yhDvALlfK4GnGmON13Lg+207 nUXaj6flPfg34V2lTEYABjwYU0kEUrUEcyQRpGobJE0Jdydpx8zrB3BBUhGzHTjV6q6Q 0cD1zOjkao30ymHiPByPAP6Euv+uo1PQtESmV8+hKpgVTf5YvnUt7zxs1YoglDr7TvuL pWOA== X-Gm-Message-State: AOAM5305aXkf1YVsLxuqE5Zh1TVqqp15oLC+AxTXOHFwJS6RXulNfJ4T U+zcXzflS01pQHGEErq2nRdLwDnvVmoYdw== X-Google-Smtp-Source: ABdhPJyrxbzjnSoFYtSd4wu5G/RfriGf5iw6QPYl/h/VF3baGRbPwg89PsEBPSbvY70y6wW7PJQAYw== X-Received: by 2002:a37:55c2:0:b0:479:8293:d7d0 with SMTP id j185-20020a3755c2000000b004798293d7d0mr6496042qkb.182.1650750682625; Sat, 23 Apr 2022 14:51:22 -0700 (PDT) Received: from smtpclient.apple (pool-108-26-204-101.bstnma.fios.verizon.net. [108.26.204.101]) by smtp.gmail.com with ESMTPSA id x2-20020a379502000000b0069d14dabad6sm2747950qkd.79.2022.04.23.14.51.21 for (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Sat, 23 Apr 2022 14:51:22 -0700 (PDT) From: Howard Melman Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Mime-Version: 1.0 (Mac OS X Mail 14.0 \(3654.120.0.1.13\)) Subject: 28.1; Improve doc of set-fontset-font Message-Id: <6AB2E8A8-06E9-497D-8204-C4D2BDEA06A4@gmail.com> Date: Sat, 23 Apr 2022 17:51:21 -0400 To: GNU Emacs X-Mailer: Apple Mail (2.3654.120.0.1.13) Received-SPF: pass client-ip=2607:f8b0:4864:20::732; envelope-from=hmelman@gmail.com; helo=mail-qk1-x732.google.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 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, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, 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 eldoc string for set-fontset-font in Emacs 28 is (NAME TARGET FONT-SPEC &optional FRAME ADD) 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. The elisp manual names the params as: Function: set-fontset-font name character font-spec &optional frame add character is an improvement but it should be plural. I think they should be the same in both places and this would be clearer: (FONTSET CHARACTERS FONT-SPEC &optional FRAME ADD) Howard ------------=_1650783481-20870-1--