Home
Managing change and releases
Learn how to manage change and release in the product.
Guide to building software on Windows
VersionVault build concepts
HCL VersionVault supports makefile based building of software systems and provides a software build environment closely resembling that of the make program.

Managing change and releases
Learn how to manage change and release in the product.
- Managing software projects
- Workflow for creating projects
- Workflow for making baselines
- Workflow for recommending baselines
- Guide to building software on Linux and UNIX
- Guide to building software on Windows
  - VersionVault build concepts
    HCL VersionVault supports makefile based building of software systems and provides a software build environment closely resembling that of the make program.
    - Overview of the HCL VersionVault build scheme
      Learn about the build scheme of VersionVault.
    - Dependency tracking of MVFS and non-MVFS files
      You can track MVFS and non-MVFS files.
    - Derived objects and configuration records
      When it finishes executing a build script, clearmake or omake records the results, including build audit information, in the form of derived objects and configuration records.
    - Build avoidance
      Learn how clearmake or omake attempts to avoid rebuilding derived objects.
    - Express builds
      Learn features of Express builds.
    - Build auditing with clearaudit
      Learn about build auditing with clearaudit.
    - Compatibility with other make programs
      Many make utilities are available in the multiple-architecture, multiple-vendor world of open systems. The HCL VersionVault clearmake and omake programs share features with many of them and have some unique features.
    - Parallel building
      Learn about parallel building.
  - Derived objects and configuration records
    Learn about derived objects and configuration records.
  - Pointers on using HCL VersionVault build tools
    Learn about how to use VersionVault build tools.
  - Working with DOs and configuration records
    You can perform operations on derived objects and configuration records.
  - clearmake makefiles and BOS files
    The HCL VersionVault build program, clearmake, can process makefiles.
  - Using clearmake compatibility modes
    clearmake is designed for compatibility with existing make programs, which minimizes the changes you need to make to your makefiles.
  - Using HCL VersionVault to build C++ programs
    Understand the guidelines and instructions to use the VersionVault build utilities, omake and clearmake, in C++ development environments such as Microsoft Visual C++. You will learn how the makefile fragment works and also present alternate possibilities for working around the problems.
  - Using HCL VersionVault build tools with Java
    The build behavior of Java tools causes various problems for clearmake and omake. Understand the problems and some possible solutions to resolve them.
  - Setting up a parallel build
    Learn the process to set up and run parallel builds.

VersionVault build concepts

HCL VersionVault supports makefile based building of software systems and provides a software build environment closely resembling that of the make program. make was developed for UNIX systems and has been ported to other operating systems. You can use files controlled by VersionVault to build software, and use native make programs, third-party build utilities, own build programs of your company, or the VersionVault build tools clearmake, omake, and clearaudit.

The VersionVault build tools, clearmake and omake, provide compatibility with other make variants, along with powerful enhancements:

Build auditing, with automatic detection of source dependencies, including header file dependencies.
Automatic creation of permanent bill-of-materials documentation of the build process and its results.
Sophisticated build-avoidance algorithms to guarantee correct results when building in a parallel development environment.
Sharing of binaries among views, saving both time and disk storage.
Parallel building, applying the resources of multiple processors to builds of large software systems, is available within clearmake.

The clearaudit build tool provides build auditing and creation of bill-of-materials documentation.

clearmake and omake are intended for use in dynamic views. You can use them in a snapshot view, but the features that distinguish them from ordinary make programs (build avoidance, build auditing, derived object sharing, and so on) are not enabled in a snapshot view or an automatic view.

clearaudit requires a dynamic view context to be executed. clearaudit cannot be executed in a snapshot view, a web view, or an automatic view.

Both clearmake and omake incorporate the major VersionVault build-related features. The strength of omake lies primarily in its support for users who require compatibility with other Windows-based build programs. For details specific to omake, see the Help. In all other build-related documentation, the primary emphasis is on clearmake behavior.