File set editor can be used to edit the details of a single file set. These file sets can be used to group files together to be referenced by other sections of a component.
Name is a mandatory identifier for the file set.
Display name is an optional and used for a more user-friendly identifier.
Description is an optional field for textual description of the file set.
Group identifier can be used to describe the function or purpose of the file set with a single unbounded word. Group identifiers can contain several identifiers and the number of possible identifiers is not limited. However, the editor suggests the following options:
Files editor lists the files contained within the file set.
Each file has a file name identifying the file. The name is mandatory and it is determined automatically from the file path.
File path is mandatory and defined as relative to the component XML-file, as an absolute path or as an external URI. If an URI is used, the schema must be explicitly defined (e.g. http://...).
File type is mandatory and helps categorize the file and links files to their build command (see below). A file can have more than one type.
Description is a freely formatted text describing a single file.
New files can be added by creating new rows, browsing the files using the context menu option described below or by drag-dropping the files onto the editor. If the order of files is important for e.g. compilation then the files should be listed in the required order. The order of the files can be changed by dragging the rows.
The files box also contains a context menu (right mouse button) that has the following options:
Dependent directories can specify a freetext list of paths to directories on which this file set depends, e.g. directories of include files.
Default build command defines how to build the files within the file set by e.g. running gcc for C files or vcom for VHDL.
File type defines which files are build by the given command.
Flags define the command line options for the command e.g. -Wall.
The defined command can either replace default flags defined in the target file or be appended to it. The value can be given as an expression, but must evaluate to 1 or 0.