RADE

Source Code Manager

adl_rm

Deleting objects

Quick Reference

Abstract

The adl_rm command deletes objects (frameworks, modules, file or directories) from the current workspace.

Synopsis
Usage
Options
Examples
References

Synopsis

adl_rm object... [-unco] [-h|-help|-?]

Usage

This command deletes SCM objects (frameworks, modules, file or directories) from the current workspace. Objects are deleted from the current image of the current workspace. These object have been created with SCM command, as [1] adl_mk_elem, adl_mk_mod or adl_mk_data. To delete the whole workspace, run the [2] adl_rm_ws command.

The command requests, as input argument, the access path to a SCM object of the current image of the current workspace.

The deleted objects cannot have checked-out files. If so, the command fails. Use the “-unco” option to cancel a check-out, which should have been made on the files to be deleted, or on the files belonging to a directory to be deleted.
If you finally don't want to remove this object, you can restore it with the [3] adl_unrm command.

Remark: Data are deleted from the workspace and from the current image. To delete them as well in the other workspace images, you need to run the adl_refresh command in each of them.

If an element is checked-out, or acquired in private mode, in an image of the workspace, when a remove (rm) is done on a framework, a module, a data or a directory, then the command fails.
This rule only applies to the workspace images other than the current image, if you use the “-unco” option.

Do not mix up the adl_rm command (propagation of the destruction via the flow commands between workspaces) with the adl_detach command, which is useful only when components are no longer needed for the development done in a given workspace, but may still be useful elsewhere.

[Top]

Options

adl_rm accepts the following options:

`-h\|-help\|-?`	Help of the command
`objects`	Path(es) of the object(s) to remove
`-unco`	Uncheck-out contained elements in the current image

[Top]

Examples

Delete a file "MyFile" in the workspace "MyWs":

adl_rm MyFile
Removing the object "MyFile" in the workspace "MyWs" of the workspace tree "ToolsTree".
Command successful

Delete a file "MyFw/src/MyWrongFile" not in the current workspace:

adl_rm MyWrongFile
Verifying the path "MyFw/src/MyWrongFile"
#ERR# ADLCMD - 0867: "MyFw/src/MyWrongFile" is neither a file nor a directory, but a projected object is expected.
Choose an existing object path.

##### THE COMMAND ENTIRELY OR PARTIALLY FAILED #####

Delete a file "MyFw/src/MyFile", already in an official check-out mode

adl_rm MyFile
#ERR# ADLCMD - 1411: One or several officially or privately checked-out files exist in following image(s): image_MyWs
You may use the option -unco in order to uncheck-out all these contained elements in the image image_MyWs.
In the other images, use adl_co to keep the modifications on the private files, or adl_rm_priv to lose them and use adl_ci to keep the modifications on checked-out file(s), or adl_unco to forget them.

##### THE COMMAND ENTIRELY OR PARTIALLY FAILED #####

Delete a file "MyFw/src/MyFile", already in an official check-out mode

adl_rm -unco MyFile
Removing the object "MyFile" in the workspace "MyWs" of the workspace tree "ToolsTree".
Command successful

Remove a directory "MyDirectory" in the workspace "MyWs":

adl_rm MyDirectory
Removing the object "MyDirectory" in the workspace "MyWs" of the workspace tree "ToolsTree".
Command successful

[Top]

References

[1]
[2]
[3]

adl_mk_elem: Creating an object
adl_rm_ws: Deleting a workspace
adl_unrm: Retrieving an object

[Top]

History

Version: 1 [Mar 2001]

Document created

[Top]