From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Howard Melman Newsgroups: gmane.emacs.bugs Subject: bug#55086: 28.1; Improve doc of set-fontset-font Date: Sat, 23 Apr 2022 17:51:21 -0400 Message-ID: <6AB2E8A8-06E9-497D-8204-C4D2BDEA06A4@gmail.com> Mime-Version: 1.0 (Mac OS X Mail 14.0 \(3654.120.0.1.13\)) Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="36462"; mail-complaints-to="usenet@ciao.gmane.io" To: 55086@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sat Apr 23 23:52:11 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 1niNfm-0009LS-Ed for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 23 Apr 2022 23:52:10 +0200 Original-Received: from localhost ([::1]:53626 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1niNfk-00025H-Ra for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 23 Apr 2022 17:52:08 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:60712) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1niNfe-000256-Sq for bug-gnu-emacs@gnu.org; Sat, 23 Apr 2022 17:52:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:35250) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1niNfe-0004PR-KL for bug-gnu-emacs@gnu.org; Sat, 23 Apr 2022 17:52:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1niNfe-0005oL-I6 for bug-gnu-emacs@gnu.org; Sat, 23 Apr 2022 17:52:02 -0400 X-Loop: help-debbugs@gnu.org 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-Debbugs-Original-To: GNU Emacs Original-Received: via spool by submit@debbugs.gnu.org id=B.165075068622288 (code B ref -1); Sat, 23 Apr 2022 21:52:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 23 Apr 2022 21:51:26 +0000 Original-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 Original-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 Original-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 Original-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 Original-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) Original-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) 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-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:230523 Archived-At: 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