From 2991c8b0b22bc19f6137b2468fa6daaedca87a7b Mon Sep 17 00:00:00 2001 From: Daniel Bovensiepen Date: Wed, 8 May 2013 21:54:51 +0800 Subject: [doc] Add minimal build configuration In relation to #1225. Adds a minimal build configuration for libmruby which contains as less as possible. --- doc/compile/README.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) (limited to 'doc') diff --git a/doc/compile/README.md b/doc/compile/README.md index 231f8995c..a244d06b2 100644 --- a/doc/compile/README.md +++ b/doc/compile/README.md @@ -346,6 +346,25 @@ linking with *build/i386/lib/libmruby_core.a* ---------------------------------------------------------------- ``` +## Build Configuration Examples + +### Minimal Library + +To build a minimal mruby library you need to use the Cross Compiling +feature due to the reason that there are functions (i.e. stdio) which +can't be disabled for the main build. + + MRuby::CrossBuild.new('Minimal') do |conf| + toolchain :gcc + + conf.cc.defines = %w(DISABLE_STDIO) + conf.bins = [] + end + +This configuration defines a cross compile build called 'Minimal' which +is using the GCC and compiles for the host machine. It also disables +all usages of stdio and doesn't compile any binaries (i.e. mrbc). + ## Test Environment mruby's build process includes a test environment. In case you start the testing -- cgit v1.2.3