 -CLEan(1)

NAME
-CLEan - clean files from development directory

SYNOPSIS
-CLEan [ option... ]
-CLEan -Help
-VERSion

DESCRIPTION
The -CLEan command is used to remove all files which are not change source files from a development directory. This can be used to obtain a “clean” development directory before a final build, to ensure that a change is ready to end development. A new build will be required.

This command is only allowed in the “being developed” state, and only the change's developer may issue it. It may not be applied to branches.

All symbolic links will be removed from the development directory, even if remove_symlinks_after_build = false in the project config file. The symbolic links will be re-installed, if create_symlinks_before_build = true. This is to ensure that the symlinks are accurate, and that unnecessary ones are removed.

All special device files, pipes and sockets will be removed. These files cannot be source files, and it is expected that the following build will restore them.

All derived files created by previous builds of the change will be removed. It is expected that the following build will recreate them. Any temporary files you may have created in the development directory will also be removed.

The develop_begin_command in the project configuration file (see aepconf(5) for more information) will be run, if there is one. The change_file_command will be run, if there is one. The project_file_command will be run, if there is one.

You will be warned if any of the files are out-of-date and need to be merged. You will be warned if any files need to be differenced.

  Notification
The notification commands that would be run by the aecp(1), aedb(1), aenf(1), aent(1) and aerm(1) commands are run, as appropriate. The project_file_command is also run, if set. See aepconf(5) for more information.

OPTIONS
The following options are understood:

-TOuch
    This option may be used to request that each change source file have its last-modified time-stamp be updated to the current time. This is the default. Derived files and other non-source file are left alone.

-No_TOuch
    This option may be used to request that the last-modified time-stamp of each source file be left unmodified.

-MINIMum
    This option may be used to request a minimum set of symbolic links, when the create_symlinks_to_baseline functions are being used. This is useful if you want to simulate something like aeib -minimum in the development directory. This option is not meaningful if symbolic links are not being used.

    This option also says not to remove normal files which occlude project source files. This is a common technique used to temporarily over-ride project source files. The “aecp -read-only” command would have been more appropriate.