summaryrefslogtreecommitdiffhomepage
diff options
context:
space:
mode:
authortake_cheeze <[email protected]>2014-06-19 21:27:22 +0900
committertake_cheeze <[email protected]>2014-06-19 21:28:18 +0900
commit94ae70e8eea0462c63e76e1e50147ec2db2aa7b5 (patch)
tree05313f05e049b8dc39e44f8819da258f7bc1fa89
parent49ecd44c7be9dccca40172bc6a3d3fb2d97689e3 (diff)
downloadmruby-94ae70e8eea0462c63e76e1e50147ec2db2aa7b5.tar.gz
mruby-94ae70e8eea0462c63e76e1e50147ec2db2aa7b5.zip
Add notes about how to use mrbconf.
-rw-r--r--doc/mrbconf/README.md10
1 files changed, 10 insertions, 0 deletions
diff --git a/doc/mrbconf/README.md b/doc/mrbconf/README.md
index 930e185da..bb30c0b12 100644
--- a/doc/mrbconf/README.md
+++ b/doc/mrbconf/README.md
@@ -1,5 +1,15 @@
# mruby configuration macros.
+## How to use these macros.
+You can use mrbconfs with following ways:
+* Write them in `mrbconf.h`.
+ * Using compiler flags is prefered when building a cross binaries or multiple mruby binaries
+ since it's easier to use different mrbconf per each `MRuby::Build`.
+ * Most flags can be enabled by just commenting in.
+* Pass them as compiler flags.
+ * Make sure you pass the same flags to all compilers since some mrbconf(e.g., `MRB_GC_FIXED_ARENA`)
+ changes `struct` layout and cause memory access error when C and other language(e.g., C++) is mixed.
+
## stdio setting.
`ENABLE_STDIO`
* Will be defined automatically if `DISABLE_STDIO` isn't defined.