Description: Some names of keyboard shortcuts are not descriptive enough to see at first glance what they really do. My guess is that the function as well as naming of buttons found in the drop down menus are copied. This makes sense for some buttons that are descriptive enough by themselves (eg. "Export as PDF") but does not work very well for others as their name only makes sense from where they are inside the menu (eg. add -> Foot/Endnote -> Footnote) Steps to Reproduce: 1. Open the keybinding menu and search for eg. footnote 2. The text alone does not tell you what it does. There also is no description displayed on hovering with mouse Actual Results: For eg. "Footnote" it does not tell you anything what the button does. Add a footnote? Remove a footnote? Toggle visibility of footnotes? Open a context menu where you can edit their style? Open some window in which you can edit them all at once? Expected Results: The text of buttons is more descriptive when their name only makes sense if they are nested in their menu structure. So in the case given the name in the keybinding list could be "Add footnote" instead of just "Footnote" Reproducible: Always User Profile Reset: No Additional Info: LibreOffice info: Version: 25.8.3.2 (X86_64) / LibreOffice Community Build ID: 8ca8d55c161d602844f5428fa4b58097424e324e CPU threads: 12; OS: Linux 6.14; UI render: default; VCL: gtk3 Locale: de-AT (de_AT.UTF-8); UI: de-DE Flatpak Calc: threaded
Created attachment 204251 [details] CALC - keyboard shortcut - function name
It's true that for keyboard shortcuts, no helpful tooltip is shown. If you go to menu items, you will see info for the individual items.
(In reply to Buovjaga from comment #2) > It's true that for keyboard shortcuts, no helpful tooltip is shown. If you > go to menu items, you will see info for the individual items. Hmm, I'm not sure what happened earlier, because now I can see the tooltips. Maybe there is some state that the tooltips are not shown and some processing needs to happen?! Can you do more testing? Version: 26.8.0.0.alpha0+ (X86_64) / LibreOffice Community Build ID: a76f0371596f0037444c40fe3dcad5b4fef18c24 CPU threads: 4; OS: Linux 6.17; UI render: default; VCL: gtk3 Locale: fi-FI (fi_FI.UTF-8); UI: en-US Calc: threaded
The tooltips *only* appear in the 'Functions' block of the 'Keyboard' tab, but they do not show for the actual assignments in the UI's upper listing of 'Shortcut Keys'. Currently all that is shown on mouseover anywhere in the area of the UI is the generic tooltip: "To quickly find a shortcut in this list, simply press the key combination". This differs from the other panels of the 'Customize' dialog, where a tooltip (with UNO and shortcut if any) as assigned to the control is shown on mouseover. The tooltip duplicates what is shown in the 'Description' (though no Description was added for the Notebookbar customizations, but they get the same tooltips). It would be helpful to Keyboard customization if somehow similar descriptive tooltip could be shown on mouseover of the UNO assignments listed with their 'Shortcut Keys'. Seems this didn't get picked up as bug 112237 was implemented with https://gerrit.libreoffice.org/c/core/+/140142 @Jim, what do you think, can the work on bug 112237 be expanded?
(In reply to V Stuart Foote from comment #4) > @Jim, what do you think, can the work on bug 112237 be expanded? Sure can! If we want to make this a hack for a beginner I will supply code pointers. If we would like this enhancement sooner than later, please let me know ;)
(In reply to BDF from comment #0) > 1. Open the keybinding menu and search for eg. footnote > 2. The text alone does not tell you what it does. There also is no > description displayed on hovering with mouse IMO the tooltip on the functions list is sufficient. The mentioned workflow is not to look through the assigned shortcuts and find those that can be overwritten. We should rather invest on a complete redesign of the dialog, bug 115527 and other.
(In reply to Heiko Tietze from comment #6) > (In reply to BDF from comment #0) > > 1. Open the keybinding menu and search for eg. footnote > > 2. The text alone does not tell you what it does. There also is no > > description displayed on hovering with mouse > IMO the tooltip on the functions list is sufficient. The mentioned workflow > is not to look through the assigned shortcuts and find those that can be > overwritten. > > We should rather invest on a complete redesign of the dialog, bug 115527 and > other. Issue of OP was that the description doesn't show--but it does. Just only on the Function listbox when user filters by search. Comment 4 suggests an overlooked implementation issue in that for the Keyboard panel, an onmouseover of an assigned function should show tooltip with details of the associated UNO assigned. *For consistency with the other customization panels*. Full redesign of the customization dialog aside, this current inconsistency on the Keyboard panel should be tweaked for better UX. Providing details of the actual UNO assigned to accelerator/shortcut that is now missing to put it on par with the other panels.
(In reply to V Stuart Foote from comment #7) > (In reply to Heiko Tietze from comment #6) > > IMO the tooltip on the functions list is sufficient. > Issue of OP was that the description doesn't show--but it does. Just only on > the Function listbox when user filters by search. BDF, do you agree on INVALID or expect the tooltip also on the upper "shortcut keys" list?
Created attachment 205018 [details] CALC - bug 169659 - keyboard shortcuts - DE Wortverbinder (In reply to Heiko Tietze from comment #8) > > BDF, do you agree on INVALID or expect the tooltip also on the upper > "shortcut keys" list? Well, my initial comment was not about showing a tooltip. The original headline was "[Feature request] CALC - Improve description of keyboard shortcut binding names". Buovjaga seems to have changed it to the current headline. As the init comment is also not about tooltips, I'll change the description back to what it was. As the initial goal was to improve the label for it to represent what it does (eg. "Footnote" -> "Insert footnote") I don't think that there was an improvement on that front yet. The tooltip is nice, but why would we go the Microsoft route and hide something one layer deeper in a context menu if there is no need for it (here: hide information in a tooltip that only shows on hover (= extra manual work) if the same information is better suited as button lable). There seems to be a tiny mistake in the german version (see attached file) as the label ("Beschriftung" - is this one a 'description' if it's usually only the label name?) and the help ("Direkthilfe") seems to be flipped. However, this is actually what I had in mind as goal. You search for the function name or label (eg. 'footnote' - whatever this is actually called; here: "Wortverbinder") and you are presented on first glace what it actually does (eg. 'Insert footnote'; here "Wortverbinder einfügen"). IMO there is no reason to hide this info in a tooltip.
Created attachment 205019 [details] CALC - bug 169659 - keyboard shortcuts - DE Fett Same for "Fett" ('bold') in german. - Label: "Fett" - Help: "Fett" (+ keyboard shortcut that is also visible on the side) OK, and what does the cyan colour _do_? (Of course this is the function that makes the font bold, but that's not written anywhere). There is the keyboard shortcut in the help ("Direkthilfe") line that is also presented right next to it (red). That does not make even sense for a custom shortcut as they are presented in the list on the right as well (maybe it does for eg. special keys on a stream deck that are not listed at the top) My suggestion: > Menu Entry - Label: Schriftstärke: Fett ('font weight: bold") > Pop-up menu (- Lable: not needed as the menu entry lable is descriptive enough) - Help: Schriftstärke des Texted zu Fett ändern ('change text font weight to bold') - Command: No changes, but maybe moved to the bottom
(In reply to BDF from comment #9) > Well, my initial comment was not about showing a tooltip. > The original headline was "[Feature request] CALC - Improve description of > keyboard shortcut binding names". Buovjaga seems to have changed it to the > current headline. As the init comment is also not about tooltips, I'll > change the description back to what it was. In your original description you had: (In reply to BDF from comment #0) > 2. The text alone does not tell you what it does. There also is no > description displayed on hovering with mouse But what you are now explicitly asking would mean that we change command labels *globally* - we shouldn't have different labels for each location.
(In reply to Buovjaga from comment #11) > In your original description you had: > (In reply to BDF from comment #0) > > 2. The text alone does not tell you what it does. There also is no > > description displayed on hovering with mouse > A mistake by me that I didn't see it, yet it was not a suggestion to have a tooltip. (In reply to Buovjaga from comment #11) > But what you are now explicitly asking would mean that we change command > labels *globally* - we shouldn't have different labels for each location. I have no idea how the internals really work. My guess was that it just uses the existing (not very descriptive) labels. I am not suggesting to change the labels globally (is there a way to not do it, I don't know). But as "Wortverbinder" shows: There is a possible option to separate the global label from the line that is shown in the menu (even it looks like it was a mistake here). ("Wortverbinder" is located in menu Einfügen > Formatierungszeichen > Wortverbinder; EN: Insert > Formatting Mark (?) > Word joiner (?) - according to https://help.libreoffice.org/latest/en-GB/text/shared/01/formatting_mark.html)
Unfortunately, the labeling of controls/buttons/menu entries is complex and depends on the class of label required. Issue can not be with individual button assignments. It is global affecting all keyboard assignments. See the work up in bug 108458 to understand why individual controls get labels of varying complexity depending on location in the UI. And why here, the issue with *namings* on the assigned area of the Keyboard tab of the customize dialog would be better served by exposing full tooltip as done on the other tabs. Adjusting the individual "binding names" (including needed translations) are unmaintainable. Correct way is framework of how Maxim and Jay resolved things for bug 108458, but the Keyboard tab of the Customize dialog needed the additional tweak of exposing to user the full tooltip description of a shortcut's assigned UNO.
Here is a better example of categorizations: consider the string "Center" (so maybe as "Zentrieren" in Deutsch). In the Customize -> Keyboard tab on the 'Functions' search field enter that string. On the Category column 1. select 'All commands' --> what commands show in the 'Functions' column? 2. change Category selection to 'Frame' --> what commands show? 3. change Category selection to 'Format' --> what commands show? Point is that no matter what *binding name* is used--due to duplication and needs for terse command names--the only reasonable means for a user to asses the controls function is the detail provided in the complex tooltip. While the command names of shortcuts already assigned (as exposed in the upper panel) otherwise hide their function due to their terseness.
Clearly not just a Calc UI issue, the example clips are all from Writer ;-) And I hope from a read of see also bug 108458 that folks gain a sense of issues in curating and assigning names to UNO commands appropriate to their use in the UI. Yes, the UI for making keyboard shortcut assignments certainly needs the work on bug 115527 But the multi-line tooltip at 7.0.0 on close out of bug 108458 by Jim and Heiko is the status quo--done without requiring a massive rehash of command names and translations. And my suggestion in comment 4 was to bring status quo of exposing multi-line tool tips onto the Customize -> Keyboard tab for browsing the upper shortcut listing--giving parity with the other customize dialog tabs. And that alone would give users greater understanding of the controls bound to each shortcut. Even when those names are necessarily terse.
(In reply to BDF from comment #9) > As the initial goal was to improve the label for it to represent what it > does (eg. "Footnote" -> "Insert footnote")... (In reply to V Stuart Foote from comment #15) > And my suggestion in comment 4 was to bring status quo of exposing > multi-line tool tips onto the Customize -> Keyboard tab... Nothing to say against the dynamic hover tooltip but it does not solve BDF's issue. Which I still don't really understand - a clear use case like "I want to assign a new shortcut to the "Bold" function and wasn't able to do so because..." would help. Regarding the command labels I wrote a blog post a while a ago: https://design.blog.documentfoundation.org/2018/02/28/easyhacking-all-about-terminology/ Don't think we can show anything else but Bold or Insert Word Joiner in the list. With huge effort we might be able to add some kind of extended tooltip explaining the function - but l10n people surely don't like this. And still there is no use case that would be solved by that.