home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / BUSINESS / VEND15.ZIP / VEND.DOC < prev   
Text File  |  1994-01-16  |  11KB  |  272 lines
  1.  
  2.               The Vending Machine
  3.                   Version 1.5
  4.               Written & Published
  5.                  By:
  6.              Lincoln Beach Software
  7.               Copyright (c) 1993,1994
  8.               All Rights Reserved
  9.  
  10.            _______
  11.           ____|__     |               (tm)
  12.        --|       |    |-------------------
  13.          |   ____|__  |  Association of
  14.          |  |       |_|  Shareware
  15.          |__|   o   |    Professionals
  16.        -----|   |   |---------------------
  17.         |___|___|    MEMBER
  18.  
  19.  
  20.  
  21.                LIABILITY WAIVER
  22.  
  23. THE VENDING MACHINE IS LICENSED "AS-IS".  LINCOLN BEACH SOFTWARE MAKES NO
  24. WARRANTIES, EITHER EXPRESSED OR IMPLIED, WITH RESPECT TO THIS PROGRAM,
  25. ITS QUALITY, PERFORMANCE, MERCHANTABILITY, OR FITNESS FOR ANY
  26. PARTICULAR PURPOSE.  IN PARTICULAR IT IS NOT GUARANTEED TO PREVENT OR
  27. DETECT DAMAGE TO YOUR DATA OR PROGRAMS.  IN NO EVENT SHALL LINCOLN
  28. BEACH SOFTWARE BE LIABLE FOR ANY CLAIMS FOR LOST PROFITS OR ANY
  29. DAMAGE, INCLUDING, BUT NOT LIMITED TO, SPECIAL, INCIDENTAL,
  30. CONSEQUENTIAL OR OTHER DAMAGE.  SOME STATES DO NOT ALLOW THE EXCLUSION
  31. OR LIMITATION OF INCIDENTAL OR CONSEQUENTIAL DAMAGES, SO THE ABOVE
  32. LIMITATION OR EXCLUSION MAY NOT APPLY TO YOU.  IN NO CASE SHALL
  33. LINCOLN BEACH SOFTWARE'S LIABILITY EXCEED THE LICENSE FEES PAID FOR
  34. THE RIGHT TO USE THE LICENSED SOFTWARE.  THE LICENSE AGREEMENT AND
  35. WARRANTY SHALL BE CONSTRUED, INTERPRETED AND GOVERNED BY THE LAWS OF
  36. THE STATE OF MISSOURI.
  37.  
  38.            COPYRIGHT, SUPPORT AND SHAREWARE
  39.                    STATEMENT
  40. THE VENDING MACHINE is a "shareware program" and is provided at no charge
  41. to the user for evaluation.  Feel free to share it with your friends,
  42. but please do not give it away altered or as part of another system.
  43. The essence of "user-supported" software is to provide personal
  44. computer users with quality software without high prices, and yet to
  45. provide incentive for programmers to continue to develop new products. 
  46. If you find this program useful and find that you are using THE VENDING
  47. MACHINE and continue to use THE VENDING MACHINE after a trial period
  48. not to exceed 30 days, you must make a registration payment of $50 to
  49. LINCOLN BEACH SOFTWARE.  The $50 registration fee will license one
  50. copy for use on any one computer at any one time.  You must treat this
  51. software just like a book.  An example is that this software may be
  52. used by any number of people and may be freely moved from one computer
  53. location to another, so long as there is no possibility of it being
  54. used at one location while it's being used at another.  Just as a book
  55. cannot be read by two different persons at the same time.  Also
  56. installation procedures may be developed solely for the company it is
  57. licensed to.  You may not develop installations for other firms.
  58.  
  59. Corporate users of THE VENDING MACHINE must register and pay for their
  60. copies by departments and site-License arrangements may be made by
  61. contacting LINCOLN BEACH SOFTWARE.
  62.  
  63. You are encouraged to pass a copy of THE VENDING MACHINE along to your
  64. friends for evaluation.  Please encourage them to register their copy
  65. if they find that they can use it.  All registered users will receive
  66. a copy of the latest version of the THE VENDING MACHINE system.
  67.  
  68. This software and documentation is protected under the United States
  69. Copyright Laws and International Treaty Provisions.  Your support of
  70. Shareware is appreciated.
  71.  
  72. You may call 314-861-1500 or write to us at: Lincoln Beach Software,
  73. P.O. Box 1554, Ballwin, MO 63022-1554 if you have any questions.  If
  74. no one is there to personally answer your call, leave a message and we
  75. will get back to you ASAP.  You may also send questions to me on
  76. CompuServe by directing your mail to:  Harold Holmes, CompuServe ID:
  77. 70700,630.
  78.  
  79.                  OMBUDSMAN STATEMENT
  80.  
  81. The Vending Machine is produced by Lincoln Beach Software, a member of the
  82. Association of Shareware Professionals (ASP).  The ASP wants to make sure
  83. the shareware principle works for you.  If you are unable to resolve a
  84. shareware-related problem with an ASP member by contacting the member
  85. directly, the ASP may be able to help.  The ASP Ombudsman can help you
  86. resolve a dispute or problem with an ASP member, but does not provide
  87. technical support for members' products.  Please write to the ASP Ombudsman
  88. at: 545 Grover  Road, Muskegon, MI 49442 or send a CompuServe message via
  89. CompuServe Mail to: ASP Ombudsman, 70007,3536.
  90.  
  91.  
  92.               PLEA FOR FREE ADVERTISEMENT
  93.  
  94. It would be greatly appreciated if you would put the following
  95. paragraph into your documentation.  However, it is not required.
  96.  
  97. THE INSTALLATION PROGRAM USED BY <your company or program name> WAS
  98. WRITTEN BY LINCOLN BEACH SOFTWARE AND IS ENTITLED THE VENDING MACHINE.
  99. LINCOLN BEACH SOFTWARE RESERVES ALL COPYRIGHT PROTECTION WORLDWIDE.
  100. FOR FURTHER INFORMATION THEY MAY BE REACHED AT P.O. BOX 1554, BALLWIN,
  101. MO 63022 OR 314-861-1500.  HAROLD HOLMES MAY ALSO BE REACHED ON
  102. COMPUSERVE AT 70700,630.
  103.  
  104.               INTRODUCTION
  105.  
  106. Lincoln Beach Software is the publisher of First Impression, a very successful
  107. installation toolkit for developers.  While working on this project several
  108. vendors have asked about modified versions for their distribution means.
  109. After much thought about how to design it so that it would be extremely
  110. easy for vendors to set up, the design has been implemented.
  111.  
  112. Disk Vendors need only to create two text files.  The first is the text
  113. that the end users will read when running the install.  Since you will
  114. probably say the same thing on most of your disks only one file will need
  115. to be created and this can be copied to every disk in the library.  The
  116. second file will be a brief description of the file and on the line below
  117. will be the name of the compressed file for that description.  The formats
  118. for the files are discussed below in greater detail.
  119.  
  120. The first thing that the user sees will be your greeting screen.  After
  121. pressing a key a smaller window will appear where you can put instructions
  122. or help and then a menu will appear with the descriptions of the files.
  123. Your users can scroll through the list and pick and choose which programs
  124. to install.  When they are finished they can press escape and will go back
  125. to the DOS prompt.
  126.  
  127.                 FILE LAYOUT
  128.  
  129. The first file is titled INSTALL.TXT.  It contains the text for the two
  130. windows mentioned above along with the color scheme and compression program
  131. that you are using.  The very first line must contain the compression
  132. program that you are going to utilitize along with the overwrite option.  If
  133. you are going to use self extracting files and want to use the overwrite
  134. option the first line should contain:   SE=/o    (SE stands for self extract-
  135. ing option.)  If you do not wish to use an overwrite switch you must still
  136. enter on the line SE=     followed by a blank space.  This way The Vending
  137. Machine knows what you are planning on using for uncompressing the files.
  138.  
  139. Persons running ANSI.SYS will see the uncompression progress but those not
  140. will be oblivious to the prompt "File exists, uncompress anyway?<Y/N>" and
  141. it will appear that the program has locked up.  If self extracting files are
  142. used then no compression name will need to appear.  Just the SE option
  143. mentioned above.
  144.  
  145. The next things will be the color scheme for the windows that will appear.
  146. You may set those by using the commands BACKGROUND, WINDOW & BORDER.  With
  147. the background you only need one color.  In the example it is CYAN so it
  148. would appear:   BACKGROUND=CYAN,CYAN   If no BACKGROUND is selected CYAN is
  149. the default.
  150.  
  151. pkunzip /o             ;Must be on first line
  152. WINDOW=YELLOW,BRRED    ;Window attributes
  153. BORDER=BRWHITE,BRRED   ;Border attributes
  154. BACKGROUND=CYAN,CYAN   ;Background attributes
  155. TITLE=Lincoln Beach Software ; Registered Version Only
  156.  
  157.  
  158.  
  159. VGA     ;sets the install to use special border characters
  160.  
  161. NOBLINK ;allows the brighter colors to be uses as forground colors
  162.     ;Note: If you set a foreground color to a bright color and the
  163.     ;user does not have a VGA monitor the color will be dropped to
  164.     ;its dimmer color.
  165.  
  166. SHADOW  ;puts shadows on all the windows.
  167.  
  168.  
  169. To use the WINDOW & BORDER function you must enter a foreground and a
  170. background color with the foreground color appearing first and would
  171. appear like:
  172.         WINDOW=BLUE,YELLOW
  173.         BORDER=BLUE,BRWHITE
  174.  
  175. These colors are the default settings if none are entered. After your
  176. color settings you need to enter an asterick '*' to seperate this section
  177. of the file from the text that will appear in the windows.  Note that You
  178. must put in the equal sign in the statements.
  179.  
  180. In the first window, the greeting window, you are allowed 20 lines of text
  181. that can be up to 68 characters long.  Each line is left justified on the
  182. row.  If you wish to center a line, the last character on the line must be
  183. a carat '^'.  This will center this row only.  When you are finished with
  184. this window you must have a new line with an asterick in the first position
  185. as before.
  186.  
  187. The next window can be used for instructions as shown with the demo .TXT
  188. file.  It is only six lines long and 66 character wide.
  189.  
  190. Sample TXT file:
  191.  
  192. SE= /o
  193. VGA
  194. SHADOW
  195. BORDER=RED,BRWHITE
  196. WINDOW=RED,YELLOW
  197. *  <--------------Note the asterick in the first position on the line
  198. ACME DISK VENDORS
  199.  
  200. Introducing Quality Software Around The World!
  201.  
  202. Thank you for using our services...
  203. ...
  204. ...
  205. *  <--------------Note the second asterick in the first position on the line
  206. Arrow to the selection of your choice and press enter.
  207. Then select the drive you wish to install from/to and the
  208. subdirectory as well.
  209.  
  210. OR:
  211.  
  212. pkunzip /o   <----must be on the first line of the file
  213. NOBLINK
  214. BORDER=BRRED,WHITE
  215. WINDOW=BRRED,YELLOW
  216. *  <--------------Note the asterick in the first position on the line
  217. ACME DISK VENDORS
  218.  
  219. Introducing Quality Software Around The World!
  220.  
  221. Thank you for using our services...
  222. ...
  223. ...
  224.  
  225.  
  226. The text after the second asterick will appear on the second window.
  227.  
  228. The colors are as follows:
  229.  
  230.  Background/Foreground   Foreground
  231.  
  232.     BLACK              DKGRAY
  233.     BLUE               BRBLUE
  234.     GREEN              BRGREEN
  235.     CYAN               BRCYAN
  236.     RED                BRRED
  237.     MAGENTA            BRMAGENTA
  238.     BROWN              YELLOW
  239.     WHITE              BRWHITE
  240.  
  241. The second file contains the file description along with the file name.  It
  242. will need to appear like:
  243.  
  244. First Impression 2.6 - Installation Toolkit For developers.
  245. impress.zip
  246. impress.doc
  247. The Vending Machine 1.5 Installation Toolkit For Disk Vendors.
  248. vendmach.zip
  249. vend.doc
  250. ...
  251. ...
  252.  
  253. Up to ten files may be entered per disk.  The window that will appear with
  254. these selections will grow to the size of the longest description which may
  255. be up to 60 characters long.  It will also horizontally center itself on the
  256. screen.
  257.  
  258. If a file is selected from the menu but does not appear on the floppy the user
  259. will receive the message regarding this and is asked to insert the correct
  260. disk and to try again.
  261.  
  262.                DATA ENCRYPTION
  263.  
  264. Nobody wants their hard work to be easily duplicated so in version 1.5 we
  265. have added the ability to combine the two files and encrypt the data into
  266. one file called INSTALL.CFG.  You need to create the two files mentioned
  267. above, INSTALL.FIL & INSTALL.TXT and then run ENCRYPT.EXE.  Copy the
  268. INSTALL.EXE & INSTALL.CFG and all other files to your diskette and all the
  269. user needs to do is run the install.
  270.  
  271.  
  272.