on master help sign in
Add docs and changelog entry for bundled toolchain
commit2ad80e8d78850846660cafb434a693768745e5ae authorNiklas Larsson <niklas@mm.st> dateTue 31 Mar 2015, 13:56 (12 years ago) parentb9b19e5
2 files changed+16
CHANGELOG+1 docs/faq/faq.rst+15
CHANGELOG+1
@@ -1,5 +1,6 @@
11New in 0.9.18:
22--------------
3+* Add support for bundled toolchains.
34* Strings are now UTF8 encoded in the default back end
45* Idris source files are now assumed to be in UTF8, regardless of locale
56 settings.
docs/faq/faq.rst+15
@@ -131,6 +131,21 @@ choice by the developers of Idris, Idris uses the C style convention.
131131That is, the names ``Float`` and ``Double`` are used to describe
132132single and double precision numbers.
133133
134+What is -ffreestanding?
135+=======================
136+
137+The freestanding flag is used to build Idris binaries which have their
138+libs and compiler in a relative path. This is useful for building binaries
139+where the install directory is unknown at build time. When passing this
140+flag, the IDRIS_LIB_DIR environment variable needs to be set to the path
141+where the Idris libs reside relative to the idris executable. The
142+IDRIS_TOOLCHAIN_DIR environment variable is optional, if that is set,
143+Idris will use that path to find the C compiler.
144+
145+Example:
146+.. code-block::
147+ IDRIS_LIB_DIR="./libs" IDRIS_TOOLCHAIN_DIR="./mingw/bin" CABALFLAGS="-fffi -ffreestanding -frelease" make
148+
134149What does the name ‘Idris’ mean?
135150================================
136151