home *** CD-ROM | disk | FTP | other *** search
/ Computerworld 1996 March / Computerworld_1996-03_cd.bin / idg_cd3 / utility / ezinst13 / readme.txt < prev    next >
Encoding:
Text File  |  1995-08-09  |  12.8 KB  |  272 lines
  1.  
  2.  
  3.                         EZinst v1.3
  4.  
  5.  
  6. Introduction
  7. ============
  8.  
  9.     EZinst is an installation program for Microsoft Windows. It was 
  10. designed for programmers, consultants, and other computer users in need of a
  11. simple, inexpensive, customizable Windows installation program. EZinst v1.3
  12. has been tested with Windows 95.
  13.  
  14.  
  15. Installation
  16. ============
  17.  
  18.         Installing EZinst is extremely easy.
  19.  
  20.         STEP #1. Start Microsoft Windows.
  21.  
  22.         STEP #2. From the File sub-menu menu in Program Manager, choose
  23. Run...
  24.  
  25.         STEP #3. Specify the location of the EZinst files and type "install".
  26.                 Ex: a:install
  27.                 Ex: c:\apl\comm\install
  28.  
  29.         STEP #4. The installation program will prompt you to enter the
  30. destination drive/directory.
  31.                 Ex: c:\ezinst
  32.  
  33.         STEP #5. The installation program will finish the installation 
  34. automatically.
  35.  
  36.  
  37. File list
  38. =========
  39.  
  40.     This is a complete file list.
  41.  
  42.         1. INSTALL.EXE - the main installation program.
  43.  
  44.         2. INSTALL.INI - the installation file and example.
  45.  
  46.         3. INSTALL.HLP - the on-line help file.
  47.  
  48.         4. COMPRESS.EXE - Microsoft's compression utility.
  49.         
  50.         5. README.TXT - this file.
  51.  
  52.         6. CATALOG.TXT - a list of Burnham Park Software, Inc's 
  53.            shareware titles.
  54.         
  55.         7. ORDER.FRM - the form for registering EZinst.
  56.  
  57.         8. FILE_ID.DIZ - the description file.
  58.  
  59.         9. VENDINFO.DIZ - the verdor information file.
  60.  
  61.  
  62. Using EZinst
  63. ============
  64.  
  65.         The EZinst program (INSTALL.EXE) is small (about 70k) and easy to 
  66. use. Simply copy it to the distribution disk along with the INSTALL.INI file 
  67. (described in the following section) and the distribution files. It will then 
  68. be ready to install. All the person installing the program has to do is run 
  69. Microsoft Windows and use the File-Run... menu command (Example: 
  70. a:install.exe). The rest is self explanatory.
  71.  
  72.  
  73. The INSTALL.INI file
  74. ====================
  75.  
  76.     The INSTALL.INI file is easy to use, but must be syntactically 
  77. correct. 
  78.  
  79. Section #1      The version number of the .INI file. The @@VER@@=#.# macro
  80.                 defines the EZinst compatible version number. (Note: if this
  81.                 line is missing, version 1.1 will be assumed.) This line may
  82.                 also contain several other macros: @@OLD@@ which will force
  83.                 EZinst to automatically overwrite older files, @@NEW@@ which
  84.                 will force EZinst to automatically overwrite newer files, and
  85.                 @@SIZE@@=x which will check if the destination disk has at
  86.                 leasy x bytes remaining.
  87. Section #2      The title, background colors, font style, and background
  88.                 bitmap. The first line is the title text which will be
  89.                 displayed in the title bar and in large letters in the
  90.                 background. The second line contains the two background
  91.                 colors. The first will start at the top of the window and
  92.                 blend into the second color at the bottom. The colors may be
  93.                 followed by the following macros: @@ITA@@ which will cause
  94.                 the title to be italicized, @@UND@@ which will cause the
  95.                 title to be underlined, @@LRG@@ which will cause the title to
  96.                 be displayed in large letters, @@SML@@ which will cause the
  97.                 title to be displayed in small letters, @@BMP@@=filename.bmp
  98.                 which will cause the bitmap to be displayed in the center of
  99.                 the background, @@LFT@@ which will cause the bitmap to be
  100.                 displayed on the left, @@RGT@@ which will cause the bitmap to
  101.                 be displayed on the right, @@TOP@@ which will cause the
  102.                 bitmap to be displayed at the top, @@BOT@@ which will cause
  103.                 the bitmap to be displayed at the bottom, @@2X@@ which will
  104.                 cause the bitmap to be displayed at twice the normal size,
  105.                 and @@4X@@ which will cause the bitmap to be displayed at
  106.                 four times the normal size. (Note: the bitmap file must
  107.                 reside on the first installation disk.)
  108. Section #3      The default source and destination directories. The first
  109.                 line is the default source drive/directory. The @@CUR@@ macro
  110.                 will force the current working directory to be used and will
  111.                 suppress the "Install from" dialog-box. The second line is
  112.                 the default destination drive/directory. If it already
  113.                 exists, EZinst will prompt if it is to be used anyway. The
  114.                 @@OVR@@=dir macro will hard wire the supplied directory.
  115. Section #4      The message to be displayed while the files are being
  116.                 installed. The message can be anything from a registration
  117.                 reminder to hints about the program.
  118. Section #5      The files to be installed. The first line is the number of
  119.                 files to install (not counting any @@DISK@@ lines).
  120.                 Subsequent lines are the files to install. They may be
  121.                 compressed using Microsoft's compress.exe. The macro @@DISK@@
  122.                 will cause EZinst to wait for the next installation disk to
  123.                 be inserted and will be ignored in the file count. The macro
  124.                 @@DIR@@ and others may be used (see the Macros section).
  125. Section #6      The program group and program items to be installed.
  126.                 The first line is the program group. If it doesn't already
  127.                 exist, it will be created. The second line is the number of
  128.                 program items to be created in the program group. Make sure
  129.                 this number corresponds to the number of lines following it.
  130.                 Subsequent lines are the program items to be installed. The
  131.                 first part of an entry is the program to be run followed by
  132.                 any command-line parameters. The second part of an entry is
  133.                 the title, and is separated by a comma. The third part of an
  134.                 entry (optional) is the separate icon file, and is separated
  135.                 by a comma. The macro @@DIR@@ and others may be used (see the
  136.                 Macros section).
  137. Section #7      The entries in the WIN.INI (or other .INI files) to be
  138.                 installed. The first line is the number of entries to be
  139.                 installed. Make sure this number corresponds to the number of
  140.                 lines following it. The subsequent lines are the WIN.INI (or
  141.                 other) entries. The first part of each entry is the section,
  142.                 followed by a comma and the entry, followed by a comma
  143.                 and the string, optionally followed by a comma and the .INI
  144.                 file (WIN.INI is the default). The macro @@DIR@@ and others
  145.                 may be used (see the Macros section).
  146. Section #8      The additional programs to be executed (such as PKZIP or
  147.                 Notepad). The first line is the number of executions. Make
  148.                 sure this number corresponds to the number of lines following
  149.                 it. Subsequent lines are the programs to be run. The format
  150.                 is: command line, optionally followed by one of two display
  151.                 macros. The @@MAX@@ macro displays the program maximized and
  152.                 the @@MIN@@ macro displays the program minimized (the default
  153.                 is normal). The macro @@DIR@@ and others may also be used
  154.                 (see the Macros section).
  155.  
  156.  
  157. Example
  158. =======
  159.  
  160. @@VER@@=1.3                             ; Version number 1.2
  161. Gengame Installation                    ; Title to display while installing
  162. BLUE YELLOW @@ITA@@ @@BMP@@=gengame.bmp ; Background colors (blue to yellow)
  163. @@CUR@@                                 ; Default source drive/directory
  164. c:\gengame                              ; Default destination drive/directory
  165. Remember to register!                   ; Message
  166. 3                                       ; Number of files to install
  167. gengame.ex_                             ; Name of files (may be compressed or
  168. gengame.hl_                             ;   un-compressed). Must be the name
  169. @@DISK@@                                ;   in the source drive/directory)
  170. readme.tx_                              ;   @@DISK@@ will prompt for new disk
  171. Games                                   ; Program (manager) group
  172. 2                                       ; Number of program items
  173. @@DIR@@\gengame.exe, Generic Game       ; Program item(s) (program itself)
  174. winhelp @@DIR@@\gengame.hlp, Help       ;   (a help file)
  175. 2                                       ; Number of INI entries
  176. Gengame, dir, @@DIR@@                   ; INI entries (to WIN.INI)
  177. Gengame, high, 1000, gengame.ini        ;   (to GENGAME.INI)
  178. 1                                       ; Number of programs to execute
  179. @@WIN@@\notepad @@DIR@@\readme.txt      ; Program(s) to execute
  180.  
  181.  
  182. Macros
  183. ======
  184.  
  185.         @@DIR@@         This macro will be substituted by the destination
  186.                         directory.
  187.         @@ROOT@@        This macro will substituted by the root directory of
  188.                         the destination drive.
  189.         @@SRC@@         This macro will substituted by the source directory
  190.                         (and subdirectories).
  191.         @@SUB@@         This macro will substituted by the subdirectory of
  192.                         the destination directory following the macro. If it
  193.             does not exist, it will be created (only in the file
  194.             list).
  195.         @@SYS@@         This macro will be subsituted by the Windows system
  196.                         directory.
  197.         @@WIN@@         This macro will be subsituted by the Windows
  198.                         directory.
  199.  
  200.     Note: these macros may only be used in the file, program items,
  201. INI emtry, and ececution lists.
  202.  
  203.  
  204. Compression
  205. ===========
  206.  
  207.     The compression program (compress.exe) is used to reduce the size
  208. of distributed programs. The syntax is: compress [-r] file.ext [filenew.ext].
  209. If the -r switch is used, the second filename is not needed, as compress will
  210. automatically alter the first filename by changing the last character to an
  211. '_'. Example: compress -r install.exe; will create install.ex_ (compressed).
  212.  
  213.  
  214. Changes from version 1.2
  215. ========================
  216.  
  217.         Version 1.3 is a major upgrade. There are a quite a number of
  218. changes/enhancements from v1.2, but v1.2 .INI files are still supported.
  219. Enhancements include: many more macros, the ability to display bitmaps on the
  220. background, a message section, and much more. (Note: the current working
  221. directory for executions has been changed to the destination directory.)
  222.  
  223.  
  224. Registration
  225. ============
  226.  
  227.     EZinst is a shareware program that has a 30 day evaluation period 
  228. after which a payment of $22 is required. As shareware, EZinst was 
  229. distributed freely in order to allow people to "test drive" it. The try-
  230. before-you-buy concept allows users to find out which programs are useful
  231. before purchasing them. If a shareware program is useful or entertaining,
  232. please support it through registration. The registration fee for EZinst is
  233. only $22 and entitles you to the newest version of the program, a utility
  234. (MAKEINI) to help create INSTALL.INI files, a printed manual, customer 
  235. support (through the mail or on Compuserve, AOL, or the Internet), the source
  236. code, an unlimited distribution license, and information (and discounts) on
  237. other offerings from Burnham Park Software, Inc. To register, send your name,
  238. address, and a check or money order to:
  239.  
  240.     Burnham Park Software, Inc.
  241.     P.O. Box #814
  242.     Chicago, IL 60690-0814
  243.  
  244.     Phone: (312) 922-6313
  245.     BBS: (312) 922-2839
  246.     Compuserve: 71532,3271
  247.     AOL: Burnsoft
  248.     Internet: burnsoft@aol.com
  249.         WWW: http://execpc.com/~burnsoft
  250.  
  251.         CompuServe's SWREG #3782
  252.  
  253.     EZinst is supplied as is. The author disclaims all warranties, 
  254. expressed or implied, including, without limitation, the warranties of 
  255. merchantability and of fitness for any purpose. The author assumes no 
  256. liability for damages, direct or consequential, which may result from the use 
  257. of EZinst.
  258.  
  259.  
  260. ASP Ombusman statement
  261. ======================
  262.  
  263.     Burnham Park Software, Inc. is a member of the Association of 
  264. Shareware Professionals (ASP). ASP wants to make sure that the shareware 
  265. principle works for you. If you are unable to resolve a shareware-related 
  266. problem with an ASP member by contacting the member directly, ASP may be 
  267. able to help. The ASP Ombudsman can help you resolve a dispute or problem 
  268. with an ASP member, but does not provide technical support for members' 
  269. products. Please write to the ASP Ombudsman at 545 Grover Road, Muskegon, MI 
  270. 49442-9427 USA, FAX 616-788-2765 or send a CompuServe message via CompuServe 
  271. Mail to ASP Ombudsman 70007,3536.
  272.