rubyx/lib/register/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 virtual/boot.rb)

These functions return their code, ie a Virtual::CompiledMethod 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://salama.github.io/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! ,`
			`right at the start. (see virtual/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
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			`These functions return their code, ie a Virtual::CompiledMethod object, 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
			`Slightly more here : http://salama.github.io/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.`