 -CoPy_file_Undo(1)

NAME
-CoPy_file_Undo - reverse action of aecp

SYNOPSIS
-CoPy_file_Undo [ option... ] filename...
-CoPy_file_Undo -List [ option... ]
-CoPy_file_Undo -Help

DESCRIPTION
The -CoPy_file_Undo command is used to delete files previously copied into a change. The named files will be removed from the list of files in the change.

The file is deleted from the development directory unless the -Keep option is specified. The -Keep option should be used with great care, as you can confuse tools such as make(1) by leaving these files in place.

You may name a directory to delete from the change all files in that directory tree previously copied into the change, other files in the tree will be ignored. It is an error if there are no relevant files.

  Branch vs Change
The aecpu(1) command may only be applied to a change. If you wish to perform the same operation on a branch, use the aemt(1) command, through the agency of a change.

  Process Side Effects
This command will cancel any build or test registrations, because deleting a file logically invalidates them. If the project configuration file was deleted, any diff registration will also be canceled.

The difference file (,D) will also be removed, however any DMT derived files (e.g a .o file from a .c file) will not be removed. This is because is decoupled from the DMT, and cannot know what these derived file may be called. You may need to delete derived files manually.

  Notification
The copy_file_undo_command in the project config file is 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.

OPTIONS
The following options are understood:

-Read_Only
    This option may be used to specify that only insulation files are to be uncopied. If you specify -UNChanged as well, only unchanged insulation files will be uncopied.

-UNChanged
    Examine the named files to see if they are unchanged. Only remove the unchanged files from the change, and leave the files which have changed. If no files are named on the command line all change files are checked.

RECOMMENDED ALIAS
The recommended alias for this command is
csh%	alias aecpu ' -cpu \!* -v'
sh$	aecpu(){ -cpu "$@" -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.

SEE ALSO

aecp(1)
    copy files into a change

aemt(1)
    make branch files transparent

aeuconf(5)
    user configuration file format