Rules and Macros

The rules and macros described below are used to update source files from output files.

On this page:

• updatesrc_update
• updatesrc_update_all

updatesrc_update

updatesrc_update(name, deps, outs, srcs)

Updates the source files in the workspace directory using the specified output files.

There are two ways to specify the update mapping for this rule.

Option #1: You can specify a list of source files and output files using the srcs and outs attributes, respectively. The source file at index 'n' in the srcs list will be updated by the output file at index 'n' in the outs list.

Option #2: Rules that provide UpdateSrcsInfo can be specified in the deps attribute.

ATTRIBUTES

Name	Description	Type	Mandatory	Default
name	A unique name for this target.	Name	required
deps	Build targets that output UpdateSrcsInfo.	List of labels	optional	[]
outs	Output files that will be used to update the files listed in the srcs attribute. Every file listed in the outs attribute must have a corresponding source file list in the srcs attribute.	List of labels	optional	[]
srcs	Source files that will be updated by the files listed in the outs attribute. Every file listed in the srcs attribute must have a corresponding output file listed in the outs attribute.	List of labels	optional	[]

updatesrc_update_all

updatesrc_update_all(name, targets_to_run)

Defines a runnable target that will query for updatesrc_update targets and run them.

The utility queries for all of the updatesrc_update rules in the workspace and executes each one. Hence, source files that are mapped in these targets will be updated.

Additional targets to execute can be specified using the targets_to_run attribute.

PARAMETERS

Name	Description	Default Value
name	The name of the target.	none
targets_to_run	A list of labels to execute in addition to the updatesrc_update targets.	[]

RETURNS

None.