In Using Understand with an external editor - SlickEdit I explained how to hook up Understand to run with SlickEdit. As a follow up, here are the commands to setup the same Understand menu inside of EMACS, Visual Studio, and Vi. Do let me know if I made any mistakes here since I'm not an expert on these editors.
We've been working hard to improve Understand and have made a lot of new builds recently (4 this last week). I finally caught up with the build notes, so if you want some light reading, here you are:
I’ve covered making Snapshots from the Current Database and by checking out source to an alternate location in earlier posts. Now I’m going to tell you the EASY way to do it…. Just use TrackBack.
Assuming you have had TrackBack B443 or later monitoring your source trees, you can recreate the state of any monitored directory at any time. This includes file modification, file existance, file renaming, everything.
User tools are a convenient way to quickly access external tools or other applications. In an earlier post, Ken shared his SVN User Tools, which provide quick access to version control commands right inside the application. If you use a different version control system, or want to launch another application, you'll need to know how to make your own user tools.
The Understand 2.0 editor’s “Browse Mode” makes all entities in the editor behave like links in a web browser. With a single click you can visit and update the Information Browser.
In both 1.4 and 2.0 the usual way of exploring/learning about code in the editor is via the Right Click context menu. For instance, if I want to learn about allocstrAppend() I right click on it:
The Understand 2.0 you have just downloaded comes in four editions. They all use the same binary, only the license code affects their feature set. The editions are:
So which is right for you?
The Understand 2.0GUI has command line options that may prove useful to you automation and personal efficiency reasons.
To see the options, just start Understand with “-help”:
%understand -help
I’ve just realized that while I’ve written a bunch of posts referring to snapshots and using snapshots, I’ve never explained what they are and how they can fit into a software engineer’s workflow. Hence the “missing piece of the puzzle” clip art above.
Q: What are snapshots?
A: A snapshot is a binary store included within an Understand database. A database can hold be any number of snapshots. Each contains three things:
Q: What are snapshots used for?
A: They are used throughout Understand 2.0 to provide details and metrics about what has changed in source code between two points of time. The “Change”, “Metrics”, and “Estimate” menus all use snapshots intensively.
“Change” will tell you what has changed at the semantic level. For instance, what classes or types changed, versus just what files/lines changed.
“Metrics” can tell you the number of semantic changes – classes removed, changed, added, so forth.
A frequent complaint of Understand 1.4 users was that unless their project was syncronized to an MSVC project it was difficult to keep Understand projects up to date about new files and especially hard to keep files removed from a project from showing up again when adding new code.
Understand 2.0 addresses this with the “Watched Dir” concept. By default any directory you add is a “watched dir”.
Understand 2.0 scans all project “watched dir” for new/removed files and the project file list updated automatically. Importantly, any modifications you have manually made – either by removing or by changing file filters is remembered. In 2.0 you only have to remove a file once it won’t come back unless you add it specifically.
You can trigger a rescan with the Project->Rescan button:
Or automatically on a schedule with the Project scheduler available in Project->Configure Project:
