unuse command

You can remove an existing file, directory, root directory, or project from the current project or directory. The directory must be modifiable to remove members from it. If you try to remove an object from a non-modifiable directory, the directory is automatically checked out (unless you specify the -r option). You must check in the directory to make the files in the directory available to other users.

The root directory can be the command target, but only when specified with the -d and -r options. If you want to use a different version of the root directory, use the use command. You cannot cut the root directory without replacing it because a project must always have a root directory.

Note: When you cut an object in a non-modifiable directory, a new directory version is checked out automatically unless you replace the object with a different version.

If you are working in a shared project and the directory is non-modifiable, the directory is checked out and associated automatically with the specified task. The directory is then checked in to the integrate state. You can disable automatic check-in by setting shared_project_directory_checkin to FALSE in your initialization file.

If you want to delete a project, see the delete command (ccm delete -p project_name-version).

You can start the command from any location if you use the Folder specification:

Windows: relative_path\object_name@project_name-project_version

UNIX: relative_path/object_name@project_name-project_version

The following is an example of the project reference form and how to use it to delete the root directory, ico/hi_world.c@final-1:

ccm unuse -d -r final@final-1

A message reports the object_version that was removed and which version replaced it.

The unuse command supports these subcommands:


Feedback