Cleaning Up After Builds

A clean build is a build that starts with no input other than source files, including the configuration file. The first time you build a new project, VisualAge C++ performs a clean build. Cleaning up the build environment after builds involves removing all files produced by previous builds so that the next build is the equivalent of the first build for the project.

By default, the build process creates a codestore. If the build is successful, the target files specified in your configuration file are produced. Other intermediate or temporary files may also be produced by the build process, build extensions that you use, or by command line programs that you start with the run directive in your configuration file.

You can clean up the build environment after you have performed a number of builds. This is analogous to including a "clean" directive block in makefiles in traditional build environments.You may want clean up the build environment for a number of reasons:

You can always delete the codestore file directly, but cleaning up the build environment is preferable because it ensures that all files produced by a build are deleted.

To clean up the environment, select Clean from the Project Workbook menu of the IDE. The cleanup flag is passed on to all steps in the build process, including build extensions. For example the resource compiler removes old temporary resource source files during a cleanup. You should take the following additional steps to make sure the environment is completely reset:

run cleanup command_string_list

The command_string_list contains command that perform the recovery.

When the cleanup is complete, the IDE displays a box that asks you whether you want to build your project. If you reply yes, VisualAge C++ performs an initial build as though you are building this project for the first time. If you reply no, a small new codestore is created for the project because it remains open in the IDE.



Projects
Configuration Files
Codestore
Build Extensions and Extension Specification Files


Clean Up the Build Environment
Build
Run Command Line Programs During Builds


Build Extensions Supplied with VisualAge C++