 -Make_Transparent(1)

NAME
-Make_Transparent - make branch file transparent

SYNOPSIS
-Make_Transparent [ option... ] filename...
-List [ option... ]
-Help
-VERSion

DESCRIPTION
The -Make_Transparent command is used to add a file to the change which will result in the named file being made transparent in the branch when the change is integrated. The version of the project file from the deeper branch will then show through.

You may name a directory to make all files in that directory tree transparent. 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 changing the change file list logically invalidates them.

  Notification
The make_transparent_command in the project configuration 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:

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

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

This command is dedicated to my wife, Mary-Therese. When I was trying to explain what this command did, she said "I had one of those on my bicycle when I was young, but it fell off".

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 the file is not present in the immediate branch.
It is an error if the file is present in the immediate branch, but is not also present in a deeper branch.
It is an error if the file is only present in the trunk branch.

SEE ALSO

aecpu(1)
    uncopy copy files from a change

aemtu(1)
    cease making branch files transparent