home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: Java / Java.zip / jinst101.zip / readme.1st < prev   
Encoding:
Text File  |  1998-06-15  |  7.5 KB  |  210 lines
  1. ┌────────────────────────────────────────────────────────────────────────────┐
  2. │                                                                            │
  3. │                                                                            │
  4. │                                THE JAVAWORKS                               │
  5. │                                                                            │
  6. │                               Matthias Schorer                             │
  7. │                     333/464 Bangna Place, Sanpawuth Road                   │
  8. │                           Prakanong, Bangkok 10260                         │
  9. │                                   THAILAND                                 │
  10. │                                                                            │
  11. │                                                                            │
  12. │                          DESCRIPTION: Universal Java Install Program       │
  13. │                              VERSION: 1.00                                 │
  14. │                                                                            │
  15. │ Copyright (c) 1998:  Matthias Schorer  matze@inorbit.com                   │
  16. │                                        http://members.tripod.com/~javaworks│
  17. │                                                                            │
  18. │ Permission to use, copy, modify, and distribute this software and          │
  19. │ its documentation for commercial or non-commercial purposes                │
  20. │ is hereby granted provided that this copyright notice                      │
  21. │ appears in all copies.                                                     │
  22. └────────────────────────────────────────────────────────────────────────────┘
  23.  
  24.  
  25. System requirements
  26. ===================
  27.  
  28. An operating system with a JAVA virtual machine version 1.1.1 or newer
  29. either as runtime or jdk (java developers kit).
  30.  
  31. Memory: 16 MB RAM
  32. CPU:    At least 486 130 MHz
  33.  
  34. If you don't have JAVA, then get it from
  35.  
  36.    "http://java.sun.com" (for windows)
  37.  
  38. or
  39.    "http://service.boulder.ibm.com   (for OS/2)
  40.  
  41. This is a JAVA program NOT an applet ! Therefore it will NOT run in
  42. a web browser.
  43.  
  44.  
  45.  
  46. Included files
  47. ==============
  48. readme.1st            The file you are reading now
  49. JavaInstaller100.zip  The installer program and the demo files. Please unpack
  50.   ------------------- only needed for the demo ------------
  51.   disk.1              Disk ID file for demo package
  52.   disk.2                          "
  53.   disk.3                          "
  54.  
  55.   inst01.zip          Archive for demo files, do not unzip !
  56.   inst02.zip                      "
  57.   inst03.zip                      "
  58.   inst04.zip                      "
  59.   inst05.zip                      "
  60.  
  61.   system.zip          demo system archive, do not unzip !
  62.  
  63.   licence             demo licence file
  64.   logo.gif            demo logo
  65.  
  66.   ------------ this are the real program components -----------
  67.   read.me             readme file
  68.   install.bat         Startbatch for Windows
  69.   install.cfg         Configuration File for installer
  70.   install.cmd         Startbatch for OS/2
  71.   install.zip         Classlibrary for Installer, do not unzip !
  72.   --------------------------------------------------------------
  73.  
  74.  
  75. Installation
  76. ============
  77. Unzip all the files into as subdirectory of your choice.
  78.  
  79. Change to the directory and type Install. This will start a typical
  80. installation routine which we all are so familiar with.
  81.  
  82. Note: There might be a message - "file not found" this is normal,
  83.       please ignore it.
  84.  
  85.  
  86.  
  87. What does the Javainstaller do ?
  88. ================================
  89.  
  90. Java is a very powerfull and easy programming tool. But once you have
  91. finished your program and you want to distribute it to other people, that's
  92. when the real problems start ! Many users don't know how to use Java, nor
  93. are they able to go to a DOS prompt and type unzip - That's what all the
  94. GUIs have brought us ;-)
  95.  
  96. I was bored with telling people over and over again how to unzip files,
  97. how to set the classpath etc.
  98.  
  99. THATS WHEN I DECIDED TO WRITE THIS INSTALLER.
  100.  
  101. It resembles the install programs found in OS/2 and windows. BUT it is
  102. fully configurable via a .cfg file.
  103.  
  104. Some of the highlights:
  105.    licence text display
  106.    readme text display
  107.    logo display
  108.    packages can be selected for installation
  109.    Can install packages distributed on multiple diskettes
  110.    Can install packages distributed on CD / single diskette
  111.    Checks before installation whether a newer version is installed
  112.    Prompts before overwriting existing directories / files
  113.  
  114.  
  115. Only the following files are needed to build
  116. a full install package:
  117.  
  118.   read.me             readme file
  119.   disk.1              At least one disk.ID file must exist
  120.                       create it with any "old" editor - file can be empty.
  121.  
  122.   install.bat         Startbatch for Windows
  123.   install.cmd         Startbatch for OS/2
  124.   install.cfg         Configuration File for installer
  125.   install.zip         Classlibrary for Installer, do not unzip !
  126.  
  127.   ????.zip            one or more zip files containing your program
  128.                       and required directory structure.
  129.  
  130.   ! The are optional files !
  131.   --------------------------
  132.   licence             Simple Text file. If it exists its content
  133.                       will be displayed before the installation starts.
  134.  
  135.   logo.gif            Can be your logo (must be called logo.gif),
  136.                       otherwise use the Java Logo
  137.  
  138.  
  139.  
  140. Here's how to configure the installer (content of install.cfg)
  141. ==============================================================
  142.  
  143. !! Note, keywords must be written big !!
  144.  
  145. TITLE: Universal Java Installer  //  The title of your application
  146. VERSION: 1.00                    //  The version of your application
  147. DEFAULTINST: C:\MyProg           //  The default installation location
  148. NUMDISKS: 3                      //  Number of diskettes needed
  149.  
  150.  
  151. // include this label for files which have to be installed
  152. // e.g. your shared class libraries. Can be ommitted.
  153. SYSTEM:  System Kernel, DISK.1:SYSTEM.ZIP
  154.  
  155. // List of one or more products to be installed.
  156. // At least ONE entry must be contained in the .cfg file !
  157. // Per product one line.
  158. // Format: PRODUCT: <Product name>, <disk id file:zip archive>[,<disk id:zip archive>] etc...
  159.  
  160. PRODUCT: Product1, DISK.1:INST01.ZIP, DISK.1:INST02.ZIP
  161. PRODUCT: Product2, DISK.2:INST03.ZIP, DISK.3:INST04.ZIP
  162. PRODUCT: Product3, DISK.3:INST05.ZIP
  163.  
  164.  
  165. Note: // comments are not allowed in the real install.cfg file !
  166.  
  167. That's it - straight forward.
  168.  
  169. Hope this makes it easier to distribute your great Java programs to the masses !
  170.  
  171.  
  172. How to solve problems
  173. =====================
  174.  
  175. Problems ??!! Which problems ?
  176.  
  177. Display the console window it shows pretty detailed messages when
  178. something goes wrong.
  179.  
  180. For bug reports mail me at:  matze@inorbit.com
  181.                              http://members.tripod.com/~javaworks
  182.  
  183. or snail mail: Matthias Schorer
  184.                Burgmairstr 2
  185.                80686 Munich / Germany
  186.  
  187.                Tel: +49 89 5796 7923
  188.                Fax: +49 90 5796 7925
  189.  
  190. Change History
  191. ==============
  192. 1.00 First Release
  193.  
  194. 1.01 Improvement to allow installs without system components
  195.      (Thanks to John B. Abela <fcmwd@arcata.com> for the hint !)
  196.  
  197.  
  198.  
  199. In the make
  200. ===========
  201. I am working on an uninstaller to go with the install package.
  202.  
  203.  
  204.  
  205. Disclaimer
  206. ==========
  207.  
  208. This software is provided as is. I do not take any responsibility whatsoever,
  209. for damage this software or its use might cause.
  210.