====================================================================
     Linder econitech Product Support Services Application Note
     SETAP095: SHORT MANUAL
====================================================================
                                             Revision Date: 96/01/03
                                            pre-release Version 0.95
                                                    No Disk Included

The following information applies to Linder SETapp version 0.95 for
Windows(TM).

--------------------------------------------------------------------
INFORMATION PROVIDED IN THIS DOCUMENT AND ANY SOFTWARE THAT MAY
ACCOMPANY THIS DOCUMENT (collectively referred to as an Application
Note) IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER
EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE IMPLIED
WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A PARTICULAR
PURPOSE. The user assumes the entire risk as to the accuracy and the
use of this Application Note. This Application Note may be copied
and distributed subject to the following conditions: 1) All text
must be copied without modification and all pages must be included;
2) If software is included, all files on the disk(s) must be copied
without modification; 3) All components of this Application Note
must be distributed together; and 4) This Application Note may not
be distributed for profit.

Copyright (c) 1995-1996 Linder econitech. All Rights Reserved.
--------------------------------------------------------------------


Basics
======

Thank you for trying Linder SETapp. This is a small and easy to use
application installation program for Windows 3.1x and it is 
Shareware. If you are a registered user of SETapp you can distribute
it royalty-free to your customers.
If you are distributing Freeware the use is free of charge.

In this pre-release (0.95) we have already implemented the code for
handling multiple disk installation. We have consequently prepared
SETapp for installing large applications or tools. Please note that
there is no disk-volume-checking implemented in this release.

We developed this system to distribute our software because we
couldn't find anything that met our requirements. Those
requirements are:

Small:      We didn't want to add too much extra baggage to our
            distribution or upload packages (our aim was to add not
            more than 300 KB of installation system code).

            If you are user of Clarion for Windows (1.5x) you can
            order a very small (12 KB) SETapp executable that calls
            functions in the CWRUN15.DLL. 

Cheap:      We didn't mind paying a shareware type price but all we
            found were commercial type prices.

Simple:     It should be easy for us to configure and easy for our
            customers to use.

Attractive: It had to look good since it is the first impression
            your customer gets of your product.


Note: The development of SETapp is not yet completed. The full
featured final version 1.00 is still to come in April 1996!
We want to place it first at the WinSite(tm) Windows Archive
(ftp.winsite.com [199.26.178.13] in Bloomongton, IN  USA).


As far as how to use this package... 

A configuration file is read at start up. This file is called
INSTALL.INF and must be present with SETapp. We have documented
each section of this file to enable the user to change the
settings according to his requirements.

Files that are compressed by using Microsoft's COMPRESS utility,
will be automatically decompressed by SETapp. When COMPRESS
processes your uncompressed files it will put an underscore
character into the filename. This filename format is required by
SETapp. It is also indispendable that the files are listed in the
INSTALL.INF file with the underscore character and that they are
compressed with the compress <-r> switch!

The SETapp code seems to be robust and has worked with everything
that quite a few people have thrown at it. We'd be interested in
hearing about your experiences. However, see the disclaimer.


Features included in 0.95
=========================

* Handling of multiple disk installation to install large
  applications or tools (up to 255 installation disks).
* Conditional installation based on windows version number (e.g.
  Windows 3.1, 3.11, 3.95=Windows 95 16-Bit).
* Files can be installed on several conditions
	1. By date  : If file is old it will be replaced.
	2. Always   : Always overwrite file.
	3. Never    : Never overwrite file.
	4. Ask      : Ask if user wants to overwrite file.
* Files can be uncompressed or compressed by using the Microsoft(tm)
  compress utility (not supplied because it would violate
  copyright).
* Icons can be installed in any group or in a default group of the
  program manager.


Limitations
===========
* 255 installation disks max.


Known Problems in version 0.95
==============================
* If an icon has already been installed in a group of the program
  manager it will be added again and again if running SETapp more
  than once.
* Icons and groups couldn't be registered in Windows 95.
* An early abort in the installation process left the already
  installed files on the host system.
* Error checking is sometimes non-existing.


Registering SETapp
==================

If you are distributing Freeware with this system, you will not be
obligated to send us money but we won't refuse any donations if you
feel so inclined. We require that you register with us and send us
a copy of what you are sending out with our program.
No money, just a disk!

If you are using this in a commercial environment or distributing
commercial software or Shareware, you must register by sending
$35 US plus $5 US for shipping and handling. Please make checks
payable to Friedrich Linder and send them to the address shown on
the registration form. Sorry, no credit cards are accepted!
You can distribute SETapp royalty-free to your customers. 


Please print the registration form REGISTER.TXT and fill in the
requested information.


Distribution SETAPP.ZIP
=======================

If you distribute SETapp to friends, associates, or to a computer
bulletin board system (BBS), you may only distribute the compressed
file including the copyright and disclaimer.


Distributing your system with SETapp
====================================

