home *** CD-ROM | disk | FTP | other *** search
/ PC World 1998 October / PCWorld_1998-10_cd.bin / software / prehled / inprise / JRUNTIME.Z / CHANGES.JRE < prev    next >
Text File  |  1998-05-08  |  11KB  |  276 lines
  1.                              CHANGES
  2.  
  3.                     Java(tm) Runtime Environment
  4.                           JRE(tm) 1.1.6 
  5.  
  6. -----------------------------------------------------------------------
  7. CONTENTS
  8. -----------------------------------------------------------------------
  9. This document describes the changes made between versions of the JRE. 
  10. The contents of this document are as follows:
  11.  
  12.   - Changes from JRE 1.1.5 to JRE 1.1.6
  13.   - Changes from JRE 1.1.4 to JRE 1.1.5
  14.   - Changes from JRE 1.1.3 to JRE 1.1.4
  15.   - Changes from JRE 1.1.2 to JRE 1.1.3 
  16.   - Changes from JRE 1.1.1 to JRE 1.1.2
  17.  
  18. =======================================================================
  19. CHANGES FROM JRE 1.1.5 TO JRE 1.1.6 
  20. =======================================================================
  21.  
  22. Version 1.1.6 of the Java Runtime Environment and the Java Development 
  23. Kit are maintenance releases. See the JDK CHANGES file at 
  24. http://java.sun.com/products/jdk/1.1/CHANGES or in the JDK software 
  25. download bundle for summaries of significant bugs that are fixed in 
  26. this release of the Java platform. 
  27.  
  28. The file msvcrt.dll is now required to be included in redistributions 
  29. of the Windows version of JRE 1.1.6. In previous versions, that file 
  30. was listed in the JRE README as being optionally redistributable.
  31.  
  32. The rmiregistry tool is included in version 1.1.6 of the JRE.  The 
  33. rmiregistry tool was not part of previous JRE releases.
  34.  
  35.  
  36. =======================================================================
  37. CHANGES FROM JRE 1.1.4 TO JRE 1.1.5 
  38. =======================================================================
  39.  
  40. JRE 1.1.5 and JDK 1.1.5 are maintenance releases. See the JDK CHANGES
  41. file at http://java.sun.com/products/jdk/1.1/CHANGES or in the JDK
  42. software download bundle for summaries of significant bugs that are
  43. fixed in this release of the Java platform.
  44.  
  45.  
  46. =======================================================================
  47. CHANGES FROM JRE 1.1.3 TO JRE 1.1.4 
  48. =======================================================================
  49.  
  50. JRE 1.1.4 and JDK 1.1.4 are maintenance releases. See the JDK CHANGES
  51. file at http://java.sun.com/products/jdk/1.1/CHANGES for summaries of
  52. significant bugs that are fixed in this release.
  53.  
  54. In the JRE README file, the file content-types.properties has been 
  55. moved from the list of OPTIONAL files to the list of REQUIRED files 
  56. because it is required for java.net.
  57.  
  58.  
  59. =======================================================================
  60. CHANGES FROM JRE 1.1.2 TO JRE 1.1.3 
  61. =======================================================================
  62.  
  63. JRE 1.1.3 and JDK 1.1.3 are maintenance releases. The 1.1.3 release
  64. fixes a localization bug that prevented characters in text areas of
  65. windows from displaying properly in non-English language locales and
  66. non-Western European locales. This problem did not exist in the 1.1.1
  67. release.
  68.  
  69. See the JDK CHANGES file at 
  70. http://java.sun.com/products/jdk/1.1/CHANGES
  71. for further information about other changes and bug fixes in the 1.1.3  
  72. release.
  73.  
  74. =======================================================================
  75. CHANGES FROM JRE 1.1.1 TO JRE 1.1.2
  76. =======================================================================
  77.  
  78. -----------------------------------------------------------------------
  79. End-User Installation Capability for the Win32 JRE
  80. -----------------------------------------------------------------------
  81.  
  82. When the Win32 JRE 1.1.2 is downloaded, an InstallShield script is 
  83. invoked that automates the installation of the JRE. The feature was not 
  84. present in the 1.1.1 version of the JRE. With the InstallShield script, 
  85. JRE 1.1.2 is suitable for installation by end-users. Because of this 
  86. end-user installation capability of the Win 32 JRE 1.1.2, Java 
  87. application developers have the option of not bundling the JRE with 
  88. their software. Instead, they can direct end-users to download and 
  89. install the JRE themselves.
  90.  
  91. An installer is not available for Solaris versions of the JRE. 
  92. Therefore it is recommended that Solaris application developers write 
  93. their own installers and bundle the JRE and installer with their 
  94. software.
  95.  
  96.  
  97. -----------------------------------------------------------------------
  98. Win32 JRE Available with or without Internationalization Files
  99. -----------------------------------------------------------------------
  100.  
  101. JRE 1.1.2 for Win32 is available for download in two versions, one 
  102. containing internationalization files and the other without. The 
  103. version of the JRE with the internationalization files is more than 
  104. twice the size of the version without the internationalization files. 
  105. The smaller version is made available for those end users who have no 
  106. need for internationalization capability. The files not contained in 
  107. the smaller version of the Win32 JRE are those listed in the OPTIONAL 
  108. FILES section of the JRE README file.
  109.  
  110. Solaris versions of JRE 1.1.2 include internationalization files. 
  111.  
  112.  
  113. -----------------------------------------------------------------------
  114. New jre Tool
  115. -----------------------------------------------------------------------
  116.  
  117. This section provides a summary of the new jre tool for both Win32 and 
  118. Solaris. The jre tool replaces the java tool in JRE 1.1.2. The jre tool 
  119. is similar to the java tool, but offers only those options that are 
  120. appropriate for a runtime-only system. It also provides the -cp and 
  121. -nojit options that are not part of the java tool. More detailed 
  122. documentation for the jre tool can be found on the JavaSoft web site 
  123. at:
  124.  
  125. For Solaris - 
  126. http://java.sun.com/products/jdk/1.1/docs/tooldocs/solaris/jre.html
  127.  
  128. For Windows - 
  129. http://java.sun.com/products/jdk/1.1/docs/tooldocs/win32/jre.html
  130.  
  131. Source code for the jre tool can be found in the Windows JDK 1.1.2 
  132. directory tree in the jdk1.1.2\demo\jre\win32 folder. For the 
  133. Solaris JDK 1.1.2, source code for the jre tool can be found in 
  134. the jdk1.1.2/demo/jre/solaris directory.
  135.  
  136. The jre tool invokes the Java Runtime interpreter for executing Java 
  137. applications. The tool is available in the Win32, Solaris-Sparc, and 
  138. Solaris x86 downloads of JRE 1.1.2. The syntax for the jre command is:
  139.  
  140.     jre [ options ] classname <args>
  141.  
  142. The classname argument is the name of the class file to be 
  143. executed. Any arguments to be passed to the class must be placed 
  144. after the classname on the command line.
  145.  
  146. An alternative version of the tool, jrew, is available for Win32. The 
  147. jrew command is identical to jre, except that a console window is not 
  148. invoked. The syntax of the jrew command is 
  149.  
  150.     jrew [ options ] classname <args>
  151.  
  152. On Windows platforms, the jre tool will ignore the CLASSPATH 
  153. environment variable. For both Windows and Solaris platforms, the 
  154. -cp option is recommended to specify an application's class path.
  155.  
  156. Options for the jre and the jrew commands are as follows:
  157.  
  158.    -classpath path    Specifies the path that jre uses to 
  159.                look up classes. Overrides the default 
  160.                classpath.  
  161.  
  162.    -cp path        Prepends the specified path to the default 
  163.                classpath that jre uses to look up classes. 
  164.  
  165.    -help        Print a usage message.
  166.  
  167.    -mx x        Sets the maximum size of the memory allocation 
  168.                pool (the garbage collected heap) to x. The 
  169.                default is 16 megabytes of memory. x must be
  170.             greater than or equal to 1000 bytes.
  171.  
  172.    -ms x        Sets the startup size of the memory allocation 
  173.                pool (the garbage collected heap) to x. The 
  174.                default is 1 megabyte of memory. x must be
  175.             greater than 1000 bytes.
  176.  
  177.    -noasyncgc        Turns off asynchronous garbage collection. When 
  178.                activated, no garbage collection takes place 
  179.                unless it is explicitly called or the program 
  180.             runs out of memory.
  181.  
  182.    -noclassgc        Turns off garbage collection of Java classes. 
  183.                By default, the Java interpreter reclaims space 
  184.                for unused Java classes during garbage collection.
  185.  
  186.    -nojit        Specifies that any JIT compiler should be 
  187.             ignored. The default Java interpreter is invoked.
  188.  
  189.    -ss x        The -ss option sets the maximum stack size that 
  190.                can be used by C code in a thread to x. The 
  191.             default units for x are bytes. The value of x 
  192.             must be greater than or equal to 1000 bytes.
  193.  
  194.    -oss x        The -oss option sets the maximum stack size 
  195.             that can be used by Java code in a thread to x. 
  196.             The default units for x are bytes. The value of 
  197.             x must be greater than or equal to 1000 bytes.
  198.  
  199.    -v, -verbose        Causes jre to print a message to stdout each 
  200.             time a class file is loaded.
  201.  
  202.    -verify        Performs byte-code verification on the class 
  203.             file. Beware, however, that java -verify does 
  204.             not perform a full verification in all 
  205.             situations. Any code path that is not actually 
  206.             executed by the interpreter is not verified. 
  207.             Therefore, java -verify cannot be relied upon to 
  208.             certify class files unless all code paths in 
  209.             the class file are actually run.
  210.  
  211.    -verifyremote    Runs the verifier on all code that is loaded 
  212.             into the system via a classloader. verifyremote 
  213.             is the default for the interpreter.
  214.  
  215.    -noverify        Turns verification off.
  216.  
  217.    -verbosegc        Causes the garbage collector to print out 
  218.             messages whenever it frees memory.
  219.    
  220.    -DpropName=value    Defines a property value. propName is the name 
  221.             of the property whose value you want to change 
  222.             and value is the value to change it to. For 
  223.             example, the command 
  224.             java -Dawt.button.color=green ...
  225.             sets the value of the property awt.button.color 
  226.             to "green".
  227.  
  228.  
  229. -----------------------------------------------------------------------
  230. Early-Access Release of the JRE for Solaris-x86
  231. -----------------------------------------------------------------------
  232.  
  233. An early-access release of JRE 1.1.2 for Solaris x86 is available for 
  234. download.  An FCS version of the JRE for Solaris x86 will be made 
  235. available in the future.
  236.  
  237. BECAUSE THE JRE 1.1.2 FOR SOLARIS x86 IS AN EARLY-ACCESS RELEASE ONLY,
  238. IT SHOULD NOT BE USED FOR MISSION-CRITICAL APPLICATIONS.
  239.  
  240.  
  241. -----------------------------------------------------------------------
  242. JNI Invocation API Changes
  243. -----------------------------------------------------------------------
  244.  
  245. To better support the JRE, the Invocation API is extended in JDK 1.1.2 
  246. in a few minor ways. The changes do not break any existing code. The 
  247. JNI Native Method Interface has not been changed. 
  248.  
  249. 1. The reserved0 field in the JDK1_1InitArgs structure has been
  250. renamed to "version." The JDK1_1InitArgs structure holds the
  251. initialization arguments to JNI_CreateJavaVM. Callers of 
  252. JNI_CreateJavaVM must set the version field to 0x00010001. 
  253. JNI_GetDefaultJavaVMInitArgs has been changed to return a "jint" 
  254. indicating whether the requested version is supported.
  255.  
  256. 2. The reserved1 field in the JDK1_1InitArgs structure has been
  257. renamed to "properties." This is a NULL-terminated array of 
  258. strings. Each string has the format:
  259.  
  260.             name=value
  261.  
  262. indicating a system property. (This facility corresponds to the -D
  263. option in the java command line.)
  264.  
  265. 3. In JDK 1.1.1, the thread calling DestroyJavaVM must be the only
  266. user thread in the VM. JDK 1.1.2 has lifted this restriction. If
  267. DestroyJavaVM is called when there is more than one user thread,
  268. the VM waits until the current thread is the only user thread, and
  269. then tries to destroy itself.
  270.  
  271.  
  272. -----------------------------------------------------------------------
  273. Copyright ⌐ 1997, 1998 Sun Microsystems, Inc.
  274. 901 San Antonio Road, Palo Alto, CA 94303-4900 USA
  275. All rights reserved.
  276.