rubyx/lib/risc/builtin/README.md

### Builtin module

The Builtin module contains functions that can not be coded in ruby.
It is the other side of the parfait coin, part of  the runtime.

The functions are organized by their respective class and get loaded in boot_classes! ,
right at the start. (see register/boot.rb)

These functions return their code, ie a Parfait::TypedMethod with a MethodSource object,
which can then be called by ruby code as if it were a "normal"  function.

A normal ruby function is one that is parsed and transformed to code. But not all functionality can
be written in ruby, one of those chicken and egg things.
C uses Assembler in this situation, we use Builtin functions.

Slightly more here : http://ruby-x.org/2014/06/10/more-clarity.html (then still called Kernel)

The Builtin module is scattered into several files, but that is just so the file doesn't get too long.
renamed the kernel dir/ module to Builtin (so to not confuse with ruby kernel module) 2014-08-28 17:27:04 +02:00			`### Builtin module`

finally scoping builtin to register had put this off because it breaks history but now the references to register stuff which builtin is off course full of, become much shorter 2015-06-29 20:03:58 +02:00			`The Builtin module contains functions that can not be coded in ruby.`
bit of line wrapping 2015-03-25 16:29:39 +01:00			`It is the other side of the parfait coin, part of the runtime.`
renamed the kernel dir/ module to Builtin (so to not confuse with ruby kernel module) 2014-08-28 17:27:04 +02:00
finally scoping builtin to register had put this off because it breaks history but now the references to register stuff which builtin is off course full of, become much shorter 2015-06-29 20:03:58 +02:00			`The functions are organized by their respective class and get loaded in boot_classes! ,`
fold last of the virtual into register 2015-10-22 17:16:29 +02:00			`right at the start. (see register/boot.rb)`
renamed the kernel dir/ module to Builtin (so to not confuse with ruby kernel module) 2014-08-28 17:27:04 +02:00
rename method to typed_method 2016-12-12 22:38:55 +01:00			`These functions return their code, ie a Parfait::TypedMethod with a MethodSource object,`
renamed info to MethodSource 2015-07-03 19:13:03 +02:00			`which can then be called by ruby code as if it were a "normal" function.`
renamed the kernel dir/ module to Builtin (so to not confuse with ruby kernel module) 2014-08-28 17:27:04 +02:00
finally scoping builtin to register had put this off because it breaks history but now the references to register stuff which builtin is off course full of, become much shorter 2015-06-29 20:03:58 +02:00			`A normal ruby function is one that is parsed and transformed to code. But not all functionality can`
			`be written in ruby, one of those chicken and egg things.`
			`C uses Assembler in this situation, we use Builtin functions.`
renamed the kernel dir/ module to Builtin (so to not confuse with ruby kernel module) 2014-08-28 17:27:04 +02:00
starting to rename to rubyx 2017-01-01 23:29:20 +01:00			`Slightly more here : http://ruby-x.org/2014/06/10/more-clarity.html (then still called Kernel)`
renamed the kernel dir/ module to Builtin (so to not confuse with ruby kernel module) 2014-08-28 17:27:04 +02:00
			`The Builtin module is scattered into several files, but that is just so the file doesn't get too long.`