From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#51247: 28.0.60; Insufficient documentation of tab-bar.el internal functions Date: Wed, 20 Oct 2021 14:35:18 +0300 Message-ID: <83sfwwapzd.fsf@gnu.org> 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> <837deae081.fsf@gnu.org> <8735oyl10i.fsf@mail.linkov.net> <835ytudzky.fsf@gnu.org> <87ee8ijljn.fsf@mail.linkov.net> <834k9edyra.fsf@gnu.org> <871r4hldq8.fsf@mail.linkov.net> <83lf2pcj4h.fsf@gnu.org> <8735ow7rx4.fsf@mail.linkov.net> Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="14774"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 51247@debbugs.gnu.org To: Juri Linkov Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Wed Oct 20 13:42:59 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 1md9zn-0003f8-J5 for geb-bug-gnu-emacs@m.gmane-mx.org; Wed, 20 Oct 2021 13:42:59 +0200 Original-Received: from localhost ([::1]:48054 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1md9zm-0006zy-Ia for geb-bug-gnu-emacs@m.gmane-mx.org; Wed, 20 Oct 2021 07:42:58 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:35242) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1md9t5-0001U1-59 for bug-gnu-emacs@gnu.org; Wed, 20 Oct 2021 07:36:04 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:41324) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1md9t3-0004nh-VB for bug-gnu-emacs@gnu.org; Wed, 20 Oct 2021 07:36:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1md9t3-0006Gh-ON for bug-gnu-emacs@gnu.org; Wed, 20 Oct 2021 07:36:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 20 Oct 2021 11:36:01 +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.163472973324059 (code B ref 51247); Wed, 20 Oct 2021 11:36:01 +0000 Original-Received: (at 51247) by debbugs.gnu.org; 20 Oct 2021 11:35:33 +0000 Original-Received: from localhost ([127.0.0.1]:52870 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1md9sb-0006Fz-1o for submit@debbugs.gnu.org; Wed, 20 Oct 2021 07:35:33 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:33058) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1md9sZ-0006Fe-Db for 51247@debbugs.gnu.org; Wed, 20 Oct 2021 07:35:31 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:34678) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1md9sT-0004Im-SM; Wed, 20 Oct 2021 07:35:25 -0400 Original-Received: from [87.69.77.57] (port=3159 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1md9sB-0000yv-17; Wed, 20 Oct 2021 07:35:24 -0400 In-Reply-To: <8735ow7rx4.fsf@mail.linkov.net> (message from Juri Linkov on Tue, 19 Oct 2021 22:09:27 +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:217652 Archived-At: > From: Juri Linkov > Cc: 51247@debbugs.gnu.org > Date: Tue, 19 Oct 2021 22:09:27 +0300 > > >> You don't need to explain about buttons that drop a menu. > >> This is irrelevant for the description of tab-bar-format. > >> Just imagine there is no tab-bar-format-menu-global > >> that uses own unrelated menu items. > > > > Sorry, that won't fly. The doc string should explain enough for other > > Lisp programmers to be able to produce buttons that drop down menus. > > This is the whole point. The doc string of this variable is not an > appropriate place to teach Lisp programmers how to produce buttons > that drop down menus. That's not what I meant. I meant to explain to people who already know to produce menus how to format those menus in these two different manners for two different effects. > Or you might as well include the whole Emacs Lisp Reference Manual > in this doc string. This is not constructive and not helpful, let alone uncalled-for. > > So please humor me with a detailed enough answer to my questions, I'm > > investing enough energy in this stuff to be entitled to a bit more > > than a couple of dismissive sentences. > > > > We must have a decent doc string for this defcustom. Please help me > > fix what we have now. > > You assumed in the doc string that those menu items as used > to display a menu, whereas in fact those menu items as used > to display tabs and other buttons on the tab bar. I'm trying to understand the difference between the two kinds of menus, the one which causes the tab bar to display tabs, vs the one that causes the display of a single tab that drops down a menu. Please help me understand that difference.