filename

Sets the name of a generated workspace, project, or rules file. Use it in conjunction with location to completely control the generated file destination.

filename ("name")

By default, generated workspace, project, and rule files use their name the as the name of the generated file. The filename function allows you to change this.

Parameters

name is the desired file name for the generated workspace or project file.

Applies To

Workspaces, projects, and rule files.

Examples

Change the workspace name to "Master".

workspace "MyWorkspace"
  filename "Master"

If you plan to build with multiple tools from the same source tree you might want to split up the project files by toolset. The _ACTION global variable contains the current toolset identifier, as specified on the command line.

workspace "MyWorkspace"
   filename "MyWorkspace_%{_ACTION or ''}"

See Also

• location