Bug 467867

SUMMARY

kdialog's usage help text is missing important arguments for the --slider option. Without knowing what is missing, the resulting dialog does not work.

The min, max, and step values are coded to be optional, but without them, the dialog is useless and appears buggy. Moreover, the slider step value does not have any GUI effect or constrains the return value.

STEPS TO REPRODUCE

1. To see unclear usage text, in Konsole, type: kdialog
...
--slider <text>                   Slider dialog box, returns selected value
...

This line should be:
--slider <text> <min> <max> <step>                   Slider dialog box, returns selected value

https://invent.kde.org/utilities/kdialog/-/blob/master/src/kdialog.cpp#L328

2. Type: kdialog --slider "some text"

This is invoking kdialog as described exactly by the usage text. A dialog will appear with the label "some text", a slider that is stuck at the left, and on my system, by trying to click on the slider thumb, the thumb doesn't move but the entire window does. (I have set the Breeze theme to drag a window when you click in an unused part of a window. With that setting off, nothing happens.) Either way, a bug.

3. Type: kdialog --slider "some text" 1 100 10

This is invoking kdialog as it intended to be, with min, max and step values. A dialog will appear and the slider is movable. Dragging the thumb and clicking OK returns the result of the thumb. However, the "step" value of 10 does not seem to have any impact on visual or returned step sizes, a bug.

https://invent.kde.org/utilities/kdialog/-/blob/master/src/kdialog.cpp#L1058

4. The link to the kdialog documentation in the README.md file is invalid:

https://invent.kde.org/utilities/kdialog/-/blob/master/README

The only documentation for --slider I could find was someone's blog:

https://mostlylinux.wordpress.com/bashscripting/kdialog/#slider

The following better than nothing, but is out of date:

https://develop.kde.org/docs/administration/kdialog/


SOFTWARE/OS VERSIONS

Operating System: KDE neon 5.27
KDE Plasma Version: 5.27.3
KDE Frameworks Version: 5.104.0
Qt Version: 5.15.8
Kernel Version: 5.19.0-35-generic (64-bit)
Graphics Platform: X11