From: george.marrows@... (George Marrows)
Date: 2004-01-19T19:00:01+09:00
Subject: Re: ruby-dev summary 22435-22573

> I'm extremely lazy when it comes to reading docs embedded inside .tgz
> files -- I'd much rather see docs on the web.

Sorry about the lack of docs, either on or off the web. I know it's
something that needs correcting - I'll make sure there's some docs
available covering internal architecture and opcodes in time for the
next release.
 
> How good are the docs, anyway? I'm especially interested in your
> choice of opcodes and such. Is it practical to write an assembler
> for your VM? Have you perhaps already done it?

You create bcr bytecode by writing a kind of assembler using Ruby
method calls. For example 1+2 would be compiled as

w.ld_imm(1).    # push 1 on the stack
  ld_imm(2).    # push 2 on the stack
  call(:+, 1)   # call 1's :+ method with 1 argument

(w is a 'writer' object for bytecode).

But there's no separate assembler syntax, or assembler files.

-- George