aboutsummaryrefslogtreecommitdiffhomepage
path: root/INSTALL
diff options
context:
space:
mode:
authorGravatar Emilio Jesus Gallego Arias <e+git@x80.org>2016-06-27 23:49:09 +0200
committerGravatar Emilio Jesus Gallego Arias <e+git@x80.org>2017-10-10 10:47:31 +0200
commit406717ce786a70e64b9043db45dd5a2add68f817 (patch)
treef37eeae1efcc765045ff1851cb79518cb23bf4e1 /INSTALL
parentf927df44202034fa8cf73f72af876ae1e4ca05ba (diff)
[configure] Support for flambda flags.
We add a new option to configure `-flambda-opts` to allow passing custom flags to flambda. Example: ``` ./configure -flambda-opts "-O3 -unbox-closures" ```
Diffstat (limited to 'INSTALL')
-rw-r--r--INSTALL18
1 files changed, 18 insertions, 0 deletions
diff --git a/INSTALL b/INSTALL
index 676a1f8ea..808e76882 100644
--- a/INSTALL
+++ b/INSTALL
@@ -128,6 +128,24 @@ INSTALLATION PROCEDURE IN DETAILS (NORMAL USERS).
Use <command> to open an URL in a browser. %s must appear in <command>,
and will be replaced by the URL.
+-flambda-opts <flags>
+ This experimental option will pass specific user flags to the
+ OCaml optimizing compiler. In most cases, this option is used
+ to tweak the flambda backend; we recommend using
+
+ -flambda-opts `-O3 -unbox-closures`
+
+ but of course you are free to try with a different combination
+ of flags. You can read more at
+ https://caml.inria.fr/pub/docs/manual-ocaml/flambda.html
+
+ Note that a regular build with a flambda-enabled compiler
+ requires a large amount of RAM (>= 10GiB) in one particular
+ file, see: https://caml.inria.fr/mantis/view.php?id=7630
+
+ Meanwhile, users with less powerful machines are recommended
+ to disable native compilation with `-native-compiler no`.
+
5- Still in the root directory, do
make