aboutsummaryrefslogtreecommitdiffstats
path: root/lib/compiler/doc
diff options
context:
space:
mode:
authorBjörn Gustavsson <[email protected]>2016-12-07 15:40:45 +0100
committerBjörn Gustavsson <[email protected]>2016-12-07 16:21:14 +0100
commit8b0aff6608c42bf3c04381697b9ab57ffbd93456 (patch)
tree373b3543b4b17ccf053a136f8677eeab39ad25c4 /lib/compiler/doc
parentab2c71054a4c71c60ac433168048b8742408cd09 (diff)
downloadotp-8b0aff6608c42bf3c04381697b9ab57ffbd93456.tar.gz
otp-8b0aff6608c42bf3c04381697b9ab57ffbd93456.tar.bz2
otp-8b0aff6608c42bf3c04381697b9ab57ffbd93456.zip
Add option 'deterministic' for reproducible builds
Add the option 'deterministic' to make it easier to achieve reproducible builds. This option omits the {options,...} and {source,...} tuples in M:module_info(compile), because those options may contain absolute paths. The author of ERL-310 suggested that only compiler options that may contain absolute paths (such as {i,...}) should be excluded. But I find it confusing to keep only some options. Alternatives considered: Always omitting this information. Since this information has been available for a long time, that would probably break some workflows. As an example that some people care about {source,...}, 2d785c07fbf9 made it possible to give a compiler option to set {source,...}. ERL-310
Diffstat (limited to 'lib/compiler/doc')
-rw-r--r--lib/compiler/doc/src/compile.xml8
1 files changed, 8 insertions, 0 deletions
diff --git a/lib/compiler/doc/src/compile.xml b/lib/compiler/doc/src/compile.xml
index e93da85f6c..bd488a39a5 100644
--- a/lib/compiler/doc/src/compile.xml
+++ b/lib/compiler/doc/src/compile.xml
@@ -176,6 +176,14 @@
<seealso marker="stdlib:beam_lib#debug_info">beam_lib(3)</seealso>.</p>
</item>
+ <tag><c>deterministic</c></tag>
+ <item>
+ <p>Omit the <c>options</c> and <c>source</c> tuples in
+ the list returned by <c>Module:module_info(compile)</c>.
+ This option will make it easier to achieve reproducible builds.
+ </p>
+ </item>
+
<tag><c>makedep</c></tag>
<item>
<p>Produces a Makefile rule to track headers dependencies.