From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Juri Linkov Newsgroups: gmane.emacs.bugs Subject: bug#51247: 28.0.60; Insufficient documentation of tab-bar.el internal functions Date: Mon, 18 Oct 2021 20:01:09 +0300 Organization: LINKOV.NET Message-ID: <878ryql12i.fsf@mail.linkov.net> References: <831r4kghcu.fsf@gnu.org> <87y26ry3vs.fsf@mail.linkov.net> <83mtn7frz3.fsf@gnu.org> <87tuhfv726.fsf@mail.linkov.net> <83lf2rforp.fsf@gnu.org> <87mtn7v4cw.fsf@mail.linkov.net> <83h7dffnlc.fsf@gnu.org> <87a6j7v3e2.fsf@mail.linkov.net> <83bl3mftqm.fsf@gnu.org> <87czo2peob.fsf@mail.linkov.net> <83a6j6e1d4.fsf@gnu.org> <87wnmal1u8.fsf@mail.linkov.net> <838ryqe0ll.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="39724"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/29.0.50 (x86_64-pc-linux-gnu) Cc: 51247@debbugs.gnu.org To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Mon Oct 18 19:02:18 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 1mcW1g-000A3Q-Q6 for geb-bug-gnu-emacs@m.gmane-mx.org; Mon, 18 Oct 2021 19:02:16 +0200 Original-Received: from localhost ([::1]:52682 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mcW1f-0005kv-BV for geb-bug-gnu-emacs@m.gmane-mx.org; Mon, 18 Oct 2021 13:02:15 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:44328) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mcW1T-0005iC-EX for bug-gnu-emacs@gnu.org; Mon, 18 Oct 2021 13:02:03 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:36879) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1mcW1T-0008G2-5R for bug-gnu-emacs@gnu.org; Mon, 18 Oct 2021 13:02:03 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1mcW1T-0004Zv-2i for bug-gnu-emacs@gnu.org; Mon, 18 Oct 2021 13:02:03 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Juri Linkov Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 18 Oct 2021 17:02:03 +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.163457648817550 (code B ref 51247); Mon, 18 Oct 2021 17:02:03 +0000 Original-Received: (at 51247) by debbugs.gnu.org; 18 Oct 2021 17:01:28 +0000 Original-Received: from localhost ([127.0.0.1]:48424 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mcW0u-0004Z0-3Q for submit@debbugs.gnu.org; Mon, 18 Oct 2021 13:01:28 -0400 Original-Received: from relay1-d.mail.gandi.net ([217.70.183.193]:58657) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mcW0s-0004Yf-GS for 51247@debbugs.gnu.org; Mon, 18 Oct 2021 13:01:27 -0400 Original-Received: (Authenticated sender: juri@linkov.net) by relay1-d.mail.gandi.net (Postfix) with ESMTPSA id 90364240008; Mon, 18 Oct 2021 17:01:19 +0000 (UTC) In-Reply-To: <838ryqe0ll.fsf@gnu.org> (Eli Zaretskii's message of "Mon, 18 Oct 2021 19:53:10 +0300") 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:217507 Archived-At: > Then the doc string after my changes is exactly right. I have no idea > what you see that's wrong with it. You say some functions return menu > items and some return a list of menu items, and that's what the doc > string says. You say that these values are displayed on the tab bar, > and that's what the doc string says. So what exactly is wrong?? Adding a function to the list causes the tab bar to show that string, or display a menu with those menu items when you click on the tab bar. It says that only when you click on the tab bar, those menu items are used to display some menu. But in fact those menu items are used to display tabs or buttons, without clicking. This is more correct: Adding a function to the list causes the tab bar to show that string, or display tabs or buttons created from those menu items.