		 Documentation for PC Install Program
	  Copyright (c) 1994,95 Gremlin Interactive Limited

			     Version 1.16
			     6 March 1995

This archive should contain the following files

	INSTALL.EXE		The Install Program
	INSTALL.INI		Sample Install Script
	MANUAL.TXT		The manual (this file)
	READ.ME			Sample Read Me File
	HISTORY.TXT		Development History
	HMIDET.DRV		Sound Card Detection Drivers
	HMIDRV.DRV		Digital Sound Drivers
	HMIMDRV.DRV		MIDI Sound Drivers
	LOADPATS.EXE		Gravis Ultrasound Patch Loader
	INSTGRAV.INI		Gravis Ultrasound Patch Load Script

Contents
---------

	[1]		Introduction

	[2]		Command Line Switches

	[3]		Install Script
	  [3-1]		  Special Definitions
	    [3-1-1]	    Foreign Languages
	    [3-1-2]	    Title
	    [3-1-3]	    Operating System Version
	    [3-1-4]	    CPU Type
	    [3-1-5]	    Base Memory
	    [3-1-6]	    Extended Memory
	    [3-1-7]	    Expanded Memory
	    [3-1-8]	    Config File
	    [3-1-9]	    Read Me File
	    [3-1-10]	    Default Path
	  [3-2]		  Message Structures
	  [3-3]		  Special Message Structures
	    [3-3-1]	    Title
	    [3-3-2]	    Install Introduction
	    [3-3-3]	    Setup Introduction
	  [3-4]		  Menu Structures
	  [3-5]		  Special Menu Structures
	    [3-5-1]
	    [3-5-2]
	    [3-5-3]
	  [3-6]		  Installation Stuctures
	  [3-7]		  Miscellaneous Special Structures
	    [3-7-1]
	    [3-7-2]
	    [3-7-3]

	[4]		Technical Support


[1]	Introdution
--------------------

The PC Install Program is a utility to Install a product to a hard
disk and setup the configuration for their hardware.

[2]	Command Line Switches
------------------------------

	/c	Suppress CD Test, ignores the CD Speed Test.

	/f	Suppress file seach, ignores sound drivers etc.

	/h /?	Brief Help Page describing this section

	/i	Presents some diagnostic information about a users
		machine, this is useful for helpline calls.
		A typical output is shown below:

eg.		Diagnostic Information.

		Drive C: has  153559040 free bytes.
		Drive D: has     985088 free bytes.

		(2 drives found.)

		Operating System Version = 6.20
		CPU Type = 486.
		FPU Type = YES.

		Free Conventional Memory (BASE) = 598032 bytes.
		Free Extended Memory (XMS) = 3010 Kbytes.
		Free Expanded Memory (EMS) = 2992 Kbytes.

	/v	Validates INSTALL.INI, checks that the script file is
		okay to use. All error messages should be self
		explanatory.

[3]	Install Script
-----------------------

The Install Script must be called INSTALL.INI and be in the same
directory as INSTALL.EXE.


[3-1]		Special definitions

The definitions below must be included in INSTALL.INI for the program
to function correctly

[3-1-1]		Foreign Languages

Each foreign language that is supported must be defined and the
default language specified.

eg.	Language=English
	Language=Francais
	Language=Deutsch
	DefaultLanguage=English

[3-1-2]		Title

A Title must be given, usually the name of the game to be installed,
this points to a message that will be displayed in a windows at the
top of the screen when the program is running.

eg.	Title=GameName

[3-1-3]		Operating System Version

The minimum Operating system version must be given, so that the
program will quit before the installation can take place.

eg.	OSVersion=5.00

[3-1-4]		CPU Type

The minimum CPU type must be given, so that the
program will quit before the installation can take place.

eg.	CPUType=386

Valid values are 86,186,286,386,486,Pentium

[3-1-5]		Base Memory

The minimum amount of conventional memory in BYTES must be specified,
the program will warn the user after the installation has finished.

eg.	BaseMemory=123456

[3-1-6]		Extended Memory

The minimum amount of extended memory in KILOBYTES must be specified,
the program will warn the user after the installation has finished.

eg.	ExtendedMemory=1234

[3-1-7]		Expanded Memory

The minimum amount of expanded memory in KILOBYTES must be specified,
the program will warn the user after the installation has finished.

eg.	ExpandedMemory=1234

[3-1-8]		Config File

The Configuration file that is written out must be given a name.

eg.	ConfigurationFileName=CONFIG.INI

[3-1-9]		Read Me File

The Read Me file must be given a name.

