Bug 426920 - improve the help texts
Summary: improve the help texts
Status: RESOLVED UNMAINTAINED
Alias: None
Product: systemsettings
Classification: Applications
Component: kcm_khotkeys (show other bugs)
Version: 5.20.3
Platform: Neon Linux
: NOR wishlist
Target Milestone: ---
Assignee: Michael Jansen
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2020-09-24 08:36 UTC by fire f.
Modified: 2024-03-04 19:42 UTC (History)
1 user (show)

See Also:
Latest Commit:
Version Fixed In:
Sentry Crash Report:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description fire f. 2020-09-24 08:36:15 UTC
SUMMARY
some small improvements for clarity and usability of the help texts would be nice to have.


STEPS TO REPRODUCE
1. kcmshell5 khotkeys     
2. read the internal help text
3. be left wondering about the Macro-key functionality 
   on special keys and characters such as   € , @ , quotes , "SPACE-char"  and such. 
   Particularly after switching keyboard language-layout say from en-US to es-ES .


OBSERVED RESULT
not quite optimal help text, especially in translated German version.

EXPECTED RESULT
pretty good help texts.

SOFTWARE/OS VERSIONS
Linux/KDE Plasma:        KDE neon distro
KDE Plasma Version:      5.19.5
KDE Frameworks Version:  5.74.0
Qt Version:              5.15.0

ADDITIONAL INFORMATION

developing for khotkeys is not very hard. So the source code can be played around with rather easily:
git clone https://invent.kde.org/plasma/khotkeys.git 

#install various developer libs in KDE neon such as:
sudo apt install libqt5x11extras5-dev

mkdir buildSubDir
cd    buildSubDir
cmake ..          # it usually builds smoothly, if all libs are present. look for missing packages to install via apt or synaptic in error messages. then:

qdbus org.kde.kded5 /kded org.kde.kded5.unloadModule khotkeys      #  true or false 
...../git/khotkeys/buildSubDir/bin/khotkeys_standalone"       &    #  launch the homemade khotkeys daemon
kcmshell5 khotkeys                                            &    #  GUI start

and bang, you run your modified khotkey. to mark your homemade Dämon, change the line

file:///home/......../git/khotkeys/libkhotkeysprivate/settings.cpp     line  485   or thereabouts  accordingly:

 qDebug() << "Version 2 File!    ##  My homemade khotkeys daemon is at play now. This line will be seen in the bash Konsole.  ## ";


also, one might want to look into coherently adapt  

LANG="en" /usr/bin/khelpcenter   help:/kcontrol/khotkeys/index.html 

to launch english khotkeys, use this:



LANG="en" kcmshell5        khotkeys
LANG="en" systemsettings5            # or find it via system settings.
Comment 1 fire f. 2020-09-24 08:57:26 UTC
How does one produce a MAKRO key-sequence which contains the SPACE-character, for example:

"is khotkey able to send these keys and not omit the SPACEs between the words?"

and assign this MAKRO to the "F3"  hotkey.
Comment 2 fire f. 2021-09-09 10:33:26 UTC
khelpcenter could be more detailed when elucidating  keditbookmarks !

There is quite some utility in using keditbookmarks features right while in khelpcenter and saving salient bookmarks from the khelpcenter itself.

This custoization might be very helpful for memorizing workflow et cetera!
Comment 3 Nate Graham 2024-03-04 19:42:00 UTC
As announced in https://pointieststick.com/2023/07/26/what-we-plan-to-remove-in-plasma-6/ and https://community.kde.org/Plasma/Plasma_6#Removals, I'm afraid KHotKeys has reached end-of-life in Plasma 6. Accordingly, all bug reports and feature requests for it must be closed now.

Most of what KHotKeys could do can already be done with the newer KGlobalAccel system in Plasma 6. A few features such as mouse gestures and triggering conditions based on changes to window states are not yet implemented in the new system. These will be added in the future if and when resources materialize for them, and/or when a kind soul submits patches to implement them! :) Meanwhile, the 3rd-party "Mouse Actions" app (https://github.com/jersou/mouse-actions) may be usable for implementing your own mouse gestures again.

Thanks for your understanding, everyone.