Team page (Project Properties dialog box)

The Team page of the Project Properties dialog box configures the connection to your version control repository. It must be completed before you can access your version control system.

The options available on this page depend on what you choose from the Select Version Control System menu:

If other version control systems are added to JBuilder, they will be added to this list. See the OpenTools API documentation and the Concept Document on version control for more information on how to add other version control systems to JBuilder.

CVS is a third-party program and must be installed separately on your machine. The Open Source CVS program is available online from http://www.cvshome.org/ and is on the Companion Tools CD included with JBuilder Enterprise edition. See "Installing and configuring CVS" for instructions on installing and configuring CVS.

To configure your connection to the version control repository for the current project, select Team|Configure Version Control or select Project|Project Properties and choose the Team tab.

To configure your connection to the version control repository for all new projects, choose Project|Default Project Properties.


Select Version Control System: None

When you select "None" in the Select Version Control System field, no third-party version control system is used to back up the JBuilder files that you are working on. Therefore this page has no additional options to display.

However, even when you are not using any third-party version control system within the JBuilder IDE, you can still set JBuilder to keep multiple backup copies of your work. You can use the history view to examine previous backup versions of your files within the JBuilder IDE. JBuilder automatically keeps five backup levels of each file, but you can set it to keep none or up to thirty.

To use multiple backups,

  1. Choose Tools|Editor Options menu. Select the Editor page.
  2. Slide the marker on the Backup Level bar to indicate the number of backups you want to keep. The number of backups you have selected is indicated to the right of the slide bar.
  3. Click OK to save the new configuration.

To change the backup path of your project, select Project|Project Properties and choose the Paths page. Set the backup path in the Backup Path field. Click OK to save your changes.


Select Version Control System: CVS

When you select "CVS" as your version control system, options for connection type, login settings, and module location are displayed. You also have general options to choose.

Connection Type

The type of connection you choose affects the login settings that will be required, since the needs of each connection type are distinct.

Local
The target repository is on a machine that is locally accessible. Selecting this makes all the Login Settings options inaccessible, since they are not required for this type of connection.

When you use a local connection, you can browse to your module location by clicking the ellipsis button (...).

PServer
The target repository is on a server. It may require password access, but transmissions are not encrypted over this type of connection. Selecting this makes the Remote Shell login setting unavailable, since it's irrelevant.

You may enter the domain name or the IP address of the server.

Ext
This is a remote connection type in which transmissions can be encrypted so that they can't be read in transit. Selecting this makes all of the Login Settings options available, since they are all required.

Users of the ssh secure shell, please see the Release Notes in the main Help menu for more information about your specific requirements.

Login Settings

These let JBuilder log you into the target server automatically whenever it's necessary.

Server
The name of the server where the repository is stored. This field is required when the PServer or Ext connection types are selected. If you're unsure of the name of the server, ask your server administrator.

Username
Enter the username you use to access the server where the repository resides. This field is required when the Pserver or Ext connection types are selected.

Remote Shell
Enter the name of the secure shell program you use, such as ssh. This field is required when the Ext connection type is selected.

Module Location

These settings tell JBuilder where to find the module you want to use. The required information in this area remains the same regardless of the connection type.

Repository Path
This tells JBuilder where to find the repository that contains the module you want to use.

If the repository is on a server, enter the full name of the target repository. If you have any questions about the repository's name, ask your server administrator.

If the repository is local, indicate the path to the repository, for example, c:\repo. With a local connection, you can click the ellipsis button (...) to browse to your repository.

Module Name
Type in the name of the module that you want to use for the project you're working on.

If you're setting default values for all projects using Project|Default Project Properties, consider leaving JBuilder's default value in this field (unless you will only be using one module for all your work). Then, when you use another project that goes into another module, JBuilder will prompt you smoothly and quickly through the process of setting a module name for the individual project.

General properties

The checkboxes in this dialog box allow you to set general options that can save you steps.

Autosave Files Before CVS Operations

If this box is checked, JBuilder automatically saves changed files in the buffers before performing any CVS operation. If this option is not checked and your file has not been saved yet, you will be prompted to save the file before the CVS operation occurs.

Show Console Messages

If this box is checked, JBuilder displays CVS console messages on the CVS Console tab in the message pane. To expand a message, click the switch beside it or double-click the console icon itself.

Right-click the CVS Console tab to clear CVS console messages or to remove the tab until the next time you invoke CVS.

Reset

If you make changes you decide not to keep, click the Reset button to return to the settings you had when you opened the dialog box. Once you're satisfied with your settings, click OK or press Enter to close the dialog box and return to the AppBrowser.