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:

  1. 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.
  2. Select the action that adds the group directive to where you want it in the configuration file:

    A dialog box is displayed.

  3. In the Group field, type the name of the group.
  4. 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.
  5. 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.
  6. Click Add to add the files to the Files list.
  7. 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.
  8. 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