In XML, a document may contain only one "root" element after the document header. For WarpIN, this is defined to be the WARPIN element.

So all other elements in the install script (except the XML header) must be enclosed in <WARPIN> and </WARPIN> tags (similar to the <HTML> ... </HTML> tags with "real" HTML files). See the "Installation Scripts" page for an overview where this element should be placed.

The only valid subelements of this element are GROUP, MSG, PAGE, PCK, REXX, TITLE, and VARPROMPT.

Attributes:


VERSION="major.minor[.revision]"
Optional. This specifies the minimum version of WarpIN which must be installed. This is useful if the install script uses elements that require a certain WarpIN version.

"major.minor" must have the major and minor version codes for WarpIN (e.g. "0.9"). Optionally, you can specify the revision level (the third part of the WarpIN version number). If the third part is missing, "0" is assumed.

If the VERSION attribute is missing, the version of the running WarpIN is assumed, i.e. the script will run on any WarpIN version.

Notes:

Since the WarpIN script language changed with V0.9.6, you should always specify VERSION="0.9.6" or higher to give the user a meaningful error message when the script is run on an old WarpIN. The old parser will be able to parse a new-style script as far as this WARPIN tag is concerned.

OS="operating_system"
Optional. This specifies the target operating system on which this archive can be installed. "operating_system" can be one of the following: This is useful to make sure that your product will not be installed on operating systems on which it will not run. If the specified requirements are not met on the user's system, installation is aborted.
CODEPAGE="codepage"
Optional. This specifies the (decimal) codepage that the script is written in. This is useful for languages which need special characters to be displayed, such as Russian or Asian languages.

If this is specified, WarpIN will attempt to switch to the specified codepage if the user's codepage (on whose computer the script is parsed) is different from the script's codepage. If that fails, WarpIN will attempt to translate the script to the user's codepage. If that fails also, WarpIN will show a warning message and probably display garbage.

If this is not specified, WarpIN defaults to CODEPAGE="850", which is the one holding most international characters. You should only specify this if you have a good reason to do so, for example because you are sure that only Korean users will use your archive.

See "Codepage Support" for details.