Bug 379349

Created attachment 105262 [details]
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