 -MoVe_file(1)

NAME
-MoVe_file - rename one or more files as part of a change

SYNOPSIS
-MoVe_file [ option... ] old-name new-name [ old1 new1 [ old2 new2 ] ]
-MoVe_file -List [ option... ]
-MoVe_file -Help

DESCRIPTION
The -MoVe_file command is used to copy a file into a change and change its name at the same time.

The named files will be copied from the baseline (old-file) into the development directory (new-file), and added to the list of files in the change.

Warning: If there is already files in the development directory of either the old-name or the new-name they will be overwritten.

The old-file in the development directory will contain 1KB of random text. The random text is sufficiently revolting that most compilers will give error messages, should the file be referenced accidentally. This is often very helpful when moving include files.

You may rename directories. All the files in the old-name directory tree will be renamed to be below the new-name directory tree.

  Process Side Effects
This command will cancel any build or test registrations, because adding another file logically invalidates them.

When the change files are listed ( -List Change_Files -TERse) the new files (new-name) will appear in the listing, and the removed files (old-name) will not appear in the terse listing. Similarly, when the project files are listed with an explicit change number ( -List Project_Files -TERse -Change N) none of the change's files, including both the new and removed files, will appear in the terse listing. These two features are very helpful when calling from within a DMT to generate the list of source files.

  Notification
The new_file_command and remove_file_command in the project config file are run, if set. The project_file_command is also run, if set, and if there has been an integration recently. See aepconf(5) for more information.

  Notification
On successful completion of this command, the notifications usually performed by the aerm(1), aenf(1) and aent(1) commands are run, as appropriate. These include the project_file_command, new_file_command, new_test_command and remove_file_command fields of the project config file. See aepconf(5) for more information.

OPTIONS
The following options are understood:

RECOMMENDED ALIAS
The recommended alias for this command is
csh%	alias aemv ' -mv \!* -v'
sh$	aemv(){ -mv "$@" -v}

ERRORS
It is an error if the change is not in the being developed state.
It is an error if the change is not assigned to the current user.
It is an error if either file is already in the change.

SEE ALSO

aecp(1)
    copy files into a change

aedb(1)
    begin development of a change

aemvu(1)
    undo the rename files as part of a change

aenf(1)
    add files to be created by a change

aenfu(1)
    remove files to be created by a change

aerm(1)
    add files to be deleted by a change

aermu(1)
    remove files to be deleted by a change

aeuconf(5)
    user configuration file format