# <license>

[This is preliminary documentation and subject to change.]

Generates a `.licence` file from a `.licx` file.

If no output file is specified, the default filename is the name of the target file with the extension `.licenses` appended.

### Parameters

Attribute | Type | Description | Required
--- | --- | --- | ---
input | file | Input file to process. | True
licensetarget | string | Deprecated. Specifies the executable for which the .licenses file is generated. | False
output | file | Name of the license file to output. | False
target | string | Specifies the executable for which the .licenses file is generated. | False
failonerror | bool | Determines if task failure stops the build, or is just reported. The default is true. | False
if | bool | If true then the task will be executed; otherwise, skipped. The default is true. | False
timeout | int | The maximum amount of time the application is allowed to execute, expressed in milliseconds. Defaults to no time-out. | False
unless | bool | Opposite of `if`. If false then the task will be executed; otherwise, skipped. The default is false. | False
verbose | bool | Determines whether the task should report detailed build log messages. The default is false. | False

### Framework-configurable parameters

Attribute | Type | Description | Required
--- | --- | --- | ---
exename | string | The name of the executable that should be used to launch the external program. | False
hascommandlinecompiler | bool | Indicates whether the current target framework has a command line tool for compiling licenses files. The default is true. | False
managed | ManagedExecution | Specifies whether the external program should be treated as a managed application, possibly forcing it to be executed under the currently targeted version of the CLR. | False
supportsassemblyreferences | bool | Indicates whether assembly references are supported by the current target framework. The default is false. | False
useruntimeengine | bool | Deprecated. Specifies whether the external program is a managed application which should be executed using a runtime engine, if configured. The default is false. | False

### Nested Elements:

#### <assemblies>

Names of the references to scan for the licensed component.

#### </assemblies>

### Examples

- Generate the file `component.exe.licenses` file from `component.licx`.

                  <license input="component.licx" licensetarget="component.exe" />

### Requirements

Assembly: NAnt.DotNetTasks (0.91.3881.0)