on master help sign in
Add docs and changelog entry for bundled toolchain
2ad80e8Niklas Larsson
CHANGELOG+1
@@ -1,5 +1,6 @@
1New in 0.9.18:
1New in 0.9.18:
2--------------
2--------------
3+* Add support for bundled toolchains.
3* Strings are now UTF8 encoded in the default back end
4* Strings are now UTF8 encoded in the default back end
4* Idris source files are now assumed to be in UTF8, regardless of locale
5* Idris source files are now assumed to be in UTF8, regardless of locale
5 settings.
6 settings.
docs/faq/faq.rst+15
@@ -131,6 +131,21 @@ choice by the developers of Idris, Idris uses the C style convention.
131That is, the names ``Float`` and ``Double`` are used to describe
131That is, the names ``Float`` and ``Double`` are used to describe
132single and double precision numbers.
132single and double precision numbers.
133
133
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+
134What does the name ‘Idris’ mean?
149What does the name ‘Idris’ mean?
135================================
150================================
136
151