home *** CD-ROM | disk | FTP | other *** search
/ Acorn User 11 / AUCD11B.iso / LANGUAGES / Java / !Guavac / doc / RO-FAQ < prev    next >
Encoding:
Text File  |  1998-01-08  |  5.7 KB  |  160 lines
  1.  
  2. This is the Risc OS guavac FAQ
  3. Peter Naulls, January 7th, 1998
  4. pnaulls@usa.net
  5.  
  6.  
  7.   guavac refers to the Acorn Risc OS port of guavac, a Java source compiler,
  8.   distributed under a GNU license, and ported by myself to Risc OS.
  9.   The version referred to by this FAQ is 1.0, Risc OS release 1.1.
  10.   guavac is sometimes also referred to as !Guavac.
  11.  
  12.   !Java refers to Acorn's 1.0.2 port of Sun's JVM to Risc OS.
  13.  
  14.   javac is the Java compiler as distributed as part of Sun's Java
  15.   Development Kit.
  16.  
  17.  
  18. 1.  Who's responsible for errors and emmisions in this FAQ?
  19. 2.  Where can I get the latest version of guavac from?
  20. 3.  Why does guavac complain "No writable memory at this address"?
  21. 4.  guavac says my source file is not a plain file or invalid source file,
  22.     what's wrong?
  23. 5.  I've compiled my program, but !Java says it can't find my class, what's
  24.     going wrong?
  25. 6.  What is the format of the Java$ClassPath variable, and when do I need
  26.     to set it?
  27. 7.  Why will javac compile some things, but not guavac?
  28. 8.  Why will guavac compile some things, but not javac?
  29. 9.  Why doesn't guavac do <<insert Risc OS bug/feature>>?
  30. 10. Why doesn't throwback work?
  31. 11. What's a good book on to learn Java from?
  32. 12. What other Risc OS Java-related programs are available?
  33. 13. Where can I find more Risc OS related Java programming information?
  34.  
  35.  
  36.  
  37. 1.  Who's responsible for errors and emmisions in this FAQ?
  38.  
  39. A.  I (Peter Naulls) take full responsibilty, and no blame should be
  40.     placed on employees of Acorn or Sun Microsystems.  Corrections and
  41.     additions are of course gratefully received.
  42.  
  43.  
  44. 2.  Where can I get the latest version of guavac from?
  45.  
  46. A.  The Risc OS guavac homepage is: http://chocky.home.ml.org/java/guavac/
  47.  
  48.  
  49. 3.  Why does guavac complain "No writable memory at this address"?
  50.  
  51. A.  The guavac executable requires 3Mb of memory.  You need to increase
  52.     your wimpslot to this.  If you are using a pre-Risc PC, you will need
  53.     more, since guavac will be unable to use dynamic areas for its heap.
  54.  
  55.  
  56. 4.  guavac says my source file is not a plain file or invalid source file,
  57.     what's wrong?
  58.  
  59. A.  Firstly, make sure you have the newest version of guavac - release 1
  60.     has difficulty finding files in the CSD. Otherwise, guavac can't find
  61.     your file, or you've used an illegal format for the filename.  If you
  62.     don't specify a full Risc OS path, guavac will look in the CSD.  Java
  63.     source files as understood by guavac must be either file/java or
  64.     java.file, where 'java.' in the second example is a directory.  For
  65.     the first format, you can give either of:
  66.  
  67.      guavac file.java
  68.  
  69.     or
  70.  
  71.       guavac file/java
  72.  
  73.     In the second, you must have:
  74.  
  75.       guavc java.file
  76.  
  77.     for it to be found.
  78.  
  79.  
  80. 5.  I've compiled my program, but !Java says it can't find my class, what's
  81.     going wrong?
  82.  
  83. A.  Acorn's Java is very picky about what it will do with Java classes.  It
  84.     will complain when:
  85.  
  86.     (a) The file !Java.ClassesZip is an image file (change the filetype to a
  87.         textfile)
  88.     (b) The Java class does not have a "/class" extension (or as much as
  89.         will fit into a Risc OS filename).  This means you will want to
  90.         use the guavac -ext flag.
  91.     (c) The class you compiled was declared as public.  When you do this,
  92.         the filename must be the same as the class's name.  If you rename it
  93.         for whatever reason, !Java will complain.
  94.  
  95.  
  96. 6.  What is the format of the Java$ClassPath variable, and when do I need
  97.     to set it?
  98.  
  99. A.  Firstly, you won't need to set this unless you are doing something
  100.     unusual (this also applies to the -classpath flag).  If you do need
  101.     to set it, then the format is simply the full Risc OS path, although
  102.     you can use a Unix type path if you need to.  Note that !Java sets this
  103.     variable to point to !Java.ClassesZip, and guavac will use this.
  104.  
  105.  
  106. 7.  Why will javac compile some things, but not guavac?
  107.  
  108. A.  There are somethings that guavac does not handle well (have a look at
  109.     !Guavac.doc.TODO) The best example is circular dependencies between classes.
  110.     A fix for this problem is to first compile a "minimal" version of one
  111.     of the two circular classes, then compile the second and finally
  112.     the full version of the first class.
  113.  
  114.  
  115. 8.  Why will guavac compile some things, but not javac?
  116.  
  117. A.  You're probably trying to compile Java 1.1 things like inner classes,
  118.     which are not supported in Java 1.0.2.
  119.  
  120.  
  121. 9.  Why doesn't guavac do <<insert Risc OS bug/feature>>?
  122.  
  123. A.  Maybe it's a bug in either the port or the program itself.  Please
  124.     contact me with details, and if possible, the smallest amount
  125.     of Java source that reproduces the problem.  It may also be helpful
  126.     to know details of machine and OS.  If it looks like a "proper"
  127.     guavac bug rather than a Risc OS related one, try asking on the
  128.     guavac mailing list.
  129.  
  130.  
  131. 10. Why doesn't throwback work?
  132.  
  133. A.  You need to have the DDEUtils module loaded for throwback to work,
  134.     and you will need a throwback-capable editor running such as StrongED
  135.     or Zap.
  136.  
  137.  
  138. 11. What's a good book on to learn Java from?
  139.  
  140. A.  Try to get one that supports Java 1.1.  Some good books are:
  141.     "Java in a Nutshell" and "Special Edition Using Java".
  142.  
  143.  
  144. 12. What other Risc OS Java-related programs are available?
  145.  
  146. A.  Acorn's !Java, as released on Clan CD at Acorn World 1997.
  147.     D-Java, a free Java bytecode dissasembler, ported by myself.
  148.     Chockcino (not yet released) my Java 1.1 Virtual machine.
  149.     See http://chocky.home.ml.org/java/ for information on D-Java and
  150.     Chockcino.
  151.  
  152.  
  153. 13. Where can I find more Risc OS related Java programming information?
  154.  
  155. A.  The Acorn newsgroupps.  In pariticular, comp.sys.acorn.programmer.
  156.     You might also like to read my monthly series on Java programming
  157.     in RISC User.
  158.  
  159.  
  160.