Excluding Files and Directories from Source Control

You can configure the Dimensions for Eclipse Plug-in to exclude specified files from source control. You can configure Eclipse to ignore (exclude) your back up or temp files, which will help eliminate unnecessary files from your Dimensions CM project.

The Dimensions for Eclipse Plug-in has two options for ignoring files from source control:

The standard Eclipse preferences ignores files based on a global preference setting. The standard preferences uses a pattern match to determine if files should be ignored. The preferences automatically searches any derived resources, however it has some deficiencies. The standard preferences test only leaf names after containers have been expanded, which means that certain patterns will not get ignored as intended. For example, specifying temp* will ignore files called temp, temp.txt temperance.txt but it will not ignore files in a directory temp or any subdirectories of temp. A second limitation is that specifying temp.txt will ignore it across all projects and directories. It may be necessary to ignore just one particular file with the name.

The .dmignore file ignores files and directories based on the entries in the .dmignore file. This file contains project-specific ignore patterns which will be used in addition to the standard preferences. dmignore supports wildcards and pattern matching for both files and directories. A .dmignore file applies to all files and directories in the folder in which it is located; however it doesn't apply to subfolders. For example, if .dmignore contained the entry temp* and you had the following structure:

 

project

.dmignore

temp.txt

temp/file1.txt

dir1/temp1.txt

the temp.txt file and the temp folder (and its subfolder) would be ignored. The temp1.txt file would be included because it is in a subfolder. To ignore this file, you would add an additional .dmignore file in the dir1 subfolder.

To apply ignore rules recursively, add ’r:’. For example, to ignore all *.xml files in the current folder and all child folders:

r:*.xml

To clear all recursive rules inherited from parent .dmignore files, add ’c:’. For example, if a parent ignore file includes:

r:*.xml

and you add c: to the current ignore file, then all xml files in the current folder, and all child folders, are not ignored.

TIP  Place the .dmignore files under source control.

When you perform a source control activity, such as synchronizing a project, the integration runs the ignore checks based on the selection context. The following rules apply to the checks: