home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: Java / Java.zip / 1b1-awt.zip / readme.ibm < prev   
Text File  |  1996-02-29  |  11KB  |  280 lines
  1.  
  2.  
  3. IBM OS/2 Java Developer's Kit 1.0 beta 1 Release Notes 22th February 1996
  4. =========================================================================
  5.  
  6. (c) Copyright Sun Microsystems Inc, 1992-1995. All rights reserved.
  7. (c) Copyright IBM Corporation, 1996. All rights reserved.
  8.  
  9. This port is based in part on the work of the Independent JPEG group.
  10.  
  11. US Govt Users Restricted Rights - Use duplication or disclosure restricted by
  12. GSA ADP Schedule Contract with IBM Corp.
  13.  
  14. Java and the Java compatibility logo are trademarks of Sun Microsystems, Inc.
  15.  
  16. Mike Cowlishaw, Andrew Johnson & Matthew Vaughton, IBM Hursley, United Kingdom.
  17.  
  18.  
  19. Introduction
  20. ------------
  21.  
  22. The current Java for OS/2 distribution is (deliberately) a copy of the beta
  23. distribution for Windows NT except, of course, for the platform-dependent
  24. binaries. You will see Sun copyright notices, etc.; these will be updated
  25. later.
  26.  
  27. The current beta inevitably has some problems and restrictions. Image support
  28. is now included although from time to time traps may be experienced...
  29.  
  30. 29th February update...
  31. NOTE. The AWT image support is only for 256 colour systems at the moment. We
  32. are now putting all our effort into 1.0 AWT support.
  33.  
  34. There is not yet a beta version of the Hotjava browser available.
  35.  
  36.  
  37. Installation instructions
  38. -------------------------
  39.  
  40. --- You need ---
  41.  
  42.   OS/2 2.x or Warp  -- Warp is recommended, and is required for audio
  43.                        [we have not tested on 2.x recently, but it
  44.                        should work]
  45.   an HPFS disk      -- with at least 15MB free space
  46.                        [Long name support is currently *required* for Java]
  47.   JAVAOS2.ZIP       -- the Java for OS/2 package
  48.   UNZIP.EXE         -- Infozip's version 5.12, August 1994, or later or an
  49.                        equivalent unzip tool
  50.   TCP/IP            -- either Warp IAK or TCP/IP 2.0+
  51.   Hardware          -- a 486-class machine with 12MB+ RAM is recommended
  52.  
  53. --- Installation procedure ---
  54.  
  55.   1. Copy the file you downloaded to the root directory of your chosen
  56.      disk, using the name JAVAOS2.ZIP
  57.  
  58.   2. Unzip the ZIP file, using InfoZip's UNZIP program, for example:
  59.  
  60.        unzip javaos2
  61.  
  62.      Warning: if you are not using Infozip, you may need to specify a -d
  63.               flag for subdirectories to be created.  Check your UNZIP
  64.               program's documentation.
  65.  
  66.      This should create a JAVAOS2 directory, with the following subdirectory
  67.      trees, containing the Java interpreter, compiler & tools:
  68.  
  69.        applet   -- Applet viewer output directory
  70.        bin      -- Java .EXE files
  71.        classes  -- Tree with compiled Java programs (.CLASS files).  Note
  72.                    that Java requires that this directory be a sibling of
  73.                    the BIN directory.
  74.        demo     -- Demonstration applets, images, audio clips, etc
  75.        dll      -- .DLL files for the Java interpreter and native classes
  76.        include  -- Include files for building native classes
  77.        lib      -- .LIB files and Java property files
  78.        src      -- Java source code for a subset of the classes
  79.        .hotjava -- Directory for network property files
  80.  
  81.   3. Edit your CONFIG.SYS file:
  82.  
  83.        o Add the DLL [eg, E:\javaos2\dll] directory to LIBPATH [required]
  84.  
  85.        o Add the BIN [eg, E:\javaos2\bin] directory to SET PATH [recommended]
  86.  
  87.      Reboot (if you had to do either of these).
  88.  
  89.   4. To check installation, change directory to javaos2\demo\hello, then:
  90.  
  91.        o  Enter the command
  92.  
  93.             java hello
  94.  
  95.           This runs (interprets bytecodes from) the 'hello.class' file.
  96.  
  97.        o  Enter the command
  98.  
  99.             javac hello.java
  100.  
  101.           This runs (interprets bytecodes for) the Java Compiler, to compile
  102.           the file 'hello.java' to make 'hello.class'.  Note that many Java
  103.           commands have case-sensitive arguments.
  104.  
  105.           You can then issue the command
  106.  
  107.             java hello
  108.  
  109.           again to check the hello.class file you just built.
  110.  
  111.      Note: As with the other Java packages, you must specify '.java' on
  112.            the filename on JAVAC, and must *not* specify '.class' on JAVA
  113.            (since it looks for a class, not specifically a file).
  114.  
  115.      If you added the JAVAOS2\BIN directory to your path, the JAVA and JAVAC
  116.      commands should work in any directory.
  117.  
  118.      Note: Java will use the JAVAOS2 directory as its home directory.  To
  119.            use a different one, set the HOME environment variable (for
  120.            example, SET HOME=C:\home  [note no trailing '\']).  The home
  121.            directory must be on an HPFS disk.
  122.  
  123.   5. In the beta distribution, the HotJava browser is replaced by an
  124.      applet viewer; to run one of the demo applets, change directory
  125.      to one of the javaos2\demo subdirectories, then:
  126.  
  127.        o  Enter the command:
  128.  
  129.             start applet example1.html
  130.  
  131.           [This processes the HTML file specified, and runs the applet
  132.            referenced in that document.]
  133.  
  134.      Note: The applet viewer needs a "Home directory" (represented in
  135.            some path names by the character '~') to save properties and
  136.            a log of standard out messages.  You can specify the home
  137.            directory with an environment variable set using the command
  138.            such as SET JAVA_HOME=C:\home  [no trailing '\']. If this has
  139.            not been specified when the viewer starts, it will attempt to
  140.            use the javaos2\applet directory.  The home directory must be
  141.            on an HPFS disk.
  142.  
  143. General Notes
  144. -------------
  145.  
  146.   1. This package is a copy of the Sun Java release for Windows NT
  147.      (1beta1), with the exception of the BIN, DLL, INCLUDE\OS2, and LIB
  148.      directories, this file, and certain network defaults.  We have not
  149.      attempted to update the documentation or notices for OS/2 yet.
  150.  
  151.   2. The package includes the Java interpreter, compiler, debugger, and
  152.      other tools, and the network, windowing, applet, agent, and audio
  153.      classes.
  154.  
  155.      Audio supports AudioStreams to either 8-bit or 16-bit sound cards,
  156.      at either 8000 or 11025 samples per second.
  157.  
  158.   3. The entire package should be considered 'untested'.
  159.  
  160.   4. This package is for evaluation and testing; we are not formally
  161.      supporting it, yet, though we would like to hear of any problems
  162.      that seem OS/2-related.
  163.  
  164.   5. All the binaries come in two forms.  Those with suffix '_g' on the
  165.      name are compiled and linked with debugging information. DLL names
  166.      must match the .EXE names in use (that is, JAVA_G.EXE links to
  167.      JAVA_G.DLL and NET_G.DLL but would not link to NET.DLL).
  168.  
  169.   6. Although LIB and INCLUDE files are provided for building native
  170.      classes, it is likely that there is insufficient information
  171.      available to do this (and some headers may be missing) -- see Sun
  172.      documentation and mailing lists.  We have noticed some errors in
  173.      the Sun documentation in this area.
  174.  
  175.   7. If you see problems, try running the interpreter with the -diag
  176.      (for OS/2-specific), -verbose, and -verbosegc options. The
  177.      diagnostic information produced may be helpful.
  178.  
  179.   8. We've added some new environment variable settings that let you
  180.      adjust some Java defaults (note that if you issue these commands
  181.      from an OS/2 command prompt, you must not have any spaces before
  182.      the '='):
  183.  
  184.      SET JAVA_CONNECT_TIMEOUT=n
  185.  
  186.       o adjusts the time that Java will wait for a network connection
  187.         before it reports a timeout.  'n' is in seconds, from 1 through
  188.         a million (default=30).
  189.  
  190.      SET JAVA_AUDIO_VOLUME=v
  191.  
  192.       o adjusts audio volume from Java as a percentage of the maximum.
  193.         'v' may take the values 0 through 100 (default=50).
  194.  
  195.      SET JAVA_AUDIO_RATE=n
  196.  
  197.       o sets the preferred playback sample rate for audio.  Use a value
  198.         of 8 for 8000 samples per second, or 11 for 11025 samples per
  199.         second.  Java for OS/2 will normally try 8000 first (to match the
  200.         incoming data stream) and then 11025; some drivers (notably some
  201.         Thinkpad 701C early drivers prior to October 1995) appear to
  202.         support 8000 but then fail: they can be made to work by forcing
  203.         the rate to 11.
  204.  
  205.  
  206. Known restrictions and problems
  207. -------------------------------
  208.  
  209.   1. OS/2 machine-dependent layer:
  210.  
  211.       o Not all floating point operations are handled correctly yet.
  212.  
  213.       o Garbage collection will fail if an I/O operation (for example,
  214.         disk I/O, but not TCP/IP, AWT, or audio I/O) prevents a thread
  215.         from suspending for more than 5 seconds.  A message 'thread X
  216.         failed to suspend' may be followed by unpredictable behaviour.
  217.         This will only be seen if garbage collection is attempted.
  218.  
  219.         An alternative Garbage collection environment is being
  220.         investigated.
  221.  
  222.   2. Audio (MMEDIA) native class:
  223.  
  224.       o Audio support requires Warp (the device will not open under 2.x).
  225.         This is a permanent restriction.  Audio sharing may be unreliable
  226.         with some older sound cards and drivers.
  227.  
  228.       o Java audio is streaming .. that is, it can be played as it arrives
  229.         across a network.  Performance, bandwidth, or latency problems may
  230.         therefore cause breakup and affect sound quality.
  231.  
  232.   3. Sun code:
  233.  
  234.       o Sun have documented a number of problems in the shared code;
  235.         these will still be present.  We have not attempted to debug or
  236.         upgrade the 'shared' code except where essential to build the
  237.         package.
  238.  
  239.       o Audio support is internally monaural 8-bit U-law only.  There is
  240.         no recording capability at present.
  241.  
  242.   4. JDB (debugger) does not work reliably at the moment.
  243.  
  244.   5. Temporarily only one instance of Java may be run at a time.
  245.  
  246.  
  247. IBM Java mailing lists
  248. ----------------------
  249.  
  250. IBM would like to hear about all problems and learn from your experiences with
  251. this beta. Mailing lists have been set up to discuss Java for OS/2 and more
  252. general Java issues.
  253.  
  254. In order to download this package you were required to register with IBM's
  255. java beta development programme. This means that you have been automatically
  256. subscribed to the following mailing list:
  257.  
  258.      ibm-java-announce@hursley.ibm.com
  259.  
  260.         Announcements & latest news from IBM's Java team
  261.  
  262. You cannot post to this list, and should only get two or three items of
  263. e-mail from it in a typical month.
  264.  
  265. You may, in addition, choose to subscribe to these other lists:
  266.  
  267.      ibm-java@hursley.ibm.com
  268.  
  269.         General information and discussion relating to the IBM versions of Java
  270.  
  271.      ibm-java-os2@hursley.ibm.com
  272.  
  273.         Technical discussions relating specifically to the OS/2 version of the
  274.         IBM Java distribution
  275.  
  276. Please note that subscribing to either of these other lists (to which you
  277. can post, of course) may lead to quite high volumes of e-mail traffic.
  278.  
  279. --------------------------------- End of file ---------------------------------
  280.