This is the README file for Install by Champion Software. ============================================================================================= DESCRIPTION Install is a windows application that will copy a file or number of files from a source location to a destination. It will also create Program Manager groups and icons if instructed to do so. Install is a fairly small application and is by no means as fully featured as some other installation software that is available. I feel, however, that it may be useful to some software developers so have decided to release it as shareware. Please see the note at the end of this file regarding registration and payment. Originally I used the features of the Borland library BWCC.DLL and the appearance of this product was greatly improved. Unfortunately this meant that BWCC.DLL would have to be distributed with this application. This had several disadvantages including a more complex installation procedure (copying BWCC.DLL first, version checking etc.), larger distribution ZIP files, longer download times, and less usable floppy disk space. ============================================================================================= FOR THE DEVELOPER Copy the files that you are distributing on to a floppy disk or disks. You may compress your files using the Microsoft utility Compress if you want to. You may also use the -r switch of Compress to automatically rename your files. Install will decompress and rename files as required. You can mix compressed and non compressed files on the same disk if you want to. Copy on to the first disk the file INSTALL.EXE, this must not be compressed or renamed. You must also create an information file called INSTALL.INF which must be on the first disk and cannot be compressed or renamed. Details of INSTALL.INF are discussed later in this file. If your files are on multiple disks then each disk other than the first must contain an uncompressed text file called DISKID. DISKID will contain a simple text string of up to 30 characters which describes the disk. The first character of this description must be an upper or lower case D so descriptions such as Disk 2 etc. are ideal. ============================================================================================= CREATING INSTALL.INF The file INSTALL.INF is a simple ASCII text file that must be created manually with a text editor. You may insert any lines that you like into this file, including blanks, but if the first character of a line is 1 2 3 4 D F or G then the line is an instruction to Install and must be entered exactly as instructed below. You may find the INSTALL.INF file that came with this product useful reference. --------------------------------------------------------------------------------------------- 1 2 3 4 : If a line begins with one of these characters then there must also be a parameter preceded by a comma in the line. All the text after the comma will be treated as a message and will be displayed in the appropriate position in the top section of the Install dialog box. If no text follows the comma then the relevant line will be blanked. These lines can be set and altered as many times as you like throughout the information file. If no comma exists then the message lines will remain unchanged (they are blank initially). Maximum message size = 50 characters. For example the line 2,Copyright Ace Software Ltd would cause the message Copyright Ace Software Ltd to be displayed on the second line in the top section of the Install dialog box. --------------------------------------------------------------------------------------------- D If a line begins with an upper or lower case D then the entire contents of the line will be used as a disk identifier and a dialog box will request a disk change. This text is case sensitive and must match the contents of the relevant DISKID file. Identifiers such as Disk 2 etc. are ideal. If the source location is on a drive other than A or B then these lines are ignored. Maximum disk id size = 30 characters. For example the line Disk 2 would cause Install to prompt for the disk containing the text Disk 2 in it's DISKID file. Installation could not progress until a disk with the string Disk 2 in it's DISKID file was inserted into the source drive. --------------------------------------------------------------------------------------------- F If a line begins with an upper or lower case F then there must follow one or two further parameters preceded by commas. The first parameter is the full path and filename of the destination file. The file named must exist in the source path in order to be installed. If the second parameter exists and is not blank then a Program Manager icon will be created for the file using this second parameter as a description. If the second parameter does not exist or is blank then the file will be copied but no icon will be created. It is important to define a group prior to inserting any F lines. See the G section on how to do this. If the file is called README.* then after installation NotePad will be launched with the file README.* loaded. It is your responsibility to ensure that README.* is in a suitable format for NotePad. I usually create my file with NotePad and call it README.TXT. If there are several README.* files installed then only the last one will be loaded into NotePad. Maximum destination path + filename length = 79 characters. Maximum Program Manager description = 40 characters. For example if A: was the source drive then the line File,C:\WORK\PROGRAM.EXE,A Program would cause the file PROGRAM.EXE to be copied from the source location to the directory C:\WORK and a Program Manager icon with the description A Program to be created for it. The destination directory C:\WORK would be created if it didn't already exist. The icon would be inserted in the last group named in the INSTALL.INF file or the currently active Program Manager group otherwise. --------------------------------------------------------------------------------------------- G If a line begins with an upper or lower case G then there must follow one parameter. This parameter is the name of a Program Manager group. This is the group where and icons that follow will be inserted. If the group does not exist then it will be created. You can add as many group lines to INSTALL.INF as you like. Remember however that icons will always be inserted into the last group specified. Maximum group name size = 30 characters. For example the line Group,A Database would cause the group named A Database to be created if it did not already exist, any file lines that followed containing icon descriptions would have their icon created in the group A Database. --------------------------------------------------------------------------------------------- Any other lines will be ignored completely and may be used as comments etc. ============================================================================================= FOR THE USER The user will put the first installation disk into any floppy drive and select Run then [drive]:INSTALL from any Windows application with a Run command (e.g. Program Manager or File Manager). The user will be promted for subsequent disks if and when they are required. The user may also copy the entire contents of the disk or disks to a directory of his or her choice and execute Install from there. In this case multiple disks will not be prompted for. ============================================================================================= REGISTRATION If you like and use this product and if you can afford it then please send £25.00 to Mike McLoughlin Champion Software 58 Abbotsham Road Bideford Devon EX39 3AP UK I would also appreciate it very much if you could distribute this product, including this file, to your friends and other bulletin boards. If you genuinely can't afford the registration fee then please accept this software with my compliments, otherwise please register it - many thanks.