[Breeze] [Bug 379349] New: Icon request: breakpoint mark icon, "toggle breakpoint" action icon, breakpoint list view icon

[Friedrich W. H. Kossebau]

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

            Bug ID: 379349
           Summary: Icon request: breakpoint mark icon, "toggle
                    breakpoint" action icon, breakpoint list view icon
           Product: Breeze
           Version: unspecified
          Platform: Other
                OS: Linux
            Status: UNCONFIRMED
          Severity: normal
          Priority: NOR
         Component: Icons
          Assignee: visual-design at kde.org
          Reporter: kossebau at kde.org
                CC: kainz.a at gmail.com
  Target Milestone: ---

Created attachment 105262
  --> https://bugs.kde.org/attachment.cgi?id=105262&action=edit
Screenshot of KDevelop with breakpoint related icons

Icons  needed
-------------
When debugging a program, one can set so-called breakpoints in the sourcecode
to tell the debugger/IDE where to stop/pause the program execution, so the
developer can inspect the current state.

The usual UI for that is a column next to the source code view, where there is
a mark symbol per source code line which shows if there is a breakpoint in that
line
-> icon needed for that breakpoint mark

Then in the related menus there is an action to set/unset (resp. toggle) the
breakpoint for a line.
-> icon needed for that toggle-breakpoint menu entry/action

Then there is a separate view which lists all the existing breakpoints in the
complete software. That view often has a title and an icon (e.g. as docker
window)
-> icon needed for that breakpoint list view window

A breakpoint can have multiple states, e.g.
* enabled/normal
* disabled  -> breakpoint ignored, but mark kept around to enable it quickly
again
* conditionally enabled -> stop at breakpoint only if some condition is met
* pending -> enabled, but debugger has not yet tried to resolve the breakpoint
* invalid -> enabled, but debugger cannot resolve the breakpoint
-> additional icon variants would be nice to have

The breakpoint mark icons would be status icons, with names like:
"breakpoint" - generic fallback icon and for existing usage by e.g. kdevelop
"breakpoint-enabled"
"breakpoint-enabled-conditionally"
"breakpoint-disabled"
"breakpoint-status-pending"
"breakpoint-invalid"

The action/menu icon could be
"breakpoint-set" 

The docker window might want to reuse either status icon or action icon, seems
there is no category for object icon types.


Existing approaches
-------------------
The symbol used for the breakpoint mark in most IDEs/debugging tools is a full
red circle/dot, so should be a recognizable icon.
E.g. see https://www.google.de/search?site=imghp&tbm=isch&q=breakpoint+icon

KDE's icon tradition for the breakpoint mark is also picking up the shape of
the globally well known traffic stop signal, which also works nicely, given
it's related meaning (get to complete stop here). Might be nice to continue
this tradition.

The menu entry usually uses the same mark icon as well.

Similar the docker view with all the breakpoints.


Current approach in KDE software
--------------------------------
In KDE software the lack of such icons in Breeze (& Oxygen) is right now
handled like this:

GDB plugin for Kate:
(ab-)uses the theme icon "media-playback-pause" both for the breakpoint mark
(10x10 hardcoded) as well as for the "Toggle Breakpoint" menu entry.
See https://kate-editor.org/2010/10/06/introducing-kate-gdb-plugin/ (using
Oxygen icons, but UI still similar)

KDevelop:
uses its own icon named "breakpoint", both for the mark (16x16 hard-coded) and
the toggle-action:
https://cgit.kde.org/kdevplatform.git/plain/pics/16x16/actions/breakpoint.png
https://cgit.kde.org/kdevplatform.git/plain/pics/22x22/actions/breakpoint.png
Both rendered from
https://cgit.kde.org/kdevplatform.git/plain/pics/scalable/breakpoint.svg
The different breakpoint states are visualized using QIcon::Mode flags.
The breakpoint list view docker (ab-)uses the theme icon
"media-playback-pause".
See attached screenshot.

KDbg (while not developed in KDE community, still potential icon user):
Has it's own icons, see http://www.kdbg.org/kdbgtotal.png

-- 
You are receiving this mail because:
You are the assignee for the bug.