Mr N

Searching on Google can be really easy as long as you pick the right words to search for. What if you’re not sure what you are looking for or what if you don’t know what the thing (or action) is called? I was using Eclipse (the Java language editor) in its vanilla form and when I switched to Spring Tool Suite (STS) (which is a re-badged version of Eclipse) I found that the feature I thought was so useful had been switched off. I knew the feature I wanted to switch on but I didn’t know what it was called! So I’m writing this article so that others might find it and not have to spend 2 weeks looking for it. When the Eclipse feature is switched on, selecting a file to edit will open the representation of the file in the Package Explorer pane. As you open more files and switch to them in the editor pane, the focus moves in-line inside the Package Explorer. This is called Linking or Link with Editor. You are linking the Package Explorer with the Editor pane. There is a double arrow icon at the top of the Package Explorer that toggles this behaviour:

Wonderful though Clearcase is, its support tools leave a lot to be desired. Take the file comparison application that comes bundled. It only flags lines which have changed, so you often have to spend a couple of moments scanning the line to spot the changes. There are loads of file comparers out there to choose from. So here is how to integrate it with Clearcase. The simplest way is to find a file comparer with Clearcase integration capabilities like KDiff3. The integration is simple:

1. Download KDiff3 and install.
2. Run it up.
3. From the menu select Settings->Configure KDiff3.
4. Go into the Operation tab.
5. Click Integrate with Clearcase.
6. Click Ok.

Simple, but what if your file comparison tool doesn’t have an integrate with Clearcase button? Changing the Clearcase hooks is quite straight forward. The mapping file exists in:

<installation-root>\ClearCase\lib\mgrs\map

The file is keyed in extension (or class) and action, so replace the following lines in the map file.

_rftdef            xcompare  C:\Program Files\KDiff3\kdiff3.exe
_rftmap            xcompare  C:\Program Files\KDiff3\kdiff3.exe
_rftvp             xcompare  C:\Program Files\KDiff3\kdiff3.exe
_xml               xcompare  C:\Program Files\KDiff3\kdiff3.exe
_xml               xmerge    C:\Program Files\KDiff3\kdiff3.exe
_xml2              xcompare  C:\Program Files\KDiff3\kdiff3.exe
_xml2              xmerge    C:\Program Files\KDiff3\kdiff3.exe
_xtools            xcompare  C:\Program Files\KDiff3\kdiff3.exe
text_file_delta    xcompare  C:\Program Files\KDiff3\kdiff3.exe
text_file_delta    xmerge    C:\Program Files\KDiff3\kdiff3.exe
whole_copy         xcompare  C:\Program Files\KDiff3\kdiff3.exe
whole_copy         xmerge    C:\Program Files\KDiff3\kdiff3.exe
z_text_file_delta  xcompare  C:\Program Files\KDiff3\kdiff3.exe
z_text_file_delta  xmerge    C:\Program Files\KDiff3\kdiff3.exe
z_whole_copy       xcompare  C:\Program Files\KDiff3\kdiff3.exe
z_whole_copy       xmerge    C:\Program Files\KDiff3\kdiff3.exe

The clearcase reports that come out of the box only let you find out the files that have changed between 2 labels. What if you haven’t applied the other label yet, or you are writing release notes and the official labelling hasn’t taken place yet? If you have applied a label, how do you know which files have changed since then. Open a command line and switch to the view and directory path you are interested in. Issue the following command:

cleartool find . -cview -version “!lbtype(MY_LABEL)” -print

where: ‘.’ is from the current directory, -cview is current view -version “!lbtype(MY_LABEL)” is look for versions without a label called MY_LABEL -print is what to do with them.

Seems like an honest question, however the Project Voldemort website doesn’t actually tell you. Their page describes what features it has but doesn’t explicity say what it is. The Project Voldemort web site doesn’t have any email address of any of the members to ask questions, it only has an mailing list to which you can post questions. After a bit of hunting, in fact far more hunting that I would have expected I came across this article which explains what Voldemort actually is. It even mentions why the project is called Project Voldemort. http://www.bigdatabaselist.com/wiki/Project_Voldemort Prehaps they should read my article on clearly defining what a project does. “The whats and whys to creating project descriptions“.

I’ve been doing work with the SpringFramework now for about 3 years. It has been a very steep learning curve - occasionally I feel like I’m rock climbing! I started off using SpringIDE which is an open source commercial free Eclipse plugin which can aid the development of Java EE projects that use Spring. The difference between SpringIDE and Spring Tool Suite is small but subtle. SpringIDE is an Eclipse plugin where as the Spring Tool Suite is an entire version of Eclipse pre-configured with all the plug-ins SpringSource thinks you need. It even has a Spring Source splash screen when it is loading. In early 2009, SpringSource (the owners of the Spring Framework) decided to change the licence agreement of Spring Tool Suite (STS) so that it could be made freely available for development and internal business operations to use with no time limits. I’ve been using STS for a while and I recently needed to report a bug against it. But could I find where to do it? No. I searched for a couple of days and eventually had to ask in the forums. So I write this blog to help anyone else who gets lost down the rat runs of confusion between SpringIDE and STS. The big problem with reporting bugs is where do you go to do it. SpringIDE and Spring Tool Suite are both tightly coupled to Eclipse, they both have JIRA issue trackers, they are both tightly integrated into Spring and they both have Spring personnel on the support team. I suspect that in the long term SpringIDE will die as STS has loads of extra value adds and is considered the standard eclipse plugin. So to find where to report bugs:

1. Load your Eclipse environment
2. In the menus navigate to Help -> About Eclipse
3. Click the green SpringSource icon, which opens the About Eclipse Feature window
4. Click the link for the product page: http://springsource.com/products/sts
5. When the web page loads in click the link for Bug and Enhancement Database in the Related Content section

if it ever disappears again from the Related Content position (like before) then you will have to hunt around for it which was the problem before. So here it is: https://issuetracker.springsource.com/browse/STS For completeness you can report bugs against SpringIDE here: http://jira.springframework.org/browse/IDE/ According to Christian Dupuis, who is the Spring bod who looks after the SpringIDE and STS, you can raise JIRA issues on the STS Jira for both SpringIDE and STS.