home *** CD-ROM | disk | FTP | other *** search
/ PC World 1998 October / PCWorld_1998-10_cd.bin / software / prehled / inprise / JHELP.Z / Readme.txt < prev    next >
Text File  |  1998-05-08  |  7KB  |  188 lines
  1.  
  2.                              README
  3.  
  4.                    ObjectSpace JGL Version 3.1.0
  5.  
  6. -----------------------------------------------------------------------
  7. CONTENTS
  8.  
  9.  
  10.   Overview of JGL
  11.     - Welcome To JGL!
  12.     - Reporting Bugs and Requesting Features
  13.     - Contacting ObjectSpace
  14.  
  15.   Installing and Running JGL
  16.     - Installing the Microsoft Windows distribution
  17.     - Unpacking the UNIX distribution
  18.     - Environment PATH and CLASSPATH
  19.     - Compiling JGL Examples
  20.     - Installation Troubleshooting
  21.  
  22.  
  23. =======================================================================
  24.                          OVERVIEW OF JGL
  25. =======================================================================
  26.  
  27. -----------------------------------------------------------------------
  28. WELCOME TO JGL!
  29. -----------------------------------------------------------------------
  30. All Java programmers need a library of reusable data structures. The 
  31. Java Developer's Kit (JDK) only contains three data structures - a 
  32. Vector, a Stack, and a Hashtable - which is hardly sufficient for 
  33. serious software development. In addition, the JDK does not include 
  34. algorithms for sorting, filtering, and other common tasks.  JGL was 
  35. created by ObjectSpace to address these concerns.
  36.  
  37. JGL includes highly optimized data structures such as sequences, maps, 
  38. sets, queues, and a stack.  There are over 40 reusable algorithms that
  39. work with the JGL containers, the JDK containers, and native Java arrays.  
  40. With complete HTML API documentation and a comprehensive HTML user guide 
  41. packed with over 100 examples, JGL is very easy to learn and use.
  42.  
  43.  
  44. -----------------------------------------------------------------------
  45. REPORTING BUGS AND REQUESTING FEATURES
  46. -----------------------------------------------------------------------
  47. Please report bugs and feature requests to
  48.  
  49.     jgl@objectspace.com
  50.  
  51. Visit the ObjectSpace web site at http://www.objectspace.com/jgl for
  52. the most recent information.
  53.  
  54.  
  55. -----------------------------------------------------------------------
  56. CONTACT INFORMATION
  57. -----------------------------------------------------------------------
  58. For additional information on ObjectSpace technology and services, 
  59. contact our North American headquarters.
  60.  
  61. ObjectSpace, Inc.
  62. 14881 Quorum Dr. Suite 400
  63. Dallas, TX 75240
  64.  
  65. Phone:  972.726.4100 or 1.800.OBJECT.1
  66. Fax:    972.715.9099
  67.  
  68. E-Mail: info@objectspace.com
  69. WWW:    http://www.objectspace.com
  70.  
  71.  
  72. =======================================================================
  73.                     INSTALLING AND RUNNING JGL
  74. =======================================================================
  75.  
  76.     IMPORTANT: Please make sure you understand the Copyright
  77.     and License information (in the files named COPYRIGHT.TXT and 
  78.     LICENSE.TXT) before installing this release.
  79.  
  80. The JGL release version 3.1.0 requires a JDK 1.1 compliant Java 
  81. distribution.  It will not function with a JDK 1.0 distribution.
  82. Features new to the JDK 1.1 specification are necessary for JGL.
  83.  
  84. The Voyager extensions require ObjectSpace Voyager 2.0 or later because
  85. of the package names.
  86.  
  87. -----------------------------------------------------------------------
  88. INSTALLING THE MICROSOFT WINDOWS DISTRIBUTION
  89. -----------------------------------------------------------------------
  90. Execute the InstallShield executable which will perform the
  91. installation and unpack the distribution.  It will query for needed
  92. information such as the installation root directory.
  93.  
  94. WIN95 Specific
  95. --------------
  96. Note that the installation will ask whether or not the AUTOEXEC.BAT
  97. file should be modified.  The modifications consist of adding entries
  98. to the CLASSPATH environment variable.  This modification
  99. does not have to be done through InstallShield.  It may be done
  100. manually to the AUTOEXEC.BAT file.  After making changes to the 
  101. AUTOEXEC.BAT file, you must reboot your computer to have the changes
  102. take effect.
  103.  
  104.  
  105. WINNT Specific
  106. --------------
  107. Under Microsoft Windows NT, the InstallShield program modifies the 
  108. HKEY_CURRENT_USER\Environment strings for the CLASSPATH variable.  It 
  109. is not necessary to reboot the system after these changes are done,
  110. but you will need to exit and restart any running programs 
  111. (including MS-DOS windows) to have the settings take effect.
  112.  
  113.  
  114. -----------------------------------------------------------------------
  115. UNPACKING THE UNIX DISTRIBUTION
  116. -----------------------------------------------------------------------
  117.  
  118. First, unpack one of
  119.  
  120.     jgl3.1.0.tar.Z
  121.     jgl3.1.0.tar.gz
  122.  
  123. into a chosen installation root directory.  This directory is
  124. subsequently referred to as $(INSTALLATION_ROOT).
  125.  
  126. ______
  127. .tar.Z
  128.  
  129. To unpack the .tar.Z distribution, place the file
  130.  
  131.     jgl3.1.0.tar.Z
  132.  
  133. in the directory $(INSTALLATION_ROOT).  Then type
  134.  
  135.     cd $(INSTALLATION_ROOT)
  136.     uncompress jgl3.1.0.tar.Z
  137.     tar xvf jgl3.1.0.tar
  138.  
  139. ______
  140. tar.gz
  141.  
  142. To unpack the .tar.gz distribution, place the file
  143.  
  144.     jgl3.1.0.tar.gz
  145.  
  146. in the directory $(INSTALLATION_ROOT).  Then type
  147.  
  148.     cd $(INSTALLATION_ROOT)
  149.     gunzip jgl3.1.0.tar.gz
  150.     tar xvf jgl3.1.0.tar
  151.  
  152. If there are problems with gunzip, try using
  153.  
  154.     gzip -d jgl3.1.0.tar.gz
  155.  
  156.  
  157. Second, the CLASSPATH environment variable must be modified as detailed 
  158. below.  The particular dot file to be modified is dependent on the 
  159. particular version of UNIX in use.  It may be one of .profile, .cshrc, 
  160. .bashrc or .mycshrc.  The environment command may be one of set, export, 
  161. or setenv.
  162.  
  163.  
  164. -----------------------------------------------------------------------
  165. ENVIRONMENT CLASSPATH for Windows and UNIX
  166. -----------------------------------------------------------------------
  167.  
  168. The CLASSPATH environment variable must include the following entry:
  169.  
  170.     $(INSTALLATION_ROOT)/lib/jgl3.1.0.jar
  171.  
  172. $(INSTALLATION_ROOT) is the directory where the JGL release is
  173. installed and unpacked.  The separator "/" should be "\" on Microsoft 
  174. Windows.  
  175.  
  176.  
  177. -----------------------------------------------------------------------
  178. COMPILING JGL EXAMPLES
  179. -----------------------------------------------------------------------
  180.  
  181. Example Java applications and applets using JGL are under directory
  182. $(INSTALLATION_ROOT)/examples.  The examples are not in any particular
  183. package, so the current directory (".") should be on the CLASSPATH as
  184. well for these to execute.
  185.  
  186. -----------------------------------------------------------------------
  187. Copyright (c) 1996,1997 ObjectSpace, Inc.
  188.