Add a Group Directive
The Configuration section of the IDE workbook provides views and actions to add a group
directive to your configuration file. The group directive does not specify source files
for a project, so the group still needs to be listed in a source directive. The group
directive makes dealing with source files that are processed in the same manner easier
than dealing with the files individually. You can add descriptive names to a group,
improving the readability of your configuration file.
To add a group directive:
- From a Configuration view, select the directive after which or into which you want to
add the new group directive. Click mouse button 2 on the directive to display a menu. To
add the group directive to the top of the configuration file, click mouse button 2 on the
background of a view to display a menu. Views that provide these pop-up menus include
Source and Groups, Targets, Source and Targets, and Options Groups.
- Select the action that adds the group directive to where you want it in the
configuration file:
- Select Add Group after.... to add a group directive after the directive
or select Add Group into.... to add a group directive within a directive
that has a directive block.
- Select Add Group... to add a group directive to the top of the
configuration file. If the ProjectOptions directive exists, the Add group action will add
the appropriate directive inside the ProjectOptions block, as the first item in that
block.
A dialog box is displayed.
- In the Group field, type the name of the group.
- Type the name of a source file in the Source field, or click Find
to select one or more source files from your file system. If the file name is not enclosed
in quotes or does not have a file extension, then it is assumed to be a variable which
must be already defined in the configuration file.
- Ensure Use Relative Path is selected to add the source
files with a path name relative to the configuration file directory. When this option is
not selected, the source files are added with full path names.
- Click Add to add the files to the Files list.
- To change or remove a file from the Files list, select the file and
click Change or Remove. If you want to undo the
selections you have made, click Reset. Click Cancel to
exit the dialog box without adding the group directive.
- Click Apply. The new group directive is added to the configuration
file. The views in the Configuration section are refreshed to show the new directive. To
update the views in other sections, you must build the project. For a source files that
are part of this group directive to be part of a build, the group directive must be
specified in a source directive.

Configuration Files

Add or Change Source Files Overview

group Configuration File Directive