home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / CLIPPER / MISC / QINST16.ZIP / QUIKINST.DOC < prev    next >
Encoding:
Text File  |  1992-12-23  |  23.4 KB  |  661 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.                           Q U I K - I N S T A L L  v1.6
  24.  
  25.  
  26.              Copyright 1992 Michael L. Wester.  All rights reserved.
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.                                 QUIK-INSTALL v1.6
  70.  
  71.               Copyright 1992 Michael L. Wester  All rights reserved.
  72.  
  73.                                 Michael L. Wester
  74.                                  Route #6 Box 34
  75.                             Fuquay-Varina, N.C. 27526
  76.  
  77.                                   (919)-552-0767
  78.  
  79.  
  80.  
  81.            QUIK-INSTALL is an easy to use, easy to set up installation
  82.       program.  It is designed to install applications from floppy disks to
  83.       hard disk.  Combines the most commonly required features but remains
  84.       very small and very easy to use.
  85.  
  86.  
  87.       FEATURES
  88.  
  89.       *    QUIK-INSTALL requires no set-up or configuration files to be
  90.            used.  Copy it to your disk and you have a "ready made" install
  91.            program.  You have the option of taking advantage of it's many
  92.            features or using it in it's simplest form.
  93.  
  94.       *    Supports multiple disk programs. It can prompt for an unlimited
  95.            number of disks.
  96.  
  97.       *    Automatically creates the sub-directory then copies the files
  98.            for the program it is installing.
  99.  
  100.       *    Optionally tests for available disk space to make sure the user
  101.            has enough space to install.  If space is not available it
  102.            aborts with a warning message informing the user of how much
  103.            space is necessary for installation.
  104.  
  105.       *    Installs programs using a straight file copy or will install
  106.            from executable archives.
  107.  
  108.       *    The entire program is around 8k in size and stores all setup
  109.            information internally.  (It is a self-modifying executable.) 
  110.            It has no configuration files yet can be modified at any time. 
  111.            After it has been configured it's size can be reduced to 6.5k by
  112.            using a compression program such as LZEXE or PKLITE.
  113.  
  114.       *    Has the option to exit in the directory the program has been
  115.            copied to allowing the user to start up immediately.
  116.  
  117.       *    Displays a customized example prompt and a line of text after
  118.            installation completes.
  119.  
  120.       *    QUIK-INSTALL can optionally "stuff" the keyboard buffer with the
  121.            command users should enter to start your application.  Has the
  122.            option to execute the command stuffed in the buffer allowing you
  123.            to start your program automatically or display a banner,
  124.            greeting, warning or anything else.
  125.  
  126.       *    Color attributes can be set to make the installation program
  127.            more like your own application.
  128.  
  129.       *    Registered users receive a copy of the program with their
  130.            program name and/or message embedded in the QUIK-INSTALL program.
  131.  
  132.  
  133.  
  134.  
  135.       SHAREWARE
  136.  
  137.                 The QUIK-INSTALL program is being marketed using the
  138.            shareware method.  This means you are encouraged to share copies
  139.            of the unregistered version for evaluation purposes.  If you
  140.            wish to use QUIK-INSTALL as an installation program for your
  141.            applications you must register with the author.  Please read the
  142.            fuller explanation of shareware and the copyright notice near
  143.            the end of this document.
  144.  
  145.  
  146.       VENDOR DESCRIPTION
  147.  
  148.       LONG:     QUIK-INSTALL v1.6 - An easy to setup and use application
  149.                 installation program.  Installs applications from floppy
  150.                 disks to hard disks.  Supports multiple disk installations,
  151.                 copies files or installs from EXE archives, checks
  152.                 available disk space, creates subdirectories, auto executes
  153.                 application after installation, configurable colors, prompt
  154.                 and message, stores setup internally (self modifying code),
  155.                 only 8k in size.  Runs on any PC compatible computer.
  156.  
  157.       SHORT:    QUIK-INSTALL v1.6 - Application installation program. Many
  158.                 features.
  159.  
  160.  
  161.       USING QUIK-INSTALL
  162.  
  163.            Because QUIK-INSTALL modifies it's own code it is imperative
  164.       that you make a copy of your original disk then use your copy to
  165.       create your installation setup.
  166.  
  167.            To use the program you start it by typing INSTALL then press
  168.       ENTER.  At this point you may enter a drive and directory name to
  169.       copy all the files in the currently logged disk to.  You can use
  170.       QUIK-INSTALL without doing any setup.  QUIK-INSTALL installation or
  171.       setup can be canceled at any time by pressing CTRL-C or CTRL-BREAK.
  172.  
  173.            If you do not configure QUIK-INSTALL it will default to doing a
  174.       straight file copy, no message, 1 disk, will not exit in the
  175.       installed directory, will not check for enough disk space to install
  176.       to and will not stuff the keyboard buffer.
  177.  
  178.            You may rename QUIK-INSTALL to anything you like after it has
  179.       been set up.  In order for it to be able to modify itself it must be
  180.       named INSTALL.COM.
  181.  
  182.  
  183.       CONFIGURING QUIK-INSTALL  (setup)
  184.  
  185.            To configure QUIK-INSTALL you start the program by typing
  186.       INSTALL then press ENTER.  At the first prompt that ask you to enter
  187.       a drive and sub-directory name you must enter the word SETUP then
  188.       press the ENTER key.  It is not case sensitive.  After pressing ENTER
  189.       you will be prompted to answer ten questions.  If you do not wish to
  190.       use an option just press ENTER to skip it.
  191.  
  192.  
  193.       Option 1. Enter install completion message:
  194.  
  195.            At this prompt you may enter a message that will be displayed at
  196.            the end of the installation.  Most likely this would be a
  197.  
  198.  
  199.  
  200.  
  201.            message on how to start or configure your program.  It could be
  202.            a greeting or warning.  It can be anything you like up to 80
  203.            characters.
  204.  
  205.       Option 2. Enter default prompt:
  206.  
  207.            When the program runs it prompts the user to press ENTER to
  208.            accept the default drive and subdirectory name to install to. 
  209.            You should use an example that will be suitable for your
  210.            program.  Example:  If your program is named QUIKWORK your might
  211.            want the user to install the program to a directory named
  212.            QUIKWORK.  In this case enter C:\QUIKWORK.
  213.  
  214.       Option 3. Number of disks:
  215.  
  216.            Here you should enter the number of disks you would like QUIK-
  217.            INSTALL to prompt for and copy.  This number is unlimited.
  218.  
  219.       Option 4. Exit in installation directory? <Y/N>
  220.  
  221.            After the installation is completed you will most likely want
  222.            your user to start your program.  If this is the case you should
  223.            answer Y to this question.  Answering Y will cause the user to
  224.            be in the installed directory after installation has completed. 
  225.            It is not case sensitive.
  226.  
  227.       Option 5. Stuff keyboard buffer with:
  228.  
  229.            If you like QUIK-INSTALL will stuff the keyboard buffer with a
  230.            command of your choice.  This allows the user to start the
  231.            program without doing a directory to find the right file.  This
  232.            could be a batch file to type a README or it could start your
  233.            program.  You may leave this option blank.
  234.  
  235.       Option 6. Execute Buffer? <Y/N>
  236.  
  237.            This option appears only if you use option 5.  If you stuff a
  238.            command into the keyboard buffer after installation it can be
  239.            very useful to have it execute immediately.  You might wish your
  240.            user to read a text file or start a configuration program.  If
  241.            you stuff the buffer with a batch file you can have the install
  242.            program do a number of things.  You may leave this option blank
  243.            if you like.
  244.  
  245.       Option 7. If executable archive enter filename:
  246.  
  247.            This option has some important features.  First, when QUIK-
  248.            INSTALL is run it will copy files or try to run an executable
  249.            archive.  If you enter a filename at this prompt the program
  250.            will try to run an executable archive by the name you enter.  If
  251.            your program is being installed from a single disk this is all
  252.            you need to do.
  253.  
  254.            If you are using executable archives and installing an
  255.            application that requires more than 1 disk there are some
  256.            special considerations.  In order to keep the QUIK-INSTALL
  257.            program at it's minimum size I opted not to store individual
  258.            filenames for multiple disk archive installations.  Instead I
  259.            use a simple system that requires you to name your executable
  260.            archives using a number as the last letter of the filename.
  261.  
  262.            Example: If your program uses three disks to install and your
  263.  
  264.  
  265.  
  266.  
  267.            program's name is MYWORK you would have to name your three
  268.            executable archives MYWORK1.EXE, MYWORK2.EXE and MYWORK3.EXE. 
  269.            When the QUIK-INSTALL program asks you for an archive name you
  270.            would enter MYWORK.  This method allows me to concatenate a
  271.            number to the MYWORK filename based on the number of disks you
  272.            are installing.  It also allows an unlimited number of disks and
  273.            requires no extra space inside the QUIK-INSTALL program.  (Note:
  274.            Make sure your file name does not exceed 7 characters (6
  275.            characters if you install 10 or more disks) so the disk number
  276.            can be concatenated.)
  277.  
  278.            The QUIK-INSTALL program will work with any executable archive. 
  279.            It is not dependant on the command syntax of any of the known
  280.            EXE archive compressors.
  281.  
  282.       Option 8. Disk space needed to install:
  283.  
  284.            To have the program test for available disk space before
  285.            installing, enter the amount of space your program requires in
  286.            bytes.  If the user tries to install your application to a drive
  287.            that does not have enough space QUIK-INSTALL will abort the
  288.            installation.  It will also display a message explaining that
  289.            your application requires the amount of space you enter here. 
  290.            Like all options you may leave this blank to have the program
  291.            skip disk space checking.
  292.  
  293.       Option 9. Background color & Hi-lite color:
  294.  
  295.            You can set the color attributes for the background color and
  296.            background text and you can set a separate color attribute for
  297.            the boxed in text.  Colors are set by entering an attribute
  298.            number in response to color questions.
  299.  
  300.            Colors are determined by using the following color codes to set
  301.            the screens background and foreground colors.  You can even set
  302.            flashing colors although it is not recommended.  (Most people
  303.            find continuously flashing text annoying.)
  304.  
  305.            To select a color you must first choose the background color
  306.            code then add the foreground color code to it.  For example: The
  307.            color code for a blue background ranges from 16 to 31.  To
  308.            create a blue back-ground with white text you would add 15 (The
  309.            foreground code for white) to 16 (The background code for blue)
  310.            making a color code of 31.  If you wanted a blue background with
  311.            yellow text you would add 16 (The color code for blue.) and 14
  312.            (The color code for yellow.) for a total of 30.
  313.  
  314.       BACKGROUND COLOR with FOREGROUND...      FOREGROUND COLOR...
  315.       CODE           COLOR        ATTRIBUTE    CODE          COLOR
  316.       ----           -----        ---------    ----          ----- 
  317.         0 ---------- Black ------ Normal        0 ---------- Black
  318.        16 ---------- Blue ------- Normal        1 ---------- Blue
  319.        32 ---------- Green ------ Normal        2 ---------- Green
  320.        48 ---------- Cyan ------- Normal        3 ---------- Cyan
  321.        64 ---------- Red -------- Normal        4 ---------- Red
  322.        80 ---------- Magenta ---- Normal        5 ---------- Magenta
  323.        96 ---------- Brown ------ Normal        6 ---------- Brown
  324.       112 ---------- Light Grey - Normal        7 ---------- Light Grey
  325.       128 ---------- Black ------ Flashing      8 ---------- Dark Grey
  326.       144 ---------- Blue ------- Flashing      9 ---------- Light Blue
  327.       160 ---------- Green ------ Flashing     10 ---------- Light Green
  328.       176 ---------- Cyan ------- Flashing     11 ---------- Light Cyan
  329.  
  330.  
  331.  
  332.  
  333.       192 ---------- Red -------- Flashing     12 ---------- Light Red
  334.       208 ---------- Magenta ---- Flashing     13 ---------- Light Magenta
  335.       224 ---------- Brown ------ Flashing     14 ---------- Yellow
  336.       240 ---------- Light Grey - Flashing     15 ---------- White
  337.                                                                             
  338.            The best way to determine which colors will be affected by your
  339.            color changes is to change a few and look at the effects.
  340.  
  341.            The program colors default to 31 (White on blue) for the
  342.            background and 7 (White on black) for the hi-lite color.
  343.  
  344.  
  345.       QUIK-INSTALL NOTES & CONSIDERATIONS
  346.  
  347.            The QUIK-INSTALL program must be named INSTALL.COM to be able to
  348.       modify it own code.  It can however be renamed after setup is
  349.       completed.  This is even recommended as it will make more difficult
  350.       the chances of anyone else modifying your setup.
  351.  
  352.            QUIK-INSTALL can be further reduced in size by using an EXE
  353.       compressor program such as LZEXE or PKLITE.  This will reduce it's
  354.       size to approximately 6500 bytes.  Be warned, once compressed the
  355.       setup cannot be modified.  Make a backup copy!
  356.  
  357.            All of the QUIK-INSTALL features are optional.  You can leave
  358.       any or all blank to have them skipped.
  359.  
  360.            You can abort the QUIK-INSTALL program at any time by pressing
  361.       the CTRL-C or CTRL-BREAK key combination.
  362.  
  363.            When running the QUIK-INSTALL program to change the setup you
  364.       must be logged to the drive and directory the QUIK-INSTALL program is
  365.       residing in.  If you do not it will not be able to modify it's code.
  366.  
  367.            QUIK-INSTALL does minimal error checking for user input.  It
  368.       tries to make sure a valid drive and directory name is entered.  To
  369.       minimize the size of the program the QUIK-INSTALL program does no
  370.       error checking when entering setup data.  This means if you enter an
  371.       invalid response to a setup question the results may be
  372.       unpredictable.  Ex: If you enter yes when the program ask for number
  373.       of disks to copy it will definitely not work and could possible lock
  374.       up your computer.
  375.  
  376.            You can reset the QUIK-INSTALL program back to it's defaults by
  377.       starting the program, typing SETUP then pressing ENTER for all of the
  378.       setup questions.
  379.  
  380.            Every field within QUIK-INSTALL that allows user input uses the
  381.       built in DOS command processor's line editor.  This was done to
  382.       reduce program size and still have a full function line editing
  383.       ability.  If you use a utility like the DOS 5's DOSKEY program or the
  384.       shareware CED program all of their features will be functional within
  385.       the QUIK-INSTALL program.
  386.  
  387.            The QUIK-INSTALL program contains internal copyright notices. 
  388.  
  389.  
  390.       SHAREWARE
  391.  
  392.            Shareware is software marketed on a "Try before you buy" basis.
  393.  
  394.            The price per disk that Shareware distributors charge is a
  395.  
  396.  
  397.  
  398.  
  399.       distribution fee and not the price of the software.  Shareware
  400.       authors have agreed to allow vendors to recover expenses for copying,
  401.       packaging, and maintaining a shareware library.  This allows you to
  402.       obtain software programs at incredibly low prices to try, then pay
  403.       the registration price for them only if they suit your needs. The
  404.       idea is that after a reasonable trial period, if you find the
  405.       programs to be of use, you are expected to send the author the
  406.       registration fee.
  407.  
  408.            Registration entitles you to various rights and benefits.  These
  409.       range from the legal (and moral) right to continue using the
  410.       software.  In addition many shareware authors offer printed
  411.       documentation and/or higher levels of service and support. Unlike
  412.       Public Domain software, which is free to everyone with no fees asked
  413.       for or expected, shareware programs exist because the authors expect
  414.       and deserve the registration support from people who use their
  415.       programs.
  416.  
  417.                 So that's Shareware.  If you like it, support it !
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.       REGISTRATION
  466.  
  467.            The shareware message will be removed on any registered version
  468.       of QUIK-INSTALL.  Registered users of QUIK-INSTALL will receive a
  469.       customized copy of the program and a printed copy of the manual.
  470.       (Laser printed booklet.)
  471.  
  472.            Registration for a single program entitles you to distribute
  473.       QUIK-INSTALL with as many copies of a single application as you
  474.       produce. You may not use QUIK-INSTALL with any program other than the
  475.       one listed on the registration form.  There are no royalties for
  476.       distribution.  You must register a copy of QUIK-INSTALL for each
  477.       program you intend to distribute it with or purchase an Author
  478.       license.
  479.  
  480.            With a Author's license you may distribute as many copies of
  481.       QUIK-INSTALL with as many different programs as you have produced as
  482.       long as every program is produced under the same copyright notice.
  483.  
  484.            With both a single program and Author's registration you will
  485.       receive a copy of QUIK-INSTALL that has a customized header.  The
  486.       second of the top two lines may contain any text you specify as long
  487.       as you do not indicate or imply that you have copyrighted the QUIK-
  488.       INSTALL program.  The following are example headings.  You may
  489.       however choose anything you like for the heading.
  490.  
  491.  
  492.            For a single program license the header must be specific,
  493.       pertaining to the program it will be installing.  Example:
  494.  
  495.       QUIK-INSTALL v1.6 Copyright 1992 Michael L. Wester
  496.       Install program for YOURPROGRAM v2.5
  497.  
  498.  
  499.            For an author's license it should be generic so it can be used
  500.       with any program.  Example:
  501.  
  502.       QUIK-INSTALL v1.6 Copyright 1992 Michael L. Wester
  503.       Licensed to:  WHOEVERYOUARE SOFTWARE COMPANY
  504.  
  505.  
  506.            Registration for Shareware disk vendors entitles you to
  507.       distribute the QUIK-INSTALL program on every disk you sell as an easy
  508.       installation program for your customers.  The second line of the top
  509.       two lines the program displays will be customized with a message of
  510.       your choice.  The QUIK-INSTALL copyright notice must remain intact. 
  511.       You may not use QUIK-INSTALL under any corporate name other than the
  512.       name listed on the registration form.
  513.  
  514.            Being a registered user of the QUIK-INSTALL program does not
  515.       mean you own QUIK-INSTALL.  Registered users are licensed to use and
  516.       distribute QUIK-INSTALL with specific applications or with
  517.       applications produced under their company or author name.  You may
  518.       not sell QUIK-INSTALL as an individual product.  It must accompany
  519.       the application it will be installing.
  520.  
  521.  
  522.                                      DISCLAIMER
  523.  
  524.             Under no circumstances shall Michael L. Wester be liable for
  525.       any damages, including lost profits, savings, or any other
  526.       incidental or consequential damages arising out of the use of or
  527.  
  528.  
  529.  
  530.  
  531.       inability to use this program even if Michael L. Wester has
  532.       been notified of the possibility of such damages, or for any claims
  533.       by any other party.
  534.  
  535.       COPYRIGHT NOTICE
  536.  
  537.            QUIK-INSTALL is copyrighted 1992 by Michael L. Wester.  All
  538.       rights reserved.  The QUIK-INSTALL program may not be sold under any
  539.       circumstances.  Registered users are licensed to use and distribute
  540.       QUIK-INSTALL with programs and applications they produce.  Registered
  541.       users of QUIK-INSTALL may not sell or distribute the registered
  542.       version unless it accompanies an application or program of their own
  543.       creation.  Unregistered versions of the QUIK-INSTALL program may be
  544.       distributed for evaluation purposes only.  The QUIK-INSTALL program
  545.       may not be distributed on CD-ROM (Compact Disk Read Only Memory)
  546.       without express written permission from Michael L. Wester.
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.       REGISTRATION  -  QUIK-INSTALL.EXE   Copyright 1992 Michael L. Wester
  598.  
  599.       Michael L. Wester                                 (919)-552-0767
  600.       Route #6 Box 34
  601.       Fuquay-Varina, NC 27526
  602.  
  603.  
  604.       Name_______________________________________________
  605.       Address____________________________________________
  606.       City/State__________________________ZIP____________
  607.       Phone #____________________________________________
  608.  
  609.       *******************************************************************
  610.       Registration for Single Program:        $15.00
  611.       For unlimited copies distributed with a single application.
  612.  
  613.       Enter the name of the program QUIK-INSTALL will be distributed with.
  614.  
  615.       1._________________________________________________________________
  616.  
  617.       *******************************************************************
  618.       Registration for a Author or Vendor license:      $45.00
  619.       Unlimited copies for any programs copyrighted or distributed under
  620.       the same company name.
  621.  
  622.       Enter your Company or Author name.
  623.  
  624.       1._________________________________________________________________
  625.  
  626.       Enter the text you wish to be displayed on the second of the top two
  627.       lines after the program starts.  (This is the line beneath the QUIK-
  628.       INSTALL copyright notice.)  (YOU MAY NOT IMPLY A COPYRIGHT OF THE
  629.       QUIK-INSTALL PROGRAM ON THIS LINE.)
  630.  
  631.       1._________________________________________________________________
  632.  
  633.       *******************************************************************
  634.       Please sign and date your order form:
  635.       *******************************************************************
  636.  
  637.       Date:_________________ Signature:__________________________________
  638.  
  639.       Single program license - single copy ....................... $15.00
  640.       Author's license - single copy ............................. $45.00
  641.  
  642.       6% N.C. tax ............................................ $_________
  643.       Mailing and handling cost ................................... Free
  644.  
  645.       TOTAL .................................................. $_________
  646.  
  647.       [ ] Check enclosed  [ ] Money order enclosed  [ ] VISA/MC  [ ] C.O.D
  648.       Foreign user, please send Check or Money order in U.S. dollars only.
  649.  
  650.       Call 919-552-0767 for credit card and C.O.D phone orders or mail to
  651.       the address at the top of the order form.  You may also register by
  652.       credit card and receive your registered copy of QUIK-INSTALL via
  653.       modem within 24 hours (Sometimes quicker).  Call the preceding number
  654.       to register.
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.