Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Loading…

[doc] Add minimal build configuration #1240

Merged
merged 1 commit into from

2 participants

@bovi

In relation to #1225.

Adds a minimal build configuration for libmruby which contains as less as possible.

@bovi bovi [doc] Add minimal build configuration
In relation to #1225.

Adds a minimal build configuration for libmruby which contains as less as possible.
2991c8b
@matz matz merged commit ea10d2d into from
@bovi bovi deleted the branch
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Commits on May 8, 2013
  1. @bovi

    [doc] Add minimal build configuration

    bovi authored
    In relation to #1225.
    
    Adds a minimal build configuration for libmruby which contains as less as possible.
This page is out of date. Refresh to see the latest.
Showing with 19 additions and 0 deletions.
  1. +19 −0 doc/compile/README.md
View
19 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
Something went wrong with that request. Please try again.