Import Upstream version 20180207
[hcoop/debian/mlton.git] / doc / guide / localhost / CompilationManager
... / ...
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>CompilationManager</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();\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>CompilationManager</h1>\r
27</div>\r
28<div id="content">\r
29<div id="preamble">\r
30<div class="sectionbody">\r
31<div class="paragraph"><p>The <a href="http://www.smlnj.org/doc/CM/index.html">Compilation Manager</a> (CM) is SML/NJ&#8217;s mechanism for supporting programming-in-the-very-large.</p></div>\r
32</div>\r
33</div>\r
34<div class="sect1">\r
35<h2 id="_porting_sml_nj_cm_files_to_mlton">Porting SML/NJ CM files to MLton</h2>\r
36<div class="sectionbody">\r
37<div class="paragraph"><p>To help in porting CM files to MLton, the MLton source distribution\r
38includes the sources for a utility, <span class="monospaced">cm2mlb</span>, that will print an\r
39<a href="MLBasis"> ML Basis</a> file with essentially the same semantics as the\r
40CM file&#8201;&#8212;&#8201;handling the full syntax of CM supported by your installed\r
41SML/NJ version and correctly handling export filters. When <span class="monospaced">cm2mlb</span>\r
42encounters a <span class="monospaced">.cm</span> import, it attempts to convert it to a\r
43corresponding <span class="monospaced">.mlb</span> import. CM anchored paths are translated to\r
44paths according to a default configuration file\r
45(<a href="https://github.com/MLton/mlton/blob/master/util/cm2mlb/cm2mlb-map"><span class="monospaced">cm2mlb-map</span></a>). For example,\r
46the default configuration includes</p></div>\r
47<div class="listingblock">\r
48<div class="content monospaced">\r
49<pre># Standard ML Basis Library\r
50$SMLNJ-BASIS $(SML_LIB)/basis\r
51$basis.cm $(SML_LIB)/basis\r
52$basis.cm/basis.cm $(SML_LIB)/basis/basis.mlb</pre>\r
53</div></div>\r
54<div class="paragraph"><p>to ensure that a <span class="monospaced">$/basis.cm</span> import is translated to a\r
55<span class="monospaced">$(SML_LIB)/basis/basis.mlb</span> import. See <span class="monospaced">util/cm2mlb</span> for details.\r
56Building <span class="monospaced">cm2mlb</span> requires that you have already installed a recent\r
57version of SML/NJ.</p></div>\r
58</div>\r
59</div>\r
60</div>\r
61<div id="footnotes"><hr></div>\r
62<div id="footer">\r
63<div id="footer-text">\r
64</div>\r
65<div id="footer-badges">\r
66</div>\r
67</div>\r
68</body>\r
69</html>\r