https://bugs.kde.org/show_bug.cgi?id=467867

            Bug ID: 467867
           Summary: kdialog --slider argument is misdocumented in usage
                    text, result is buggy behaviour
    Classification: Applications
           Product: kdialog
           Version: 22.12.3
          Platform: Neon
                OS: Linux
            Status: REPORTED
          Severity: minor
          Priority: NOR
         Component: general
          Assignee: br...@frogmouth.net
          Reporter: k...@callthecomputerdoctor.com
  Target Milestone: ---

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

-- 
You are receiving this mail because:
You are watching all bug changes.

Reply via email to