home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
DP Tool Club 17
/
CD_ASCQ_17_101194.iso
/
vrac
/
ho51.zip
/
HO51.ZIP
/
install.doc
< prev
next >
Wrap
Text File
|
1994-06-17
|
14KB
|
344 lines
The Quick & Easy Install manual Page 1
_______
____|__ | (R)
--| | |-------------------
| ____|__ | Association of
| | |_| Shareware
|__| o | Professionals
-----| | |---------------------
|___|___| Member
June, 1994
Install is designed to allow you to install and run your
software including demonstration programs, and maintenance
software. You may also use it as a general install program,
to setup software that you only use occasionally and the
like. Install stores its help information and script
instructions in the INSTALL.DBF and INSTALL.DBT Xbase database
files. You can edit the help by tapping F7 instead of F1
-Help while running install or you can start install with the
"EDIT" command line parameter. Install always looks in the
last active, or undeleted, entry for its script instructions.
You can take advantage of this by putting alternate
installation sets in other dbase deleted entries and
undeleting them for particular disk distributions. Don't
leave the last entry blank, or install will yell at you. This
installer was originally setup for the TeleShare remote access
package, but this release matches the Hands On remote access
package. Some of the Teleshare features are not used with
Hands On, but they are retained and may become useful for
particular installations.
Command line parameters
INSTALL [EDIT ADD MONO RECNO#]
EDIT - to edit the script database
ADD - to add a new entry and edit the script database.
MONO - to force monochrom screen output.
RECNO8 - to activate entry number 8, and inactivate others.
The current default layout is as follows:
The Quick & Easy Install manual Page 2
Entry 7 is for a BASIC or ONE DISK distribution.
Entry 8 is the general distribution with the Add-in, Basic,
and 'full' Teleshare choices.
Entry 9 is for a DIRECT one disk distribution, for TSDIRECT
the Teleshare direct serial link transfer option.
The install script language follows:
# is used for comments. Anything to the right of a # is
considered a comment.
Every install script must start with the line.
"TELESHARE INSTALL SCRIPT"
Otherwise the installer might try to work over one of its own
help files, and snivel at you.
BROWSE somefile to browse or review some text file for
information. It has a built-in search capability.
CHANGEDISK key_file To prompt to change to the next diskette,
and to check for the specified key file on the next disk. You
can leave a space and add a message that will be displayed in
place of "Please change disks" after the key_file name. Do
use a zero length key_file name.
CHANGEDISK peaches.exe Please change to the red disk.
CLEAR to clear the screen. This version actually calls the
DOS CLS to ensure that the screen color/colour matches similar
DOS related commands that you may be using in association with
it.
COMMAND to directly run programs and to pass commands to
command.com. See the RUN and SWAP commands below.
COPY - to allow copying of materials from the source to target
disk as in:
COPY file_1 file_2 file_3 etc
The destination is the DIRECTORY provided earlier.
DIRECTORY - to supply a directory name for editing.
ECHO like the DOS echo command. Anything that is not
The Quick & Easy Install manual Page 3
recognised by the script parser is simply echoed to the
screen, but any spaces on the left side will be trimmed off.
IF and END or ENDIF If is used with ADD-IN or BASIC, as in
IF BASIC
# installation commands for the BASIC option
...
ENDIF
IF ADD-IN
# installation commands for the ADD-IN option
...
END
if add-in basic
# to combine the partial installation options
...
endif
The final "END" or "ENDIF" is an implied "QUIT", so if you use
one of the two optional partial installation options, ensure
that the 'right stuff' is done before the "END".
There is no "IF ALL" to install everything. If the option to
install everything is chosen, any "IF BASIC" or "IF ADD-IN"
instruction sets are ignored.
INSTALL DIRECTORY \HANDS_ON\ # to specify the \HANDS_ON\
directory.
INSTALL HEADER - This allows you to provide an alternate
header to replace the default message at the upper part of the
screen. You may use up to 3 message or header lines.
INSTALL README some_file to allow you to use any file name
instead of the default README.DOC name. README.DOC is used in
place of README.1ST to make it easier to look up a group of
manuals, ending in ".DOC", with various browsers.
INSTALL ADD-IN or BASIC - to specify that the distribution is
only a partial distribution. The installer defaults to asking
if you want 1) A FULL distribution or 2) Only the REMOTE or
the HOST (BASIC) or 3) As an ADD-IN to another product like
bitcom. Use one of these command options to bypass the
prompting.
QUIT - to instruct INSTALL to quit to DOS.
QUIT_TO to quit and run another program. This version of
Install does NOT use keyboard stuffing to run the next
program, unlike previous releases. When you use "QUIT_TO
The Quick & Easy Install manual Page 4
some_prog" the program swaps all but 2k of itself to disk and
runs the "some_prog". It then swaps itself back in after
running and immediately quits.
LASTFILE to specify the last file in a disk set. This allows
the installer to look for the last file and automatically
decide that the installation is a 'one disk' set. This allows
you to use the same installation instruction script for 360K
diskettes, 1.44M diskettes, and BBS type installation. It
causes CHANGEDISK type instructions to be ignored. eg.:
"LASTFILE lastdisk.zip"
RUN - to tell INSTALL to run the program on the same line.
For both RUN and SWAP, install looks for the file to be run in
both the source and the destination directories, and runs it
where it was found with the current directory being the
destination directory. This means that it works with self-
extracting archive files and software that has been
installed. Use the COMMAND command to simply run programs and
to pass commands to command.com. Use swap if you need all but
2K of memory. The parser ignores ".COM" files, so add the
.com if you want to RUN or SWAP .com files.
SWAP - to tell INSTALL to SWAP all but 2k of itself to disk
before running the program given on the same line.
Examples:
CLEAR
RUN some
SWAP bigthing # swap all but 2k of the program to disk
WAIT to wait for the user to press a key to continue. The
wait is actually a long delay.
The best way to learn how to use INSTALL is to study an
existing script in the INSTALL.DBF/DBT file. Run 'INSTALL
EDIT', and compare its actions to the command script. Practise
with small scripts and work up. Test your setups.
If you use the install program very much to install other
software, you will notice that the size of the install.dbt
file builds up. Use the ITUNE.EXE program to retune the
size. It will automatically reclaim wasted space.
ASP Introduction:
Please also carefully read the accompanying SHARE.ASP or
SHR_WARE.DOC document.
The Quick & Easy Install manual Page 5
"This program is produced by a member of the Association of
Shareware Professionals (ASP). ASP wants to make sure that the
shareware principle works for you. If you are unable to
resolve a shareware-related problem with an ASP member by
contacting the member directly, ASP may be able to help. The
ASP Ombudsman can help you resolve a dispute or problem with
an ASP member, but does not provide technical support for
members' products. Please write to the ASP Ombudsman at 545
Grover Road, Muskegon, MI 49442 or send a CompuServe message
via CompuServe Mail to ASP Ombudsman 70007,3536."
DISTRIBUTION: This product is the property of P. C Softsmith
(c) 1991-4. It may be distributed freely, but it is
shareware. If you use it to produce setup/installs for
yourself or others, please send a letter with comments and
suggestions to P. C. Softsmith. You do not have to register
TeleShare or Hands On to include it with your product.
However, you must include this documentation with any and all
distributions of INSTALL, and you may not charge more than an
'industry standard' distribution fee for shareware
distributors. See the "History" section below for more
distribution information.
Support:
Please contact us for TeleShare/Hands ON support and sales at
P. C. Softsmith by telephone (604) 433 - 5189 or at Suite 606
- 6455 Willingdon Avenue, Burnaby, British Columbia, Canada,
V5H 4E4. Both registered and soon to be registered users
currently get the same support without any arbitrary time
limit.
Internet and Compuserve users can also direct email to:
vic_williams@mindlink.bc.ca
Your comments on the product will be appreciated. Naturally
we all might expect ongoing changes in the product.
History:
June, 1994 Version 2.5 -- added the LASTFILE command.
This install is a version of the installation program used to
install the FORCE Xbase compiler (the ONLY native code
producing Xbase compiler), with portions Copyright (C) 1989
Sophco Inc. The terms of the distribution agreement are such
The Quick & Easy Install manual Page 6
that this install program may only be distributed with P. C.
Softsmith products. If you want to distribute it solely with
your product, please contact us and we will direct you to the
appropriate contact people.
In mid July 1993, the script language was added to the install
program and the version was upgraded from 1 to 2.
DISCLAIMER - AGREEMENT
The documentation and associated software are distributed and
sold with no warranties, either express or implied, regarding
its merchantability or fitness for any particular purpose. To
repeat, the author disclaims all warranties, expressed or
implied, including, without limitation, the warranties of
merchantability and of fitness for any purpose. The author
assumes no liability for damages, direct or conse- quential,
which may result from the use of the product with or without
registration.
The information in this documentation is subject to change
without notice and does not represent a committment on the
part of the vendor.
THE DOCUMENTATION AND ASSOCIATED SOFTWARE ARE DISTRIBUTED AND
SOLD WITH NO WARRANTIES, EITHER EXPRESS OR IMPLIED, REGARDING
ITS MERCHANTABILITY OR FITNESS FOR ANY PARTICULAR PURPOSE.
THE INFORMATION IN THIS DOCUMENTATION IS SUBJECT TO CHANGE
WITHOUT NOTICE AND DOES NOT REPRESENT A COMMITTMENT ON THE
PART OF THE VENDOR.
OTHER PRODUCT AND BRAND NAMES MENTIONED ARE TRADEMARKS OR
REGISTERED TRADEMARKS OF THEIR RESPECTIVE HOLDERS.
SPECIFICALLY XBASE IS THE GENERIC DATABASE INDUSTRY
REPLACEMENT FOR THE REGISTERED TERM 'DBASE' OWNED BY BORLAND
INTERNATIONAL.