This form refers to an object in a maintained project work area by its path in the work area.
This form refers to an object by its relative path within a specified project.
An object name can contain up to 155 characters. The object version can contain up to 32 characters.
When an object version is a member of a project and the project is synchronized under a work area directory in the file system, you can reference the object version by its path in the projected directory structure.
Examples here use Windows paths. The functionality is the same on UNIX. For example, if the main.c-4 object version is a member of the jobA-1 project under the dir1 directory and the project work area is c:\users\joe\ccm_tutorial, the work area reference form for main.c-4 is as follows:
c:\users\joe\ccm_tutorial\jobA-1\jobA\dir1\main.c
dir1\main.c
You can augment the work area reference with the version to refer to another version of the object:
Use this file specification to refer to any different versions of the object version.
For example, if main.c-4 is a member of the current project and has a predecessor main.c-3, you can reference the predecessor by using the relative path belonging to main.c-4:
dir1\main.c-3
A project reference form refers to a project, directory, or file by its relative path within a specified project. This form can be used even if the project does not have a maintained work area or if that work area is not visible to the client. You can use the following forms:
where relative_path is a relative path that can use forward slashes (/) or backslashes (\) as file separators, project_spec is a project specification, version_delimiter is the current version delimiter (default is a hyphen (-)), and version is an optional version of the object. If you do not specify a version, the referenced object is the version used in the project.
The relative path is relative to the top of the project. For example, the specification myproject\src\ClientContext.java@myproject:1 refers to the current version of a file named ClientContext.java under a directory named src under the root directory myproject of the project myproject:1.
You can specify an optional version after the relative path. For example, the specification myproject\src\ClientContext.java:23@myproject:1 refers to the version 23 of a file named ClientContext.java under a directory named src under the root directory myproject of the project myproject:1.