RADE

Source Code Manager

adl_mv

Moving objects

Quick Reference

Abstract

The adl_mv command moves or renames SCM objects (frameworks, modules, file or directories) in an image of the current workspace.

Synopsis
Usage
Options
Examples
References

Synopsis

adl_mv source target [-force] [-h|-help|-?]
adl_mv source target_dir
adl_mv source ... target_dir

[Top]

Usage

The use of this command is similar to the “mv” Unix command: depending on the number and the type of the arguments (file, directory) the command moves or renames the file(s)/directory(ies).

Example: adl_mv source target
Source is the path of an existing SCM object, object to be renamed, and target is the name of the file destination (SCM object not existing).

Example: adl_mv source target_dir
source is the path of an existing SCM object, object to be moved and target_dir: is the path of an existing directory.

Example: adl_mv source1 source2... target_dir
Source1 source2… is the path of existing SCM objects, objects to be moved and target_dir: is the path of an existing directory.
The command requires as input arguments from 2 to n file names or directories. If two parameters are given, they can be either files or directories If n parameters are given, with n>2, the last parameter must be a directory and all the data will be moved in this directory (see examples).
If the last parameter is an existing directory, data are moved in this directory. If the directory does not exist, the last parameter is the name of the new directory to move or rename.
It is not possible to move files or directories to a directory not yet known of SCM (see adl_mk_dir command).

[Top]

Options

adl_mv accepts the following options:

`-h\|-help\|-?`	Help of the command
`source target`	Path of any existing SCM object source to rename and Path of the target (non existing SCM object)
`source target_dir`	Path of the existing SCM object source to move and path of the existing SCM object target directory
`source ... target_dir`	Paths of the existing SCM object sources to move and path of the existing SCM object target directory
`-force`	Ignore other SCM objects whose names conflict with the new one to create

[Top]

Examples

Rename a file "MyFile" in the workspace "MyWs" to a file "MyNewFile":

adl_mv MyFile MyNewFile
Moving the object "MyWs/MyFw/src/MyFile" to "MyWs/MyFw/src/MyNewFile" in the workspace "MyWs" and the workspace tree "ToolsTree".
Command successful

Move a file "MyFile" in the workspace "MyWs" to a directory "MyDirectory":

adl_mv MyFile MyDirectory
Moving the object "MyWs/MyFw/src/MyFile" to "MyWs/MyFw/src/MyDirectory/MyFile" in the workspace "MyWs" and the workspace tree "ToolsTree".
Command successful

Move a framework "MyFirstFw" in a framework "MySeconfFw":

adl_mv MyFirstFw MySecondFw
Moving the object "MyWs/MyFirstFw" to "MuWs/MySecondFw" in the workspace "MyWs" and the workspace tree "ToolsTree".
Command successful

Move a module "MyFirstModule.m" in a framework "MySeconfModule.m":

adl_mv MyFirstModule.m MySecondModule.m
Moving the object "MyWs/MyFw/MyFirstModule.m" to "MyWs/MyFw/MySecondModule.m" in the workspace "MyWs" and the workspace tree "ToolsTree".
Command successful

[Top]

References

[1]	adl_mk_elem: Creating an object
[2]	adl_rm_ws: Deleting a workspace

[Top]

History

Version: 1 [Mar 2001]

Document created

[Top]