home *** CD-ROM | disk | FTP | other *** search
/ RISC DISC 2 / RISC_DISC_2.iso / pd_share / program / language / vscm / !ReadMe next >
Encoding:
Text File  |  1994-11-22  |  3.4 KB  |  106 lines
  1. ReadMe for Acorn version of VSCM V0r4
  2. -------------------------------------
  3.  
  4. This is the first semi-sane port of VSCM to the acorn hardware.
  5. Running VSCM is as simple as clicking on the icon; if you don't
  6. like it running by taking over the machine then simply use the alias
  7. thats provided - 'vscm' will run VSCM in a window. 
  8. As a default VSCM will set itself up by trying to get around 3 Meg of
  9. memory. 
  10. Bad news - this is a minimum. More is better.
  11. This is not a good version of Scheme if you want small and perfectly formed,
  12. it's more a large 'I can assume you've got heaps of memory' type
  13. implementation.
  14. 3 and a bit meg will just enable you to scrape through the R4RS test suite;
  15. it's happier with more - suggested at about 4 meg to keep it happy?
  16. (If you think this is ridiculous I advise you look at the memory 
  17. requirements of CMU Common Lisp - 24meg; also I'd happily point you at one
  18. of my other ports - GNU Scheme goes happily in little memory, Fools Lisp
  19. is happier still, and Siod varies somewhat depending on what yo are doing 
  20. with it..)
  21.  
  22.  
  23. Problems
  24. --------
  25. As yet - none known other than it tends to give 'Memory problems caused
  26. premature GC' messages. This is indicative of you not giving it enough
  27. memory (not vastly nice of it..)...
  28.  
  29.  
  30. Problems recompiling
  31. --------------------
  32. As I'm a nice informative person, if you do try recompiling here's how -
  33.  
  34. o    change the #ident directives (script in the unix tar file to do this)
  35.  
  36. o    compile up the stuff using a makefile. no twiddles needed
  37.  
  38. o    amu wont like it so try the following instead :
  39.         move o.main into the current directory (ie one up from o.)
  40.         remove o.fileno (this is important)
  41.         libfile -c -o lib o.*
  42.         link main lib unixlib -o scheme
  43.  
  44. o    and thats it (apart from finding yourself a bootstrapped image)
  45.  
  46. Main things to note - much to my vast annoyance this simple WILL NOT GO
  47. when compiled without unixlib. I suspect this has to do with fileno().
  48. When compiled with clib it works. But as soon as you try (load ...) it then
  49. hangs. Completely. You have to hard reboot. (No interrupts....nothing..)
  50. so unfortunately we dont have a self extending wimpslot yet....sigh.
  51. Sorry folks.
  52.  
  53.  
  54. Extensions
  55. ----------
  56. Not likely. I'll concentrate on the smaller implementations.
  57.  
  58.  
  59. So why use it?
  60. --------------
  61. It'll eat any bytecode produced on another piece of hardware by the same
  62. version of VSCM. Net result? You get portable compiled images.
  63. (Might be marginally faster at loading some stuff than straight
  64. interpreters...)
  65. How to use the bytecode ->
  66.  
  67.     (load "whatever")        ; obvious
  68.     (dump "obj_file")        ; dump out current wm into obj_file
  69.  
  70. thereafter you can use
  71.  
  72.     Set VSCMBOOT obj_file        ; set obj_code to boot from
  73.  
  74. to persuade VSCM to load from your new bytecode file next time around..
  75.  
  76.  
  77. Other info
  78. ----------
  79. Thanks to Matthias for helping track down a slight feature ;-)
  80. This was bootstrapped on a Sparc - if you want to see the sources or 
  81. the bootstrap code then try looking in
  82.  
  83.     ftp.cs.indiana.edu
  84.     /pub/scheme-repository/imp/vscmV0r4.tar.gz
  85.  
  86. which has the entire source code.
  87. You cannot (to my knowledge and from my attempts..) bootstrap it again on
  88. the archi - I've tried on a 16meg RPC from outside the WIMP and it simply
  89. refused to go....It might with persuasion - I can't see many people wanting
  90. to recompile the bootstrap source anyway ;-)
  91.  
  92.  
  93. Problems / ideas can be sent to :
  94.  
  95. Snail:
  96.     Al Slater
  97.     Kintail,
  98.     Barclay Park,
  99.     Aboyne,
  100.     Aberdeenshire.
  101.     AB34 5JF.
  102.  
  103.  
  104. Email:
  105.     ams@csd.abdn.ac.uk
  106.