Although somewhat obscured by their placement in this category, the Miscellaneous options include three very important options that affect:
- how the COPYPATH environment variable is defined
- whether when a source file is added to a project, tags are inserted in the file and a program structure file is created
The definition of the COPYPATH environment variable determines where AcuBench looks for COPY files and whether and which files
are found. COPYPATH's correct definition is essential to a successful build. For a detailed discussion of the COPYPATH environment
variable, see The COPYPATH Environment Variable.
Use the following steps to set Miscellaneous options, as needed:
- Select the Miscellaneous category of the Environment options.
- For the two options under COPYPATH:
- Enable When adding a COPY file to automatically modify the definition of COPYPATH to include the path to the new COPY file.
COPYPATH is defined on the Environment tab of the Project Settings window.
- Enable When modifying COPY path in Add/Remove files dialog to modify the definition of COPYPATH when it is changed via the Add/Remove Files dialog.
- Under the Automatically create a program structure file option, enable When adding a source file to the project’s source folder to direct AcuBench to create a program structure
file for any source file that is added to a project. As a part of this process, the source file is modified to include a set
of AcuBench tags (see Automatic Code Generation). Note that only programs that have a program structure file are able to use the Screen Designer and other tools that generate code.
Keep in mind that in the Add Program dialog, you can specify, on an individual basis, whether a program structure file should be created for any given program
being added. For an introduction to AcuBench programs, see Programs. More detail is available in Working with Programs. For a discussion of adding source files to a project, see Adding an Existing Source File.