home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / CLIPPER / MISC / EZINST1B.ZIP / EASYINST.DOC < prev    next >
Encoding:
Text File  |  1991-09-21  |  12.5 KB  |  298 lines
  1.  
  2.                             EASY INSTALL  Ver. 1.0B
  3.  
  4.  
  5.                         (c) 1991   Scanlon Enterprises
  6.  
  7.  
  8.  
  9.  
  10.        This is a beta release of EASY INSTALL, and all suggestions and 
  11.        comments are welcome. If this product does NOT meet with your 
  12.        requirements, we would like to know. Our goal is to provide an 
  13.        in-expensive version of an installation system for Shareware 
  14.        Authors and developers.
  15.  
  16.        EASY INSTALL is an easy to use installation system. This system 
  17.        will prompt your software user for both source and destination. 
  18.  
  19.        EASY INSTALL automatically detects if the system is color or mono 
  20.        and sets the display to the appropiate colors. EASY INSTALL will 
  21.        attempt to detect the source drive, but allows your user to edit 
  22.        this to adjust for any errors.
  23.  
  24.        EASY INSTALL will also attempt to detect the drive type (fixed or 
  25.        removable) the user selects as a destination. If EASY INSTALL can 
  26.        not properly detect the drive type, the user will be prompted to 
  27.        verify the type.
  28.  
  29.  
  30.        EASY INSTALL, as a default, will display, if it exists, the new 
  31.        industry standard README file, with the extension SIF 
  32.        (README.SIF). Also EASY INSTALL displays the messages found in 
  33.        the file EASYREAD, or will display an opening screen message of:
  34.  
  35.        ---------------------------------------------------------------
  36.         EasyInstall Will NOT modify your AUTOEXEC.BAT or CONFIG.SYS files
  37.         
  38.         HowEver, the Installation Commands used by the Author may do so
  39.         If you have NOT read the Authors Readme File or Documentation
  40.         We suggest you Abort NOW,  [Enter] to Continue or [Escape] to Abort
  41.        ---------------------------------------------------------------
  42.  
  43.        *** NOTE *** Only the lines between the dashed lines appear on 
  44.        the opening screen....
  45.  
  46.        This message is displayed unless the Software Developer or user 
  47.        selects the bypass option (see Syntax  below). Although EASY 
  48.        INSTALL will NOT modify any system file on its own, we can NOT 
  49.        guarantee that such will NOT happen, since the Developing Author 
  50.        may include a command which may do so.
  51.          
  52.  
  53.        ** NOTE ** DO NOT RENAME EASY INSTAL (EASYINST.EXE) TO ANOTHER 
  54.        NAME AND RUN IT. EASYINST HAS BEEN INTENTENTIONALLY CODED NOT TO 
  55.        EXECUTE IF RENAMED. YOU WILL JUST GET AN ERROR MESSAGE. The 
  56.        registered version does NOT have this limitation.
  57.  
  58.        EASY INSTALL modifies itself during the process of installing the 
  59.        developers config file (command set). Please keep an original 
  60.        copy of EASY INSTALL . We suggest you use our batch file and 
  61.        binary file (EASYINST.BIN) to maintain the original.
  62.  
  63.  
  64.                                     Page 1
  65.  
  66.                             EASY INSTALL  Ver. 1.0
  67.  
  68.  
  69.                         (c) 1991   Scanlon Enterprises
  70.  
  71.  
  72.  
  73.        Syntax: EASYINST /Cfname /B
  74.  
  75.        Where : '/Cfname' is the command line switch to place EASYINST 
  76.        into CFG mode, where the specified file 'fname' is read and 
  77.        appended to the EASYINST program. If 'fname' is NOT specified, 
  78.        then EASYINST will check for the presence of EASYINST.CFG . An 
  79.        error message will be generated if 'fname' or the default file is 
  80.        NOT found.
  81.  
  82.        Where : '/B' bypass opening screen which displays the messages 
  83.        about the Easy Install NOT modifying DOS system files, or the 
  84.        automatic display of README.SIF or EASYREAD.
  85.  
  86.        DEFAULTS:
  87.  
  88.        'fname' is set to EASYINST if NOT specified
  89.  
  90.        The CFG (or batch) file must contain at least 5 lines. The 5 
  91.        lines must contain:
  92.  
  93.                1) @TITLE@{Your program Name/Version (40 char max)}
  94.                2) @TYPE@{Type of system to install to. If HD is
  95.                          specified, then a hard drive is required
  96.                          otherwise use FLP (for floppy)}
  97.                          IE.. @TYPE@HD   or   @TYPE@FLP
  98.                3) @SIZE@{Minimum BYTES required to install your
  99.                          software onto the users system}
  100.                4) @DEST@{Default drive and path to install to
  101.                          IE...@DEST@C:\  or C:\DIR\}
  102.                          Always end this line with the backslash
  103.                5) Your first installation command
  104.                   IE....
  105.                    LHA E @SRC@SEBFU40 @DEST@
  106.  
  107.        In the last line, above, @SRC@ will be filled in by EASYINST, and 
  108.        is  the source drive, where your installation files are  located. 
  109.        The  @DEST@ is the destination selected by the user, and  limited 
  110.        by the two lines containing @TYPE@ and @SIZE@.
  111.  
  112.  
  113.        EASY INSTALL will automatically detect the source (where EASY 
  114.        INSTALL started from), the video system (color or mono), the 
  115.        drive capacity of the destination and, if DOS 3.x and up, will 
  116.        automatically detect the type of drive the destination is 
  117.        (removable of fixed). If the DOS version is under 3.x user 
  118.        installing your software is prompted to specify the drive type.
  119.  
  120.  
  121.                                     Page 2
  122.  
  123.  
  124.                             EASY INSTALL  Ver. 1.0
  125.  
  126.  
  127.                         (c) 1991   Scanlon Enterprises
  128.  
  129.  
  130.        EXAMPLES:
  131.  
  132.        Config command line                      Line number
  133.        ----------------------------------------------------
  134.        @TITLE@SEBFU  Version 4.0                     1
  135.        @TYPE@FLP                                     2
  136.        @SIZE@200000                                  3
  137.        @DEST@A:\                                     4
  138.        IF HD                                         5
  139.        LHA E @SRC@SEBFU40 @DEST@                     6
  140.        IF FLP                                        7
  141.        CHGDRV                                        8
  142.        LHA E @SRC@SEBFU40 @DEST@                     9
  143.  
  144.        Thus, if the user is installing to a hard disk, the installation 
  145.        code on the line after the IF HD will be executed. If the user 
  146.        selects installation to a floppy, then the code following the IF 
  147.        FLP will be executed.
  148.  
  149.        If you have any questions, don't hesitate to call.
  150.  
  151.  
  152.        In the example, the program title is SEBFU  Version 4.0
  153.                        the program can be installed to a floppy
  154.                        the program requires 200K bytes of space
  155.                        the destination is set to drive A
  156.  
  157.        Notice the use of IF in line 5, this is our special test 
  158.        condition, where IF may be followed by either HD or FLP , which 
  159.        is the drive type of the destination the user selected to install 
  160.        to.
  161.  
  162.        Line 5 begins the set of instructions which will execute if the 
  163.        destination drive is a hard drive. All lines between line 5 and 
  164.        the next line containing either IF HD   or IF FLP  will be 
  165.        executed by EASY INSTALL. In this example, there is only one 
  166.        line, which is line 6.
  167.  
  168.        Line 7 begins the set of instructions which will execute if the 
  169.        destination drive is a floppy drive. All lines between line 7 and 
  170.        the next line contains either IF HD  or  IF FLP  will be executed 
  171.        by EASY INSTALL.  In this example, there are only two line, which 
  172.        are line 8 and 9.
  173.  
  174.        NOTICE line 8, this is a special command which EASY INSTALL uses 
  175.        as a flag to wait for the user to change disks in the specified 
  176.        floppy disk system. Use CHGDRV when you want the user to change 
  177.        disks during the installation process.
  178.  
  179.        EASY INSTALL will prompt the user to change disks automatically 
  180.        if it detects the current destination does NOT have the required 
  181.        disk space specified in the  @SIZE@  statement, on line 3.
  182.  
  183.  
  184.                                     Page 3
  185.  
  186.                             EASY INSTALL  Ver. 1.0
  187.  
  188.  
  189.                         (c) 1991   Scanlon Enterprises
  190.  
  191.  
  192.  
  193.        EXAMPLES {continued}
  194.  
  195.        Config command line                      Line number
  196.        ----------------------------------------------------
  197.        @TITLE@SEBFU  Version 4.0                     1
  198.        @TYPE@FLP                                     2
  199.        @SIZE@200000                                  3
  200.        @DEST@A:\                                     4
  201.        LHA E @SRC@SEBFU40 @DEST@                     5
  202.  
  203.  
  204.        This is the basic use of EASY INSTALL, and can meet the needs of 
  205.        many Authors. This format will verify that the disk to install to 
  206.        contains at least the amount specified by @SIZE@ (200K) and 
  207.        proceed to install to the specified destination if it meets this 
  208.        minimum size. IE.. if the destination has 200K bytes available, 
  209.        then the command on line 5 will be executed.
  210.  
  211.  
  212.        Config command line                      Line number
  213.        ----------------------------------------------------
  214.        @TITLE@SEBFU  Version 4.0                     1
  215.        @TYPE@FLP                                     2
  216.        @SIZE@200000                                  3
  217.        @DEST@A:\                                     4
  218.        COPY @SRC@*.* @DEST@                          5
  219.  
  220.  
  221.        This will use the DOS COPY command to copy all files from the 
  222.        source to the destination, as long as the destination contains at 
  223.        least 200K bytes free. EASY INSTALL will automatically pause for 
  224.        the user to insert a disk with the required free space, if it 
  225.        detects the current source does NOT have enough.
  226.  
  227.        EASY INSTALL recommends using the DOS copy command, instead of 
  228.        XCOPY as the user may not have a path set, or XCOPY available, 
  229.        such as systems running DOS 2.x .  You may substitute a 
  230.        Commercial or Shareware file copy utility on your disk as a 
  231.        replacement command, but be sure to affix the @SRC@ specification 
  232.        to this replacement command to assure DOS can find it.
  233.  
  234.        IE...
  235.  
  236.        Config command line                      Line number
  237.        ----------------------------------------------------
  238.        @TITLE@SEBFU  Version 4.0                     1
  239.        @TYPE@FLP                                     2
  240.        @SIZE@200000                                  3
  241.        @DEST@A:\                                     4
  242.        @SRC@CCOPY @SRC@SEBFU40 @DEST@                5
  243.  
  244.        This would perform exactly as the above, if the program CCOPY.COM 
  245.        or CCOPY.EXE exists on the source disk.
  246.  
  247.  
  248.                                     Page 4
  249.  
  250.        If you are interested in this easy to use installation system, 
  251.        for use with your software, you may use this system as often as 
  252.        necessary (in house). If you decide to register, you will get 
  253.        virtually the same system, but with the added features of :
  254.  
  255.                NO EASY INSTALL Title screen (top line)
  256.                (An exit message will be displayed)
  257.  
  258.                DISPLAYS DATE AND TIME AT TOP WITH YOUR AUTHOR NAME
  259.                (or Author Company name)
  260.  
  261.                PROGRAM CAN BE RENAMED WITHOUT GENERATING AN ERROR
  262.  
  263.                You will be added to our mailing list to be notified
  264.                of new versions or other products.
  265.  
  266.  
  267.  
  268.        EASY INSTALL is available for only $9.95 plus a shipping and 
  269.        material charge of only $3 (US).  Please read the EASYORD.DOC 
  270.        file for ording instructions or print it out :
  271.  
  272.                COPY EASYORD.DOC PRN
  273.  
  274.  
  275.        Limitations of registration:
  276.  
  277.        1 program may be configured using 1 registration. Additional 
  278.        registrations are required for mutiple programs. Once EASY 
  279.        INSTALL is configured, an unlimited number of EASY INSTALL files 
  280.        may be used (by your customers). The program may be updated and 
  281.        new commands placed into EASY INSTALL, from the original EASY 
  282.        INSTALL program, at no additional registration fee.
  283.  
  284.        IE... PROG A requires 1 registration
  285.              PROG B requires another registration
  286.  
  287.        However, once the /C (config) option is used, as many copies of 
  288.        the modifed EASY INSTALL program may be made and distributed as 
  289.        is necessary to send to all your registered or software buyers.
  290.  
  291.  
  292.        If you have any questions requarding EASY INSTALL please call 
  293.        Paul Scanlon at (805) 272-4827 .
  294.  
  295.  
  296.  
  297.                                     Page 5
  298.