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