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