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: Tue, 19 Oct 2021 22:09:27 +0300 Organization: LINKOV.NET Message-ID: <8735ow7rx4.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> <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> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="5540"; 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 Tue Oct 19 21:15:13 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 1mcuZs-0001IG-RB for geb-bug-gnu-emacs@m.gmane-mx.org; Tue, 19 Oct 2021 21:15:12 +0200 Original-Received: from localhost ([::1]:48500 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mcuZr-0000TX-3B for geb-bug-gnu-emacs@m.gmane-mx.org; Tue, 19 Oct 2021 15:15:11 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:51604) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mcuYk-0007VD-TW for bug-gnu-emacs@gnu.org; Tue, 19 Oct 2021 15:14:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:40480) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1mcuYk-0004Ie-Jo for bug-gnu-emacs@gnu.org; Tue, 19 Oct 2021 15:14:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1mcuYk-0005r4-6z for bug-gnu-emacs@gnu.org; Tue, 19 Oct 2021 15:14:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Juri Linkov Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 19 Oct 2021 19:14: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.163467079722445 (code B ref 51247); Tue, 19 Oct 2021 19:14:02 +0000 Original-Received: (at 51247) by debbugs.gnu.org; 19 Oct 2021 19:13:17 +0000 Original-Received: from localhost ([127.0.0.1]:52026 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mcuY0-0005px-VE for submit@debbugs.gnu.org; Tue, 19 Oct 2021 15:13:17 -0400 Original-Received: from relay4-d.mail.gandi.net ([217.70.183.196]:47591) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mcuXz-0005pj-A2 for 51247@debbugs.gnu.org; Tue, 19 Oct 2021 15:13:15 -0400 Original-Received: (Authenticated sender: juri@linkov.net) by relay4-d.mail.gandi.net (Postfix) with ESMTPSA id 3139CE0005; Tue, 19 Oct 2021 19:13:07 +0000 (UTC) In-Reply-To: <83lf2pcj4h.fsf@gnu.org> (Eli Zaretskii's message of "Tue, 19 Oct 2021 15:08:14 +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:217599 Archived-At: >> 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. Or you might as well include the whole Emacs Lisp Reference Manual in this doc string. > 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.