From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Stefan Kangas Newsgroups: gmane.emacs.bugs Subject: bug#46853: Confusing terminology "face height" instead of "font size" Date: Mon, 1 Mar 2021 10:40:07 -0600 Message-ID: Mime-Version: 1.0 Content-Type: text/plain; charset="UTF-8" Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="39352"; mail-complaints-to="usenet@ciao.gmane.io" To: 46853@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Mon Mar 01 17:41:11 2021 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 1lGlba-000A88-MZ for geb-bug-gnu-emacs@m.gmane-mx.org; Mon, 01 Mar 2021 17:41:10 +0100 Original-Received: from localhost ([::1]:35656 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1lGlbZ-0000y5-PL for geb-bug-gnu-emacs@m.gmane-mx.org; Mon, 01 Mar 2021 11:41:09 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:52504) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lGlbS-0000wT-JL for bug-gnu-emacs@gnu.org; Mon, 01 Mar 2021 11:41:02 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:39055) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1lGlbS-0004qo-6w for bug-gnu-emacs@gnu.org; Mon, 01 Mar 2021 11:41:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1lGlbS-0006mg-48 for bug-gnu-emacs@gnu.org; Mon, 01 Mar 2021 11:41:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Stefan Kangas Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 01 Mar 2021 16:41:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 46853 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.161461681426013 (code B ref -1); Mon, 01 Mar 2021 16:41:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 1 Mar 2021 16:40:14 +0000 Original-Received: from localhost ([127.0.0.1]:50601 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lGlag-0006lV-3u for submit@debbugs.gnu.org; Mon, 01 Mar 2021 11:40:14 -0500 Original-Received: from lists.gnu.org ([209.51.188.17]:36860) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lGlae-0006lN-Co for submit@debbugs.gnu.org; Mon, 01 Mar 2021 11:40:12 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:52272) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lGlad-0000cb-La for bug-gnu-emacs@gnu.org; Mon, 01 Mar 2021 11:40:12 -0500 Original-Received: from mail-pj1-f42.google.com ([209.85.216.42]:34372) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1lGlab-0004Sj-TX for bug-gnu-emacs@gnu.org; Mon, 01 Mar 2021 11:40:11 -0500 Original-Received: by mail-pj1-f42.google.com with SMTP id d13-20020a17090abf8db02900c0590648b1so2582378pjs.1 for ; Mon, 01 Mar 2021 08:40:09 -0800 (PST) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:mime-version:date:message-id:subject:to; bh=enfUX90QBYhuabJfFO9AT1AuIiMRq6zFbBuN9h/AZQg=; b=Pr4B1DJDrO5OfsF8MuY87BwUUQFPR1MxO3cPrMl8BUdB9Y+67Zzh9NUoUeJ61Yr4U7 scbeU7US2Aa7m+cso0b9g73OvO5qN/RXk4nfD6SlDdtyYjrjeVxehP0oVTQoqkAZeMOO fN2It+yFz5R3Vaf1csvgrTjEhiRiK8IiOTEdhWjMqrY7oXtuQyA2InAeD1t5cQ6dphTl n1LFfioeqapW0Og8elhSz0GzNoj64BdKUc1FlH72p91WsHqKJPheKz19pfekMtpw4YPz qG/zVUfog6G+SSlD+/kU68Dv56j7Pdz1EYL1QmOzbDYXBsPa13oOI66aNiLQmm8OLS66 4pdg== X-Gm-Message-State: AOAM530PNDf5wqV4prtcILSONR5LQlakNisSCVOTukcPQTzHTn2cOYfG Z7U7J9egNftX6gLrYLw8rIP/l1ZeLSsN7KRt7LP8AU3Q X-Google-Smtp-Source: ABdhPJz/6eje5BGs1Ndw99MWxTmH1I5N2cJ+bmqEwlgIn2xmoxtQzhYMiYMbOHFC/Vlg5yKuqc5Cya31nS+4lUs3PdU= X-Received: by 2002:a17:903:31c4:b029:e1:8840:8ab9 with SMTP id v4-20020a17090331c4b02900e188408ab9mr16230838ple.70.1614616808027; Mon, 01 Mar 2021 08:40:08 -0800 (PST) Original-Received: from 753933720722 named unknown by gmailapi.google.com with HTTPREST; Mon, 1 Mar 2021 10:40:07 -0600 Received-SPF: pass client-ip=209.85.216.42; envelope-from=stefankangas@gmail.com; helo=mail-pj1-f42.google.com X-Spam_score_int: -13 X-Spam_score: -1.4 X-Spam_bar: - X-Spam_report: (-1.4 / 5.0 requ) BAYES_00=-1.9, FREEMAIL_FORGED_FROMDOMAIN=0.25, FREEMAIL_FROM=0.001, HEADER_FROM_DIFFERENT_DOMAINS=0.249, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=no 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:201124 Archived-At: Severity: wishlist I suggest changing the terminology "face height" to "font size" in user documentation and messages. For example, the documentation for `text-scale-adjust' currently says: "Adjust the height of the default face by INC." This is harder than it needs to be to understand, since the rest of the world actually talks about "increase font size". IOW, it would be more clear if it said: "Adjust the font size in the current buffer by INC steps." [This would also move talking about the `default' face further down, as that is more of an implementation detail mostly of interest when programming ELisp.] Behind the scenes obviously a "face" is different from a "font" (as it is rather a set of features that includes the font, formatting, etc.). We should absolutely maintain that terminology. We should also maintain that if you want to customize the look of Emacs, including font size, you need to customize this thing we call "faces". As part of this, we could also consider introducing a new property for `defface' called :size. (Or :font-size and :font-scale which would allow for semantics where we can specify :font-size 14 and mean 14pt rather than 1.4pt.)