rubyx/lib/mom/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 organised by their respective classes and get loaded in boot_classes! ,
right at the start. (see register/boot.rb)

These functions return their code, ie a Parfait::CallableMethod 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.
polish docs and a bit of code style 2018-03-11 11:41:15 +01:00			`## Builtin module`
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 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
polish docs and a bit of code style 2018-03-11 11:41:15 +01:00			`The functions are organised by their respective classes 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 typed_method to callable_method seems to make the essence clearer also extracted base class 2018-07-07 08:11:09 +02:00			`These functions return their code, ie a Parfait::CallableMethod 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
polish docs and a bit of code style 2018-03-11 11:41:15 +01: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.`
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			`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
polish docs and a bit of code style 2018-03-11 11:41:15 +01:00			`The Builtin module is scattered into several files, but that is just so the file`
			`doesn't get too long.`