From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: martin rudalics Newsgroups: gmane.emacs.bugs Subject: bug#51247: 28.0.60; Insufficient documentation of tab-bar.el internal functions Date: Mon, 18 Oct 2021 19:43:45 +0200 Message-ID: <3d2c6767-b2f4-d27c-4153-67d5163c64f9@gmx.at> References: <831r4kghcu.fsf@gnu.org> <4c43cacf-2529-b0b1-bda9-26c03d545c17@gmx.at> <83ee8ie7xs.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: 7bit Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="12232"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 51247@debbugs.gnu.org, juri@linkov.net To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Mon Oct 18 19:44:12 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 1mcWgF-00031A-Ta for geb-bug-gnu-emacs@m.gmane-mx.org; Mon, 18 Oct 2021 19:44:11 +0200 Original-Received: from localhost ([::1]:51398 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mcWgD-00016z-TN for geb-bug-gnu-emacs@m.gmane-mx.org; Mon, 18 Oct 2021 13:44:09 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:54522) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mcWg7-00016r-1E for bug-gnu-emacs@gnu.org; Mon, 18 Oct 2021 13:44:03 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:36972) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1mcWg6-000768-MZ for bug-gnu-emacs@gnu.org; Mon, 18 Oct 2021 13:44:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1mcWg6-0005cK-I8 for bug-gnu-emacs@gnu.org; Mon, 18 Oct 2021 13:44:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: martin rudalics Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 18 Oct 2021 17:44:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 51247 X-GNU-PR-Package: emacs Original-Received: via spool by 51247-submit@debbugs.gnu.org id=B51247.163457903721574 (code B ref 51247); Mon, 18 Oct 2021 17:44:02 +0000 Original-Received: (at 51247) by debbugs.gnu.org; 18 Oct 2021 17:43:57 +0000 Original-Received: from localhost ([127.0.0.1]:48518 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mcWg0-0005bt-R9 for submit@debbugs.gnu.org; Mon, 18 Oct 2021 13:43:57 -0400 Original-Received: from mout.gmx.net ([212.227.15.18]:60051) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mcWfy-0005be-2I for 51247@debbugs.gnu.org; Mon, 18 Oct 2021 13:43:55 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=gmx.net; s=badeba3b8450; t=1634579027; bh=UFr4pzYjK9IcHmKI5np2NsF5k4nbVa75SCjByvd27us=; h=X-UI-Sender-Class:Subject:To:Cc:References:From:Date:In-Reply-To; b=FsdXceoiZmrLKdNKmbz6smuQJYfisZ7nRBuSXBuD83L111CiZGklZ88s8ZQKOsg1y 9M4PxxGrPjRlCFdt3nLh/IM81tBuAd91PJw5DQFNCUWij7E7IDXLRYOHwq4q2DBWQ1 r/aNSWR4ss+8AKMIzMbGiZny9WwQbYyjC7+xigIM= X-UI-Sender-Class: 01bb95c1-4bf8-414a-932a-4f6e2808ef9c Original-Received: from [192.168.1.100] ([46.125.249.39]) by mail.gmx.net (mrgmx004 [212.227.17.190]) with ESMTPSA (Nemesis) id 1MORAa-1mMdgK45cs-00PsJP; Mon, 18 Oct 2021 19:43:47 +0200 In-Reply-To: <83ee8ie7xs.fsf@gnu.org> Content-Language: en-US X-Provags-ID: V03:K1:LAyXa8/EwYOne4cWR7vFP2U0O+D0Hu1bCPc4DeqAiFKXxp2klBP zNcZxOtdbaw3Ze1X81kcT5YQp4b4CUyP7JN+T39jK8tJI/z2+wWOiohzGmTTRiX93rUronC oYfxrFrvTZTgZ7d7ufkxXO1PcwepQG9B0ydCynvrr1NsKqV9U+WiMoJYpwz9hx/AhBn8M2/ vtcgdI9pRLAtzRHxeg2wQ== X-UI-Out-Filterresults: notjunk:1;V03:K0:FCtt1iziM6E=:IoUetRh6kUR6WFHDW2Hk2J rRjUXvNHJ+ukdFC6EPEKDJfVPG8cuzvQXmDt4TzWXcrOcX4Trz3lQFAFQhROltRYsT0z3pBVe 1YqMVgAKvyUOSQHTm4ZIhuInkYoTlH6q+LRlt/0sCqWmMOj7/mMAYCt/ivfIUxOuwh72hB15y eMEP8dWJHi70rAMpW2oakpKUtzP8Y7iQEOds/iGZFZXVP3vjpniGurRkR3PAbrAAeALL5LCle WyW26DsLvqXhWjdconlIj5f/UxKYqi/r2AvOoW5Gnmr3IzT+WNpusy/1sF8czWrhcken5BSZK xSMafetbSVaQNGEt8A29X4qtglBoYhNi7Q8pB5aAuCRZBwo8ePAgbVNjvre3w0IQNX/fzBUGl e24AVtowhdyUE7UGmxKpRdPyjeIpVbu+v8kc0ApwH0qH3au5Xmpc8h87cKGoqf08rWfJ0kDB1 x6MuL5/CbF1XM+gp3hGC6W5ynWi95Qrqbx+iIIhzf/iESwEIPNcRh5F5xn+e6/XaYK1ylMMos vIVcw8nyWRDlQSECppQzBOSF412C8GhWdJ/VTUhWM95EvF9asI+OSo2zhzpwQ6j8MQlQm3qSx iSdCaFHFLQfaN861qF0QWmRB+rMuyZY8jP/hFTooDGgrNrlOMRkvVhd46aSdWCFbjmo/HGC9R ZwxIM4MQmlwnDEcGqp5y2CeRGQqDUNpl+i9F/6gTJMl9qviblKqaIfLi3wrRDmlX49D6WiRlL SOVf8fajUI5tMcdjXg6KRiKOwo/Jg1bm71+ocqsF8HORHXUOwp7tY/94quyPESXfAYCe159C 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:217514 Archived-At: > Thanks. Some comments/questions: > >> +@item Tab Bar >> +@cindex internal tab bar > > Why "internal"? copy/pasta? Intentional but silly. Fixed. > You use the term "minibuffer window", which I think is sub-optimal: > that window is also used for displaying the echo-area. I prefer the > term "mini-window" instead. That ship has sailed somehow. We have an entire section called "Minibuffer Windows". >> +Note that the window returned by @code{minibuffer-window} called with >> +the argument @var{frame} is returned by @code{window-list} called with >> +the same argument if and only if that window actually belongs to >> +@var{frame}. > > This is a mouthful (is it really important to say this here?). Please > rephrase, in particular with fewer instances of the passive tense. > (The next sentence after that is also unnecessarily passive and hard > to read.) I removed that paragraph. Honestly, it would have taken me too much time to understand it myself. > I made a few minor editing changes in the text you installed. Thanks. This one - A @dfn{window} describes a portion of the screen that Emacs uses to + A @dfn{window} describes the portion of the screen that Emacs uses to is not really correct because with multiple windows we have several such portions but maybe it's more intuitive for the reader. Thanks, martin