home *** CD-ROM | disk | FTP | other *** search
/ Acorn User 11 / AUCD11B.iso / LANGUAGES / Java / !Guavac / doc / !Help next >
Encoding:
Text File  |  1998-01-07  |  4.6 KB  |  136 lines
  1. !Help file for Risc OS guavac, version 1.0, release 1.1
  2. January 7th 1998
  3.  
  4. This is guavac, the GNU Java source file compiler, ported to Risc OS
  5. by Peter Naulls (pnaulls@usa.net).
  6.  
  7. guavac is an alternative to javac, the JDK Java compiler.  Since guavac
  8. is written in C++, rather than Java like javac, it is much faster.
  9.  
  10.  
  11. Changes since release 1.0
  12.  
  13.  * guavac will now load the library classes (!Guavac.class/zip) regardless
  14.    of whether it is an image file or not, so you are free to have it as
  15.    an archive (filetype &DDC) and open it if you wish.  Note that you
  16.    shouldn't have library files used by Acorn's Java as an image file,
  17.    as this will confuse !Java.
  18.  
  19.  * guavac correctly finds classes in the CSD. It will also load classes
  20.    if they do not have the "/class" extension.
  21.  
  22.  * The word ordering of double-precision floating point numbers under Risc OS
  23.    is slighty different to most other operating systems.  Previously, double
  24.    words were compiled into classes so that the high and low words were
  25.    reversed.  This has been corrected.
  26.  
  27.  * When guavac looks for classes other than those in the library (e.g. those
  28.    in the CSD) it will load them whether or not they have the "/class"
  29.    extension.  Remember that by default, guavac will not add the extension
  30.    when outputting files.  
  31.  
  32.  
  33. Installation:
  34.  
  35.   Copy the contents of the archive to your HD.  You may then wish to
  36.   reboot, or at least, rerun the !Boot, as it adds to the Run$Path variable.
  37.   There is no reason to uncompress the zip file inside the application.
  38.  
  39. Usage:
  40.  
  41.   To use it, read the documentation in !Guavac.doc; but in general, the
  42.   usage is:
  43.   
  44.     guavac <source filename>
  45.   
  46.   Where the source file is a java source file, with the file name of
  47.   the format:  program.java, program/java or java/program.  For other Risc
  48.   OS specific questions, see the guavac FAQ, in !Guavac.doc.RO-FAQ
  49.  
  50.   This distribution also contains guavad, a bytecode dissasembler.
  51.   Usage is:
  52.  
  53.     guavad <class filename>
  54.  
  55.  
  56. The following additions to command line options for guavac have been made
  57. for Risc OS:
  58.  
  59. Command line flags:
  60.  
  61.   -ext  By default, guavac will not add the "/class" extension to generated
  62.   classfiles, due to the likelihood of it being truncated to 10 characters
  63.   under the Risc OS filecore.  Using this flag means the extension will be
  64.   added.  Note that not adding the extension is not a problem, since the class
  65.   is filetyped to 'Java' (filetype &AE4).
  66.  
  67.   -th   Use throwback.  To use this, the DDEUtils module must be loaded.
  68.   When using this switch, an editor such as StrongED or Zap which supports
  69.   the throwback protocol will generate a list of files and linenumbers on
  70.   which errors occured.
  71.  
  72.  
  73. Library class files:
  74.  
  75.   By default, guavac will use the !Guavac.class/zip file as a library to
  76.   compile against.  However, if the system variable Java$ClassDir is
  77.   set (as it will be by RISCafe and Chockcino) then the library file to
  78.   which this points will be used instead.  The -classfile flag may be
  79.   used to overide either of these.  There is no need to set this variable.
  80.  
  81.  
  82. Source filenames:
  83.  
  84.   Source files may either be called program/java (assuming the filing system
  85.   you are using can handle this many characters in the filename) or
  86.   be of the format java.program, using the convention of C source files
  87.   under Risc OS.
  88.  
  89.  
  90. Memory Usage:
  91.  
  92.   Since guavac is linked with Unixlib, guavac cannot manually increase its
  93.   Wimpslot, so the wimpslot size must be set first, like GCC.  guavac sets
  94.   the guavac_heap system variable, so under Risc OS 3.5 or later, it will
  95.   use dynamic areas for its heap.  In this case, a Wimpslot of around 2.8Mb
  96.   should be fine.  It will also work with Virtualise if necessary.  On older
  97.   machines, the Wimpslot will need to be higher - experiment as necessary.
  98.   The value of guavac_heap is irrelevant; it only needs to exist, and
  99.   is set in the !Boot file. Please note that later releases of guavac may use
  100.   less memory.
  101.  
  102.  
  103.  
  104. To do:
  105.  
  106.   * Improve handling of unusual Risc OS filenames.
  107.   * Reduce executable size (not everything is fully optimised yet).
  108.  
  109.  
  110. Where can I learn more about Java?
  111.  
  112.   URLs
  113.     Javasoft:  http://www.javasoft.com/
  114.     Chockcino homepage:  http://chocky.home.ml.org/java/
  115.  
  116.   Magazines
  117.     My article in December 1997 Acorn User (that's the one with the Cover CD)
  118.     My series on Java programming in RISC User.
  119.  
  120.  
  121. Acknowlegdements:
  122.  
  123.   Tony Houghton - for help with the C++ templates.
  124.   Peter Burwood - again for help with C++ templates, the alternative
  125.     sprite, and for many comments and much miscelleneous help.
  126.   The UnixLib team
  127.   The #acorn channel 
  128.  
  129.  
  130.  
  131. Any comments, critisims, etc, to Peter Naulls - pnaulls@usa.net.
  132.  
  133.  
  134.  
  135.  
  136.