:versioninfo

Keyword

Default value: nil

Windows only. A plist containing version information to be placed in the delivered file.

If :versioninfo is nil , no version information is supplied. Otherwise :versioninfo should be a plist of the following keywords. All strings should be in a form suitable for presentation to the user. Some of the keywords discussed below are mandatory, and some are optional.

Mandatory keywords:

:binary-version :binary-file-version :binary-product-version

You must specify either :binary-version or both :binary-file-version and :binary-product-version .

The file version relates to this file only; the product version relates to the product of which this file forms a part.

If :binary-version is specified, it is used as both the file and product version.

The binary version numbers are 64-bit integers; conventionally, this quantity is split into 16-bit subfields, denoting, for example, major version, minor version and build number. For example, version 1.10 build 15 might be denoted #x0001000A0000000F .

Note: There is no requirement to follow this convention; the only requirement is that later versions have larger binary version values.

:version-string :file-version-string :product-version-string

You must specify either :version-string or both :file-version-string and :product-version-string .

The file version relates to this file only; the product version relates to the product of which this file forms a part.

If :version-string is specified, it is used as both the file and product version.

The version strings specify the file and product versions as strings, suitable for presentation to the user. There are no restrictions on the format.

:company-name

The name of the company producing the product.

:product-name

The name of the product of which this file forms a part.

:file-description

A (brief) description of this file.

Optional keywords:

:private-build

Indicates that this is a private build. The value should be a string identifying the private build (for example, who the build was produced for).

:special-build

Indicates that this is a special build, and the file is a variation of the normal build with the same version number. The value should be a string identifying how this build differs from the standard build.

:debugp

A non-nil value indicates that this is a debugging version.

:patchedp

A non-nil value indicates that this file has been patched; that is, it is not identical to the original version with the same version number. It should normally be nil for original files.

:prereleasep

A non-nil value indicates that this is a prerelease version.

:file-os

Indicates the OS for which this file is intended. The default value is :windows32 . (:nt :windows32) may be specified instead, to indicate that this application is intended for Windows NT.

:comments

A string value, which allows additional comments to be specified, in a form suitable to presentation to the user.

:original-filename

This specifies the filename (excluding drive and directory) of this file. Normally it is defaulted based on the filename argument to deliver .

:internal-name

This the internal name of this file. Normally it is defaulted to the value of original-filename , with the extension stripped.

:legal-copyright

A string containing copyright messages.

:legal-trademarks

A string containing trademark information.

:language

The language for which this version of the file is intended.

This can be either a numeric Windows language identifier, or one of the keywords listed below. The default is :us-english .