Home
Managing change and releases
Learn how to manage change and release in the product.
Guide to building software on Windows
clearmake makefiles and BOS files
The HCL VersionVault build program, clearmake, can process makefiles.
SHELL environment variable
Learn about the SHELL environment variable.

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.
  - 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.
    - Makefile overview
      A makefile contains a sequence of entries, each of which specifies a build target, some dependencies, and the build scripts of commands to be executed.
    - Build options specification files
      A build options specification (BOS) file is a text file containing macro definitions and/or HCL VersionVault special targets.
    - Format of makefiles
      Understand the special considerations for using makefiles with clearmake.
    - Sharing makefiles between UNIX or Linux and Windows
      You can share makefiles between UNIX, Linux, and Windows.
    - Using makefiles on Windows
      There are several rules to follow when constructing or converting makefiles for use by clearmake on a Windows host.
    - BOS file entries
      You can put some entries in BOS files.
    - SHELL environment variable
      Learn about the SHELL environment variable.
    - CCASE_BRANCH0_REUSE environment variable
      Understand the use of the CCASE_BRANCH0_REUSE environment variable.
  - 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.

SHELL environment variable

Learn about the SHELL environment variable.

clearmake does not use the SHELL environment variable to select the shell program in which to execute build scripts. It uses Windows cmd.exe, unless you specify another program with a SHELL macro. You can specify SHELL on the command line, in the makefile, or in a build options spec; the value of SHELL must be a full path name, and on Windows, it must include the file extension.

Note: If clearmake determines that it can execute the build script directly, it does not use the shell program even if you specify one explicitly. If you use Windows .bat files in build scripts, you must make them executable (use the cleartool protect command). To force clearmake to always use the shell program, set the environment variable CCASE_SHELL_REQUIRED.