eg.	ReadMeFileName=READ.ME

[3-1-10]	Default Path

A Default installation path must be given

eg.	DefaultPath=\RET

[3-2]		Message Structures

Any output to the user has to be defined in a message structure as
shown below.

eg.		Message=GameName
		{
		English="Installation and Setup"
		Francais="Installation and Setup"
		Deutsch="Installation and Setup"
		}

GameName is a unique name for the structure, this name will be used
elsewhere in the script file. Between the braces there must be
definition of the message for each language supported. The message
must be in quotes and any message that needs to continue to the next
line can do so.

eg.		English=
		"This message is too long to fit on one line
		so it is being continued on the next."

[3-3]		Special Message Structures

The following Message structures must be defined, to help with the
continuity of the program.

[3-3-1]		Title

The title message is pointed to by the definition Title=GameName,
this is the message that is displayed in the top window at all times.

eg.		Message=GameName
		{
		English="PEPSI Installation"
		}

[3-3-2]		Install Introduction

This is a small introductory message to welcome the user to both the
installation and setup part of the program.

eg.		Message=InstallIntroduction
		{
		English="Welcome to Install and Setup"
		}

[3-3-3]		Setup Introduction

This is a small introductory message to welcome the user to setup
part of the program only.

eg.		Message=SetupIntroduction
		{
		English="Welcome to Setup"
		}

[3-3-4]		Operating system version

The error message for when the user does not have a high enough
operating system version.

eg.		Message=OSVersion
		{
		English="OS too low"
		}

[3-3-5]		CPU Type

The error message for when the user does not have a good enough
CPU.

eg.		Message=CPUType
		{
		English="CPU too low"
		}

[3-3-6]		Base Memory

The warning message for when the user does not have enough
conventional memory.

eg.		Message=BaseMemory
		{
		English="No enough Base RAM"
		}

[3-3-7]		Extended Memory

The warning message for when the user does not have enough extended
memory.

eg.		Message=ExtendedMemory
		{
		English="No enough Extended RAM"
		}

[3-3-8]		Expanded Memory

The warning message for when the user does not have enough expanded
memory.

eg.		Message=ExpandedMemory
		{
		English="Not enough Expanded RAM"
		}

[3-3-9]		Invalid Path

The warning message for when the user enters an invalid path or a
directory of that name already exist.

eg.		Message=InvalidPath
		{
		English="Invalid Path"
		}

[3-3-10]	Disk Space

The warning message for when the user selects a drive that does not
have enough disk space.

eg.		Message=DiskSpace
		{
		English="Not enough disk space"
		}

[3-3-11]	Press a key

This message is used for continuity in the program.

eg.		Message=PressAKey
		{
		English="Press a key to continue"
		}

[3-3-12]	Save Changes
[3-3-13]	Enter Drive
[3-3-14]	Enter Drive Help
[3-3-15]	Enter Path
[3-3-16]	Enter Path Help
[3-3-17]	UnInstall Finished
[3-3-18]	UnInstalling
[3-3-19]	Boot Disk Start
[3-3-20]	Creating Boot Disk
[3-3-21]	Boot Disk Success
[3-3-22]	Boot Disk Failure
[3-3-23]	Card Failed
[3-3-24]	Invalid Port
[3-3-26]	Invalid IRQ
[3-3-27]	Invalid DMA








[3-6]		Installation Structures

The commands for the installation procedure are in an installation
structure.

The structure is basically a BATCH file with a couple of extra
commands:

A Message can displayed with

		@<Message>

Message is the name of a message structure

A Disk swap can be initiated with

		#<Filename.Ext>,<Message>

Filename.Ext is a file on the disk that is used to determine if the
correct disk is inserted, Message is the name of a message structure
(usually a message to the user to swap disks). The message will be
removed when the correct file has been found.

eg.		Installation=Standard
		{
		@Message
		copy %SourcePath%\install.exe
		#archive.zip,Disk2
		}

Standard is a unique name for the installation, so several
installations can be chosen from a menu.
%SourcePath% is an internal variable which contains the drive and
path of the Source Drive (eg A:).


[4]	Technical Support
--------------------------

If you have any problems with the PC Installer or have any bugs to
report, contact:

	Kevin Dudley
	Gremlin Interactive Limited
	Carver House
	2-4 Carver Street
	SHEFFIELD
	S1 4FS

	Tel 	+44 (0114) 275 3423
	Fax 	+44 (0114) 276 8581
	BBS	+44 (0114) 276 7887
	email	gremlins@cix.compulink.co.uk
