diff options
| author | Yukihiro "Matz" Matsumoto <[email protected]> | 2013-05-08 08:13:58 -0700 |
|---|---|---|
| committer | Yukihiro "Matz" Matsumoto <[email protected]> | 2013-05-08 08:13:58 -0700 |
| commit | ea10d2d3d6f6c6096f7f9f36443a8bcb121e7c6b (patch) | |
| tree | beadcbe6ad13909a17fe225ac4986f60d00b5fa4 | |
| parent | 25b8ae96ab4a71edf03812154aac84907bf2c4a7 (diff) | |
| parent | 2991c8b0b22bc19f6137b2468fa6daaedca87a7b (diff) | |
| download | mruby-ea10d2d3d6f6c6096f7f9f36443a8bcb121e7c6b.tar.gz mruby-ea10d2d3d6f6c6096f7f9f36443a8bcb121e7c6b.zip | |
Merge pull request #1240 from bovi/patch-1
[doc] Add minimal build configuration
| -rw-r--r-- | doc/compile/README.md | 19 |
1 files changed, 19 insertions, 0 deletions
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 |