Bug 511689 - Inconsistency between key bindings editor and special values documentation
Summary: Inconsistency between key bindings editor and special values documentation
Status: REPORTED
Alias: None
Product: konsole
Classification: Applications
Component: keyboard (other bugs)
Version First Reported In: master
Platform: Other Linux
: NOR normal
Target Milestone: ---
Assignee: Konsole Bugs
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2025-11-05 20:47 UTC by Jonathan Marten
Modified: 2025-11-05 20:47 UTC (History)
0 users

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


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Jonathan Marten 2025-11-05 20:47:27 UTC
SUMMARY

When describing how to configure the terminal key bindings, chapter 5 of the Konsole Handbook describes the special values:

scrollUpLine : scroll up one line in the shell history scrollback buffer
scrollUpPage : scroll up one page in the shell history scrollback buffer
scrollDownLine : scroll down one line in the shell history scrollback buffer
scrollDownPage : scroll down one page in the shell history scrollback buffer
scrollUpToTop : scroll up to the begining of the shell history scrollback buffer
scrollDownToBottom : scroll down to the end of the shell history scrollback buffer

However, looking at the implementation (KeyboardTranslatorReader::parseAsCommand() in src/keyboardtranslator/KeyboardTranslatorReader.cpp), the strings actually recognised (case independent) should be respectively:

scrolllineup
scrollpageup
scrolllinedown
scrollpagedown
scrolluptotop
scrolldowntobottom

The strings for the first four are incorrect - either the documentation or the code needs to be changed as appropriate.

STEPS TO REPRODUCE

1. Configure Konsole with a key mapping for a special function, as described in the handbook.
2. Press the configured key.
3. Observe that it transmits a literal string, instead of performing the special function.

SOFTWARE/OS VERSIONS

Operating System: Gentoo 2.17
KDE Plasma Version: 6.5.80
KDE Frameworks Version: 6.19.0
Qt Version: 6.9.2