Skip to main content

Using Debugger Configuration files

Andy Kramek has a great post explaining Form Event Sequences in VFP and while reading it, I was also debugging a piece of code in which I had the fortune (or misfortune) to use the Track Events feature in the Debugger. (what do the two have in common? You can actually see the Form Event Sequences very easily by using the Track Events feature).

Track Events is one of those features that doesn't appear useful until you actually need to use it. The big problem is that you have to spend quite a bit of time either a) selecting each event you want to track OR b) selecting all and then removing the events you don't need to track.

Some basic events whose tracking simply takes up space and I almost always turn off:
Paint
MouseMove
MouseEnter
MouseLeave

One feature that I don't see used that often by other developers is the ability to save the Debug configurations. The debugger typically retains all of the settings from the previous session so why would you need to save a separate configuration, right?

The Debug configuration saves all aspects of your debug environment: your breakpoints, your event tracking and your watch window. But when you're in the heat of development, you may find yourself creating so many breakpoints or watch items that it's hard to keep track of. Here are some reasons you may want to save it:

1) You work on multiple projects (clients?) and want to retain a particular debugging environment for one client while using another for a different client

2) You want to maintain different configurations for different types of debugging sessions (looking for events, waiting for click and valid events, etc).

3) You are working on a particular problem and have to step away for a minute.

So what's in a configuration file?

Debug configuration files have a DBG extension and are simply text files that can be easily parsed or created on the fly. Here's a sample:

DBGCFGVERSION=4
WATCH=llreporun
WATCH=PROGRAM()
BPMESSAGE=ON

BREAKPOINT BEGIN
TYPE=3
CLASS=    
LINE=0
EXPR=fl_btnok
DISABLED=0
EXACT=0
BREAKPOINT END

BREAKPOINT BEGIN
TYPE=0
FILE=c:\health\illcheck.prg
LINE=51
DISABLED=0
EXACT=0
BREAKPOINT END

BREAKPOINT END

EVENTWINDOW=ON
EVENTFILE=
EVENTLIST BEGIN
Load, RightClick, Valid, When
EVENTLIST END

The DBGCFGVERSION is important. VFP 9 won't load any files that have a value of 4.

The first part is the WATCH area, followed by the BREAKPOINTS.
The Breakpoint type is evaluated as:
0 - Break at location
1 - Break at location if expression is true
2 - Break when expression is true
3 - Break when expression has changed

If you use the Pass setting, it also adds a PASS=xxx setting within the BREAKPOINT area.

One thing that DOESN't get saved in the DBG file is what debug windows were open. Also note that if you choose Restore to Default from the Window menu, it doesn't just restore the windows to their default position, it clears out all of the settings as well - another reason to save your commonly used debug configurations for future use.

How do you use the debug configuration files?

Comments

Rick Schummer said…
One of my favorite things to do with the Debug Config file is to sort the Watches. I have wished Microsoft would add new watches to the top of the list so I don't have to scroll down to see the newest one. If you save the Debug Config you can rearrange the Watches in the text file, and reload. Now the watches are in the sequence I prefer.
Andrew MacNeill said…
Great idea.

Almost wish we had extensibility in the debugger for some of these things but I imagine you could build it into your project manager or a separate sub menu
Tamar E. Granor said…
Just want to point out that combining Event Tracking with the DEBUGOUT command can be incredibly useful. It lets you see what's firing and get information about what's going on inside those (or other) methods.

Popular posts from this blog

Blogs and RSS come to Microsoft.com

MS has just introduced their portal and it's pretty comprehensive. Nothing quite like learning that some people use AIM instead of MSN messenger, or that there really may be a need for supporting 4 monitors ( Cyrus Complains ) However, it's really a great sign that MS is serious about supporting the blogging community which seems to have um, exploded in size in the past year. Blogs and RSS come to Microsoft.com

FoxInCloud Stats

FoxInCloud sent this link a while back about their statistics regarding visits to their site: http://foxincloud.com/blog/2017/12/27/VFP-community-lessons-from-foxincloud-site.html What's interesting here is the breakdown of people. Yes, I think it's understandable that the Fox community is getting older. Another factor is the growth of the mobile and web environments taking over development. These environments really do push people towards the newer non-SQL or free SQL/hosted environments but more towards hosted storage options like Amazon and Google. A tool like FoxInCloud that helps MOVE existing applications to the cloud inherently competes with those environments. But FoxInCloud also allows developers to extend their application further by giving them a starting point using Javascript and the basic CSS (such as Bootstrap). If you're not rebuilding your application from scratch, it's certainly a great step forward. FoxPro VFP

5 Great Reasons to attend Virtual FoxFest

What's coming up? Virtual FoxFest is coming up soon (sessions start October 14th). Like last year, the conference is entirely virtual yet includes great breakdown rooms and sessions to add that nice one-on-one feel that you get in person. It's also staggered so you can choose which days you want to attend - October 14th, 20th and 26th. This is great if you can't break away for a consecutive three days. But really, I've gone through the sessions and I see five great sessions that I'm eager to check out. 1. A Decade of Thor (Rick Schummer) Thor has been an extension for Visual FoxPro that many developers swear by, yet many don't know even exists. Visual FoxPro's built-in extensions are great but Jim Nelson's Thor supercharges your IDE. I can't believe it's been ten years - so Rick's session should be able to not just whet your appetite but give you all the reasons you should be using it. 2. VFP C++ compiler.  Last year, we saw DotNetX as well