Where can I find a document that explains what all the little icons/glyphs/graphics mean that you see in the XPCE graphical debugger? I looked through the Help docs and didn’t find anything. For example what does the two headed red arrow next to a line of code in the debugger mean in the Call Stack window, etc.? If I could find a complete list of these graphical elements I’d appreciate it.
The two-headed icon indicates there is an open choice. Single headed means the environment has no choice open. Frames to the left represent the call stack. Those more to the right represent goals that succeeded with a choice point. The arrows connect the choice points from latest to older ones. You can click on any of the frames. Those on the call stack gets you to the parent frame. Those to the right show which was the last clause that succeeded. You can use ‘u’ from the choice points to include the callers into the overview.
There is no overview. If someone wants to write one, I’m happy to help and correct. I hoped the icons are fairly intuitive (surely they are ugly ). There are several way of using the debugger that are less obvious though, notably for navigating the stack view.
That gets you into the main file. The icons are in the icons sub directory. If the above starts the default editor, use ^C^F to browse for a new file and (thus) shows the directory or use the menu File/Properties
Part of the trick is to find prolog_debugger. To do that, start tracing. If you see the tracer, use the menu Help/XPCE Manual. This opens a little window with only a menu. Click Tools/Visual hierarchy. Now click the pointing hand button in the new window and then click in the graphical debugger. Now you should see a hierarchy of visual objects. Make a clever guess where the interesting stuff starts and use the right-click on it to select Source.