:versioninfo

Keyword

Default value: nil

Windows only. The keyword :default or a plist containing containing version information to be placed in the delivered file.

If :versioninfo is nil, no version information is supplied. If :versioninfo is :default, then the version information in the :exe-file is retained (by default, there is no version info). 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.

: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.

:character-set

Specifies the character set to use. Acceptable values are either the numeric ID of a character set, or one of keywords listed below

:additional-pairs

Allows adding arbitrary string-name/value pairs to the main StringTable (Block in the resource definition) in the StringFileInfo structure (StringFileInfo in the resource definition).

The argument is a plist whose elements are all strings. Each two strings constitute a string-name/value pair, which are added to the main StringTable.

The string-name in a pair can be also one of the recognized keywords.

Example:

:additional-pairs '("MIMEType"

"application/basic-plugin")

:string-file-info

Adds a StringTable (block in the resource definition) to the StringFileInfo structure.

The argument has to be a plist. Each two items in the list constitute a pair of string-name/value, which are added to the block. The special keywords :language and :character-set are exceptions: they specify the "lang-charset" value of the block. They have the same syntax as these keywords when they appear in the top list.

To be useful, the plist must include either:character-set or :language, because applications that read the version info will normally expect one block for the lang-charset combination.

LispWorks Delivery User Guide - 15 Feb 2015