home *** CD-ROM | disk | FTP | other *** search
/ Piper's Pit BBS/FTP: ibm 0020 - 0029 / ibm0020-0029 / ibm0028.tar / ibm0028 / INSTALL2.TD0 / SOURCES.LIF / COMBINE.DOC < prev    next >
Encoding:
Text File  |  1990-09-27  |  3.5 KB  |  77 lines
  1.  
  2.  
  3. PURPOSE
  4.     This short file explains how to create an self-extracting library file. 
  5.  
  6.  
  7. DEFINITION
  8.     A self-extracting library file is an aggregate file composed of the file 
  9. COMBINE.DAT, an INSTALL.DAT script file, and a library file.  Self-extracting 
  10. files are useful in two contexts: 1) when you are distributing a file via 
  11. public domain bulletin boards, and 2) when you want the make sure your end
  12. -users don't try to install some files by hand (since only one file is 
  13. distributed, it's pretty hard for them to make a mistake). 
  14.  
  15.  
  16. CREATION OF A SELF-EXTRACTING FILE
  17.     The syntax for the INSTALL.DAT file is the same as for the non-self
  18. -extracting version with one additional restriction: 
  19.  
  20.  
  21.        The script file must have exactly one @DefineDisk/@EndDisk  
  22.        block, and that block must contain exactly one @BeginLib/ 
  23.        @EndLib block.  That is, all files to be installed must be  
  24.        within a single library file.  
  25.   
  26. To actually create a combined file, you should follow the steps below:  
  27.   
  28. 1) First, create a single library file containing all of the  
  29.    files you wish to distribute.  
  30.  
  31. 2) Use the librarian's GENERATE command to create a @BeginLib/ 
  32.    @EndLib block which can be included in a INSTALL.DAT script 
  33.    file.  
  34.   
  35. 3) Edit the skeleton INSTALL.DAT file supplied as file  
  36.    EXAMPLEC.DAT and put your product name, version, etc. in the  
  37.    appropriate fields. Put the GENERATEd file (from step 2) in  
  38.    the @DefineDisk block.  
  39.  
  40. 4) Make sure the file COMBINE.DAT is on the current drive & directory. 
  41.  
  42. 5) Run COMBINE.EXE with three command line parameters.  The  
  43.    first parameter is the name of the combined file you want to  
  44.    distribute. The second is the name of the script file created 
  45.    in step 3.  The third, is the name of the library file created 
  46.    in step 1 above.  When COMBINE.EXE is done, your default  
  47.    drive/directory will contain the newly-created combined file  
  48.    in executable format.  
  49.   
  50. 5) Test the new aggregate file - you should try all combinations of  
  51.    installation options.  
  52.   
  53.    Note: since the combined file is may be intended for electronic  
  54. distribution, INSTALL.EXE has some new capabilities that make it resilient 
  55. to files that 'grow' when transmitted via XMODEM.  
  56.   
  57.    The file COMBINE.DAT the self-extracting version of INSTALL.EXE.  You  
  58. must be certain that the self-extracting version of INSTALL.EXE  
  59. (identified by a letter 's' after the version number in the banner) is  
  60. in the default drive/directory before using COMBINE.EXE.  
  61.   
  62.         If you have any questions, difficulties, or comments, please feel free to  
  63. call Knowledge Dynamics at 1-512-964-3994.  
  64.  
  65.         IMPORTANT: You should not rename the self-extracting .EXE file once it 
  66. has been combined with the script file and the library file.  If the file is 
  67. renamed, then computers running a DOS version less than 3.0 will be unable 
  68. to run the self-extracting file until it is renamed to the name you specified 
  69. as the first parameter to COMBINE.EXE.  This behavior is due the inability 
  70. of programs to determine the location of the currently execution program.  For 
  71. example, under DOS 3.0 and above, if you run the program INSTALL.EXE by 
  72. typing "C:\INSTALL\INSTALL" the program INSTALL.EXE can, if necessary,  
  73. determine that the end-user typed "C:\INSTALL\INSTALL.EXE" and look on drive 
  74. C: and on subdirectory "\INSTALL\" for the file "INSTALL.EXE".  
  75.   
  76. ----------------------------- end-of-file ------------------------------------- 
  77.