Import Upstream version 20180207
[hcoop/debian/mlton.git] / doc / guide / localhost / FAQ
... / ...
CommitLineData
1<!DOCTYPE html>\r
2<html lang="en">\r
3<head>\r
4<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">\r
5<meta name="generator" content="AsciiDoc 8.6.9">\r
6<title>FAQ</title>\r
7<link rel="stylesheet" href="./asciidoc.css" type="text/css">\r
8<link rel="stylesheet" href="./pygments.css" type="text/css">\r
9\r
10\r
11<script type="text/javascript" src="./asciidoc.js"></script>\r
12<script type="text/javascript">\r
13/*<![CDATA[*/\r
14asciidoc.install(2);\r
15/*]]>*/\r
16</script>\r
17<link rel="stylesheet" href="./mlton.css" type="text/css">\r
18</head>\r
19<body class="article">\r
20<div id="banner">\r
21<div id="banner-home">\r
22<a href="./Home">MLton 20180207</a>\r
23</div>\r
24</div>\r
25<div id="header">\r
26<h1>FAQ</h1>\r
27<div id="toc">
28 <div id="toctitle">Table of Contents</div>
29 <noscript><p><b>JavaScript must be enabled in your browser to display the table of contents.</b></p></noscript>
30</div>\r
31</div>\r
32<div id="content">\r
33<div id="preamble">\r
34<div class="sectionbody">\r
35<div class="paragraph"><p>Feel free to ask questions and to update answers by editing this page.\r
36Since we try to make as much information as possible available on the\r
37web site and we like to avoid duplication, many of the answers are\r
38simply links to a web page that answers the question.</p></div>\r
39</div>\r
40</div>\r
41<div class="sect1">\r
42<h2 id="_how_do_you_pronounce_mlton">How do you pronounce MLton?</h2>\r
43<div class="sectionbody">\r
44<div class="paragraph"><p><a href="Pronounce">Pronounce</a></p></div>\r
45</div>\r
46</div>\r
47<div class="sect1">\r
48<h2 id="_what_sml_software_has_been_ported_to_mlton">What SML software has been ported to MLton?</h2>\r
49<div class="sectionbody">\r
50<div class="paragraph"><p><a href="Libraries">Libraries</a></p></div>\r
51</div>\r
52</div>\r
53<div class="sect1">\r
54<h2 id="_what_graphical_libraries_are_available_for_mlton">What graphical libraries are available for MLton?</h2>\r
55<div class="sectionbody">\r
56<div class="paragraph"><p><a href="Libraries">Libraries</a></p></div>\r
57</div>\r
58</div>\r
59<div class="sect1">\r
60<h2 id="_how_does_mlton_8217_s_performance_compare_to_other_sml_compilers_and_to_other_languages">How does MLton&#8217;s performance compare to other SML compilers and to other languages?</h2>\r
61<div class="sectionbody">\r
62<div class="paragraph"><p>MLton has <a href="Performance">excellent performance</a>.</p></div>\r
63</div>\r
64</div>\r
65<div class="sect1">\r
66<h2 id="_does_mlton_treat_monomorphic_arrays_and_vectors_specially">Does MLton treat monomorphic arrays and vectors specially?</h2>\r
67<div class="sectionbody">\r
68<div class="paragraph"><p>MLton implements monomorphic arrays and vectors (e.g. <span class="monospaced">BoolArray</span>,\r
69<span class="monospaced">Word8Vector</span>) exactly as instantiations of their polymorphic\r
70counterpart (e.g. <span class="monospaced">bool array</span>, <span class="monospaced">Word8.word vector</span>). Thus, there is\r
71no need to use the monomorphic versions except when required to\r
72interface with the <a href="BasisLibrary">Basis Library</a> or for portability\r
73with other SML implementations.</p></div>\r
74</div>\r
75</div>\r
76<div class="sect1">\r
77<h2 id="_why_do_i_get_a_segfault_bus_error_in_a_program_that_uses_span_class_monospaced_intinf_span_span_class_monospaced_largeint_span_to_calculate_numbers_with_several_hundred_thousand_digits">Why do I get a Segfault/Bus error in a program that uses <span class="monospaced">IntInf</span>/<span class="monospaced">LargeInt</span> to calculate numbers with several hundred thousand digits?</h2>\r
78<div class="sectionbody">\r
79<div class="paragraph"><p><a href="GnuMP">GnuMP</a></p></div>\r
80</div>\r
81</div>\r
82<div class="sect1">\r
83<h2 id="_how_can_i_decrease_compile_time_memory_usage">How can I decrease compile-time memory usage?</h2>\r
84<div class="sectionbody">\r
85<div class="ulist"><ul>\r
86<li>\r
87<p>\r
88Compile with <span class="monospaced">-verbose 3</span> to find out if the problem is due to an\r
89SSA optimization pass. If so, compile with <span class="monospaced">-disable-pass <em>pass</em></span> to\r
90skip that pass.\r
91</p>\r
92</li>\r
93<li>\r
94<p>\r
95Compile with <span class="monospaced">@MLton hash-cons 0.5 --</span>, which will instruct the\r
96runtime to hash cons the heap every other GC.\r
97</p>\r
98</li>\r
99<li>\r
100<p>\r
101Compile with <span class="monospaced">-polyvariance false</span>, which is an undocumented option\r
102that causes less code duplication.\r
103</p>\r
104</li>\r
105</ul></div>\r
106<div class="paragraph"><p>Also, please <a href="Contact">Contact</a> us to let us know the problem to help us\r
107better understand MLton&#8217;s limitations.</p></div>\r
108</div>\r
109</div>\r
110<div class="sect1">\r
111<h2 id="_how_portable_is_sml_code_across_sml_compilers">How portable is SML code across SML compilers?</h2>\r
112<div class="sectionbody">\r
113<div class="paragraph"><p><a href="StandardMLPortability">StandardMLPortability</a></p></div>\r
114</div>\r
115</div>\r
116</div>\r
117<div id="footnotes"><hr></div>\r
118<div id="footer">\r
119<div id="footer-text">\r
120</div>\r
121<div id="footer-badges">\r
122</div>\r
123</div>\r
124</body>\r
125</html>\r