Selecting resources to exclude from Rational Team Concert source control

Eclipse workspaces often include files or folders, such as compiler output, log files, and so on, that you do not want to place under source control. You can specify resources or classes of resources to be ignored by Rational Team Concert™ source control. Ignored resources are never checked in.
About this task

The list of resources to be ignored by Rational Team Concert source control is kept in a file named .jazzignore. There is typically a .jazzignore file in the project root folder. There can also be .jazzignore file in any subfolder. Files and folders whose names appear (or match patterns) in .jazzignore will not be checked in, and so cannot become part of a change set. (Rational Team Concert source control ignores two types of files by default: resources ending in .class, and everything contained in the bin directory of an Eclipse project root.)

Eclipse provides its own ignore facility but, unlike Rational Team Concert source control, does not support a way to share a list of ignored resources with your team. When you first use Rational Team Concert source control to share a project in your Eclipse workspace, the Share Project wizard prompts you to review any existing ignore patterns. Click Import Team Ignores in the wizard to see the list of patterns that are currently ignored by Eclipse. You can remove a pattern from the list by selecting it and clicking Remove Pattern. If you suspect that Eclipse is ignoring a resource for any reason, open the resource's Rational Team Concert source control properties page and look for an Ignored due to line.

There are several ways to create and manage the list of ignored resources:
  • If a resource that you do not want to add to Rational Team Concert source control appears in an open change set or Unresolved folder, right-click it and click Ignore. The resource is added to the .jazzignore file, which becomes part of the current change set.
  • In the Eclipse Package Explorer view (or any Eclipse view that supports Team operations), right-click the resource and click Team > Add to ignore list. Files added to the ignore list are immediately removed from open change sets or the Unresolved folder, and the modified .jazzignore file becomes part of the current change set.
  • To remove a resource from the ignore list so that you can add it to a change set, right-click the resource and click Team > Remove from ignore list.
  • You can edit any .jazzignore file to add, change, or remove ignored patterns and file names. To specify names and patterns to be ignored in all folders of a project, add the names and patterns to the value of the core.global.ignore property in the .jazzignore file at the project root. For example, to ignore all files in a project that have suffixes .htm, .html, and .cat, set the value of core.global.ignore as follows:

    core.global.ignore= *.htm *.html *.cat

    To specify names and patterns to be ignored in a specific folder, add the names and patterns to the value of the core.ignore property in the .jazzignore file in that folder. (The value of core.global.ignore is ignored in .jazzignore files in subfolders of a project root.)
Note: A .jazzignore file is treated like any other file under Rational Team Concert source control. When you modify it, you must check it in to copy it to your repository workspace. If you are working with a team, you must deliver it before other team members can accept it to see its effects in their own workspaces.

Feedback

Did this help? You can provide feedback at Jazz.net (registration required): Comment in the forums or submit a bug