bug#51247: 28.0.60; Insufficient documentation of tab-bar.el internal functions

[Juri Linkov]

>> Everything is right, except this sentence:
>>
>> > @@ -705,11 +705,14 @@ tab-bar-format
>> > +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.
>>
>> Since menu items are used to display tabs, something like this
>> would be more correct:
>>
>>   Adding a function to the list causes the tab bar to show
>>   that string, or display tabs represented by menu items
>>   on the tab bar.
>
> But that's not what I see.  What I see is a single tab called "Menu",
> which, when clicked, shows the global menu.

The menu from the tab called "Menu" is displayed with 'popup-menu'.

> Or what do you mean by "tabs represented by menu items"?  How can a
> tab be represented by a menu item?

Menu items are transformed to tab strings in parse_tab_bar_item.