csrcs-opentool

JBuilder OpenTool for the Component Software RCS

• sourceforge project
• download current version

• introduction
• features
• installation
• to do
• license

• introduction •

ComponentSoftware RCS is a stable and intuitive integration of GNU RCS into the Windows environment that is easy to use and cost-effective (the basic version for independant developers is free!). This project provides an OpenTool to integrate CS-RCS into Borland's JBuilder IDE.

You can add new classes to the repository, check files in/out, open revision history, display a visual diff to see what you've changed, etc. from the toolbar or context menu actions.

Installation and configuration are effortless (all you have to do is copy the jar into your ext directory and restart JBuilder).

• features •

It adds buttons to the toolbar, and menu items to the project pane and file edit contect menus to support these operations:
* adding files to the repository
* checking out files from the repository (updates with latest from repository, locks file if needed)
* checking in files (saves file, requests comment and offers visual diff, stores version in repository)
* getting file status (saves file, displays info on status i.e., not added, modified from repository, not modified)
* getting file revision history
Most of these options can also be performed on the project level (with an associated CS-RCS project) and on multiple files at a time (select multiple nodes, or a folder node).

For single files, menu options are selectively greyed-out when they are not relevant to the file's current status.

• installation •

Prerequisites:
* Windows OS
* JBuilder 4+ any level installed (the free personal/foundation versions will work just fine).
* CS-RCS personal (free) 2.5 or greater installed, possibly also earlier versions.

I've tested this opentool on Windows 2000, JBuilder 6 Professional and JB8 and 9 Personal, CS-RCS 2.5.140 and CS-RCS 3.0 Personal and CS-RCS 3.0 Pro. I specifically avoided the CVS interface included in JBuilder OpenTools because that requires JBuilder enterprise edition. Please send me an email if you are using this successfully on other versions of JBuilder, and/or other versions of CS-RCS so I can include that info here.

Installation:
* copy the csrcs.jar file into your lib\ext\ directory (in the directory where you installed JBuilder)
* restart JBuilder

If you didn't use the default path when installing CS-RCS, you'll be prompted for the location of your csrcs.exe executable. Find your CS-RCS installation, open the System folder, and select the csrcs.exe file there. You'll only need to do this step once (your selection is saved in a properties file).

• to do •

There are no known bugs, and I've added all of the features I wanted. What's on your wishlist?
One last thing I've been thinking about -- an option to disable CSRCS integration, for times when you're working remotely and can't access the server hosting your RCS tree. It'd be easier than removing the opentool jar....

I'm also thinking of integrating CS-RCS into the Eclipse IDE (since I switched over a while ago). Update: I'm not going to be implementing this plug-in personally, but I've had some conversations with Component Software, and they may be developing it in-house at some point. If you're interested in either helping or using a CSRCS plug-in for Eclipse, you should let them know.

• support •

Please report bugs, including detailed descriptions of how to reproduce the problem, to csrcs@jtheory.com. I don't guarantee timely fixes, but I am also willing to email you some tips on where to look in the code to fix the problem yourself.

• license •

csrcs-opentool: JBuilder OpenTool providing for integration of the Component Software RCS.
Copyright © 2004 JTheory Creations

This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2.1 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
See the GNU Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public
License along with this library; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

The csrcs-opentool project is hosted by SourceForge.