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.devel Subject: Re: emacs-28 47cbd10: * lisp/bindings.el (mode-line-position): Improve tooltip. Date: Sat, 9 Oct 2021 10:28:01 +0200 Message-ID: References: <834k9qy6hn.fsf@gnu.org> 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="23918"; mail-complaints-to="usenet@ciao.gmane.io" Cc: Emacs developers To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sat Oct 09 10:28:53 2021 Return-path: Envelope-to: ged-emacs-devel@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 1mZ7iv-0005zO-NW for ged-emacs-devel@m.gmane-mx.org; Sat, 09 Oct 2021 10:28:53 +0200 Original-Received: from localhost ([::1]:38596 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mZ7iu-0006Jm-Et for ged-emacs-devel@m.gmane-mx.org; Sat, 09 Oct 2021 04:28:52 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:47550) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mZ7iK-0005eG-2l for emacs-devel@gnu.org; Sat, 09 Oct 2021 04:28:16 -0400 Original-Received: from mail-pj1-f49.google.com ([209.85.216.49]:46708) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1mZ7iI-0001do-JN; Sat, 09 Oct 2021 04:28:15 -0400 Original-Received: by mail-pj1-f49.google.com with SMTP id pi19-20020a17090b1e5300b0019fdd3557d3so9513962pjb.5; Sat, 09 Oct 2021 01:28:13 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=MGd3DaP6+KavmWlhQGLS/EJF8Yrl7YE2CkssN3+DCig=; b=meP6DWi3qmVgyVeQctI+yJ75hRg5swParMNllRvOBNhnAI9MjxGjveV3l5ziT4TIEk k3qfuKyKqVHyXHPLE4YnOQG0kTCpI8uajEwNsTqR9gWd52kmD313Fm/U443hnUK+i1fa JplMkOWGDtzGEgdBh3U86empMyh6bhLpDg70Kmqg7/d30PI2NfYzbvtwoSBPXyOjaIyy YCep3t8J9oyf0AkIePIufoWieOBcZJgsItWlWB9s7Miyeo7t/DsYMpnTSydDGW215J2v Quv5yWTnNUK7BlvJfwiAHHpPPfTegJRRnzR8L88No9cMZNQuFFQ9SqE6coy0HEPLYmsC Jj4A== X-Gm-Message-State: AOAM532zib2ldqFBw5HpRnRQ6547jTPUzelR6mAREyXxMNLLAkkg4U78 x7abmPQRQTPt563IpWyxrEagH434XZpFwQqgaqN7m47xbUY= X-Google-Smtp-Source: ABdhPJwjcrtK3gqmQMQ0TnyCJmwYHG1AsWLBLvQ7l42FzSgjdbsAUjm7unR1cEqJmCdaS0xHGTOsM/ob65VYQh2aeWo= X-Received: by 2002:a17:90a:5583:: with SMTP id c3mr16431634pji.133.1633768092599; Sat, 09 Oct 2021 01:28:12 -0700 (PDT) In-Reply-To: Received-SPF: pass client-ip=209.85.216.49; envelope-from=stefankangas@gmail.com; helo=mail-pj1-f49.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.25, 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: emacs-devel@gnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.io gmane.emacs.devel:276598 Archived-At: Stefan Kangas writes: > Eli Zaretskii writes: > > > This change is incorrect: the "All/Top/Bot/NN%" part is NOT "buffer > > position". If you have a suggestion for better description than "Size > > indication mode", please tell; otherwise, let's leave the original > > description intact. > > The original was even more incorrect, as it had nothing to do with > "Size indication mode". Let me think about an alternative. The info node "(emacs) Mode Line" says "POS tells you whether there is additional text above the top of the window, or below the bottom." The info node "(emacs) Optional Mode Line" says "The buffer percentage POS indicates the percentage of the buffer above the top of the window." In the doc string for mode-line-format we have: %p -- print percent of buffer above top of window, or Top, Bot or All. %P -- print percent of buffer above bottom of window, perhaps plus Top, or print Bottom or All. I could not find any other documentation of this feature. Did I miss something? I guess "Percent of buffer above top of window, or Top, Bot or All" is pretty hopeless as far as a user-facing description goes. In particular, it doesn't say what any of it means. Based on the documentation I could find, I can only suggest "Buffer Percentage Position" or, if you prefer, "Buffer Percentage POS", the latter of which exactly matches the description of this in the info node "(emacs) Optional Mode Line". But I'm not sure that this is better than "Buffer Position".