If you distribute your own developed program(s) with our
installation system the file SETAPP.EXE must be added to the first
installation disk. The setup information file INSTALL.INF must also
be included in the first disk.
You can build the INSTALL.INF file using PREPARE.EXE after adding
all your project files to the disk(s).
In this pre-release no development-management-system is implemented.
The project file INSTALL.TPS will also be added to the first
installation disk. This limitation will be removed in the final
version.


Installation
============
Please PKUNZIP the file SETAP095.ZIP to a temporary directory,
e.g. C:\SETTEMP.

* of PREPAREwiz
  =============
  1. Create a new directory (preferably C:\SETAPP).
  2. Copy the file PREPARE.EXE to the new directory.
  3. Add icon to start from desktop.

* of the example CALC
  ===================
  1. Copy the files SETAPP.EXE, INSTALL.INF and CALC.EX_
     to a floppy disk drive.
  2. Start the installation system SETapp from the floppy.


Disclaimer
==========

The Copyright Owner hereby disclaims all warranties relating to this
software, whether express or implied, including without limitation
any implied warranties of merchantability or fitness for a
particular purpose. The Copyright Owner will not be liable for any
special, incidental, consequential, indirect or similar damages due
to loss of data or any other reason, even if The Copyright owner or
an agent of The Copyright Owner has been advised of the possibility
of such damages. In no event shall The Copyright Owner's liability
for any damages ever exceed the price paid for the license to use
the software, regardless of the form of the claim. The person using
the software bears all risk as to the quality and performance of the
software.


The Parts of INSTALL.INF
========================

This file contains information that SETapp uses to install
applications. This file must be in the same directory as the program
file SETAPP.EXE. The two files can be on a floppy disk, a hard disk,
or a network disk drive.


The information in this file determines:

The names of the disks and directories from which, and to which,
SETapp copies files.

The name of the group that SETapp creates in Program Manager's
window (only Windows 3.1x) and the names of program items that
SETapp adds to that group.

You can create your own SETapp program by changing some of the
information in this file.

INSTALL.INF is similar in format to a Windows initialization (.INI)
file.

Sections: INSTALL.INF is divided into sections. Each section is
          identified by a name enclosed in square brackets.

          Most section names are "hard-coded". However, some section
          names are defined within other sections, and are therefore
          easily customizable.

Comments: A comment begins with a semicolon. You can't include a
          comment on the same line as syntax.

Spaces:   Spaces and blanks are ignored.


Sections in This File
=====================

The rest of this file contains the actual sections and statements
that make up the working file and features still to come.


[DIALOG]

caption   = SETapp pre-release 0.95
MainText  = Installation System SETapp
copyright = Copyright (c) 1995-96 Linder econitech

[NEEDED.WINDOW]
MinWinVersion = 3.1

[NEEDED.SPACE]
minspace = 400000         (short-term disabled)

[Options]
OverWrite, NO             (short-term disabled)

[DATA]
SourceDir = C:\SETAPP

[FILES]
FileCount = 3

; +n defines the ordernumber of the file
;    =
;      m# represents the disk number to which the file refers
;        NAME.XXX tells SETapp the file name to install

+1=1#INSTALL.INI,Installation-Script
+2=1#SETAPP.EXE,Main installation system
+3=1#BUILDER.EX_,Installation Wizard v0.95 (compressed)
+4=2#DOCS.EX_,Documents (next disk) and (compressed)

[progman.groups]
MakeGroup      = YES
GroupName      = Linder Shareware
TitleUnderIcon = SETapp Demo
EXEName        = SETAPP.EXE


Still to come...
================

SETapp (Installation System)

* User supplied message in the first dialog box.
* Conditional installation based on disk space availability.
* Subtree creation of directories.
* Disk volume checking for multiple disk installation.
* The condition to install a file if windows version is less than
  the required number.
* The ability to install files into any of the directories created
  into the windows or into windows system directorys.
* The ability to restart windows if any drivers are installed.
* The ability to define macros will be added. The code is already
  implemented but not supported in this pre-release.
  The supported macros in the next version are:
        #W enables defining the user's WINDOWS directory
        #S enables defining the user's SYSTEM directory
  Just place the desired macro in the string where you would
  normally use the pathspec.
* The ability to place any value in any section of any .INI file.
* Functions to support the new features of Windows 95 (e.g. long
  filenames) and a 32-bit version of SETapp are in preparation.
* The ability to create more than one group and more than one icon.
* Error checking is sometimes non-existing. We plan to include
  complete error checking.
* The ability to abort the installation during filecopying.
* Multi-textcolor.
* Multi-language-support (e.g. german and french).
* Uninstall (UNINSTAL.EXE) a system.
* A patch system is in preparation.
* The ability to execute files after copying. This is mainly
  intended for running self-extracting archives.
* The known problems will be solved.

THE FULL FEATURED FINAL VERSION 1.00 IS STILL TO COME IN
APRIL 1996! LOOK HERE AT WINSITE(TM).


PREPwiz (.INF file builder for SETapp)
* (ToDO) - the planed modifications are not yet defined
