setToolTipsVisible is absent tree-wide: every per-action menu tooltip is unreachable

[Ozy311]

Summary

QMenu::setToolTipsVisible(true) is called nowhere in the source tree, so every
per-action tooltip in the application is unreachable output. Qt has suppressed per-action
tooltips since 5.1 unless a menu opts in.

#5539 fixes this for TxApplet's two menus, deliberately scoped to the menus #5510 is
about. The same defect remains in seven other files that set a tooltip on a QAction:

• src/gui/MainWindow_Menus.cpp
• src/gui/RxApplet.cpp
• src/gui/VfoWidget.cpp
• src/gui/WaveformsDialog.cpp
• src/gui/TciApplet.cpp
• src/gui/MainWindow.cpp
• src/gui/Ax25HfPacketDecodeDialog.cpp

Why it is worth doing

The text is already written and already correct. It costs one call per menu to make it
render. Where the action is disabled, the tooltip is usually the only explanation the
operator can get, and a disabled QAction does not highlight on hover either, so the
control reads as broken rather than unavailable. That is exactly how #5510 arrived.

Verified on Qt 6.11.1 that Qt does render tooltips for disabled actions once the menu
opts in, so the fix works for the case that needs it most.

Suggested approach

One menu.setToolTipsVisible(true) per menu construction, matching #5539. Worth a quick
look at each site to confirm the existing tooltip text still reads correctly now that it
will actually be seen; some may have been written as code comments in spirit.

Happy to do this as a follow-up PR if wanted.

---

73, Ozy K6OZY - model: claude-opus-5

[aethersdr-agent]

Confirmed. setToolTipsVisible appears zero times in the tree (grep -rn setToolTipsVisible src/ → no matches), and #5539 — which would add the first two — is still an open draft. So today every per-action menu tooltip in the app is written-and-discarded output.

Verified inventory

I enumerated the QAction tooltip sites (as opposed to plain widget tooltips, which work fine and dominate the setToolTip grep). Thirteen calls across the seven files you list, plus TxApplet under #5539:

Menu construction	Tooltip setter	Real tips / total menu entries
WaveformsDialog.cpp:1343 installMenu	WaveformsDialog.cpp:1448,1450,1452	2/2
MainWindow_Menus.cpp:110 settingsMenu	MainWindow.cpp:7671,7675	2/~22
MainWindow_Menus.cpp:830 viewMenu	MainWindow_Menus.cpp:1049,1072,1113	3/~20
TciApplet.cpp:157 (TX-meter context menu)	TciApplet.cpp:180	3/3
Ax25HfPacketDecodeDialog.cpp:3912 serviceMenu	:3921	6/6
RxApplet.cpp:412 / :455 (RX/TX antenna)	:424 / :462	all
VfoWidget.cpp:807 / :845 (RX/TX antenna)	:819 / :853	all

Two things the file list alone hides:

1. The MainWindow.cpp entry needs the fix in a different file. MainWindow.cpp:7671-7676 sets the tooltips, but the menu that has to opt in is settingsMenu, created at MainWindow_Menus.cpp:110. And m_tuneInhibitMenu->menuAction()->setToolTip(why) (:7675) is a submenu's menu-action tooltip — Qt renders that on the parent menu's item, so setToolTipsVisible must go on settingsMenu, not on tuneInhibitMenu. Setting it on the submenu is the natural-looking mistake and would be a silent no-op.

This is also the site that matters most: it is applyCapabilitiesToUi()'s dim-never-hide gate (#5263), and tr("Not supported by this radio") is the entire explanation for two greyed Settings entries on every non-Flex family. Same shape as #5510. WaveformsDialog:1452's dockerInstallBlockerText() is the other one — a computed, per-blocker reason with no other outlet.

2. Blanket opt-in is not free on the two menubar menus. QAction::toolTip() falls back to text() when never explicitly set, so setToolTipsVisible(true) makes every item in that menu show a tooltip — including the ~35 View/Settings entries whose "tooltip" is just their own label echoed back under the cursor. In the five small popup menus that's a non-issue (every entry carries a real tip). For View and Settings I'd either write real tips or suppress the echo with an explicit setToolTip(QString()) on the untipped entries — QMenu skips an empty tooltip. Worth a maintainer call on which; the mechanical opt-in alone is a visible regression in those two menus.

Your "confirm the text still reads correctly" instinct paid off in one place: act->setToolTip(ant) in RxApplet/VfoWidget looks redundant but isn't — the label is antennaMenuLabel() (alias/display name, or the KiwiSDR profile name), so the tooltip is the only way to see the raw ANT1/RX_A token behind an alias. It reads fine once visible.

Proposed fix

One setToolTipsVisible(true) per menu at the nine construction sites above (menu.setToolTipsVisible(true) / menu->setToolTipsVisible(true)), matching #5539's shape — plus the View/Settings echo decision. No behavior change beyond rendering; nothing needs a capability gate.

Suggest landing it after #5539 so TxApplet isn't touched twice, and keeping the two menubar menus in a separate commit from the seven popup menus, since only the former carries a judgment call.

Handoff

Known: claim fully verified, complete site list above, no protocol involvement. To fix: nine setToolTipsVisible(true) calls; settingsMenu opt-in lives in MainWindow_Menus.cpp even though the tooltip setter is in MainWindow.cpp, and the submenu case must opt in on the parent. Open question for the maintainer: label-echo tooltips on View/Settings — accept, write real text, or blank the untipped entries. Why worth doing: two of these tooltips are the only user-visible explanation for a deliberately disabled control on non-Flex backends, which is the #5510 failure mode verbatim.

73 — AetherClaude

---

_{🤖 aethersdr-agent · cost: $2.0968 · model: claude-opus-5}

---

_{📍 Citation health check (Foundry Constitution Principle I): 0 resolved, 12 unresolved against /Users/aetherclaude/workspace/AetherSDR at origin/main.}

Unresolved citations (12)

Citation	Reason
Ax25HfPacketDecodeDialog.cpp:3912	file not found in workspace
MainWindow.cpp:7671	file not found in workspace
MainWindow.cpp:7671-7676	file not found in workspace
MainWindow_Menus.cpp:1049	file not found in workspace
MainWindow_Menus.cpp:110	file not found in workspace
MainWindow_Menus.cpp:830	file not found in workspace
RxApplet.cpp:412	file not found in workspace
TciApplet.cpp:157	file not found in workspace
TciApplet.cpp:180	file not found in workspace
VfoWidget.cpp:807	file not found in workspace
WaveformsDialog.cpp:1343	file not found in workspace
WaveformsDialog.cpp:1448	file not found in workspace