Backport from sid to buster
[hcoop/debian/mlton.git] / doc / guide / localhost / MLBasis
1 <!DOCTYPE html>
2 <html lang="en">
3 <head>
4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5 <meta name="generator" content="AsciiDoc 8.6.9">
6 <title>MLBasis</title>
7 <link rel="stylesheet" href="./asciidoc.css" type="text/css">
8 <link rel="stylesheet" href="./pygments.css" type="text/css">
9
10
11 <script type="text/javascript" src="./asciidoc.js"></script>
12 <script type="text/javascript">
13 /*<![CDATA[*/
14 asciidoc.install();
15 /*]]>*/
16 </script>
17 <link rel="stylesheet" href="./mlton.css" type="text/css">
18 </head>
19 <body class="article">
20 <div id="banner">
21 <div id="banner-home">
22 <a href="./Home">MLton 20180207</a>
23 </div>
24 </div>
25 <div id="header">
26 <h1>MLBasis</h1>
27 </div>
28 <div id="content">
29 <div id="preamble">
30 <div class="sectionbody">
31 <div class="paragraph"><p>The ML Basis system extends <a href="StandardML">Standard ML</a> to support
32 programming-in-the-very-large, namespace management at the module
33 level, separate delivery of library sources, and more. While Standard
34 ML modules are a sophisticated language for programming-in-the-large,
35 it is difficult, if not impossible, to accomplish a number of routine
36 namespace management operations when a program draws upon multiple
37 libraries provided by different vendors.</p></div>
38 <div class="paragraph"><p>The ML Basis system is a simple, yet powerful, approach that builds
39 upon the programmer&#8217;s intuitive notion (and
40 <a href="DefinitionOfStandardML"> The Definition of Standard ML (Revised)</a>'s
41 formal notion) of the top-level environment (a <em>basis</em>). The system
42 is designed as a natural extension of <a href="StandardML"> Standard ML</a>; the
43 formal specification of the ML Basis system
44 (<a href="MLBasis.attachments/mlb-formal.pdf"><span class="monospaced">mlb-formal.pdf</span></a>) is given in the style
45 of the Definition.</p></div>
46 <div class="paragraph"><p>Here are some of the key features of the ML Basis system:</p></div>
47 <div class="olist arabic"><ol class="arabic">
48 <li>
49 <p>
50 Explicit file order: The order of files (and, hence, the order of
51 evaluation) in the program is explicit. The ML Basis system&#8217;s
52 semantics are structured in such a way that for any well-formed
53 project, there will be exactly one possible interpretation of the
54 project&#8217;s syntax, static semantics, and dynamic semantics.
55 </p>
56 </li>
57 <li>
58 <p>
59 Implicit dependencies: A source file (corresponding to an SML
60 top-level declaration) is elaborated in the environment described by
61 preceding declarations. It is not necessary to explicitly list the
62 dependencies of a file.
63 </p>
64 </li>
65 <li>
66 <p>
67 Scoping and renaming: The ML Basis system provides mechanisms for
68 limiting the scope of (i.e, hiding) and renaming identifiers.
69 </p>
70 </li>
71 <li>
72 <p>
73 No naming convention for finding the file that defines a module.
74 To import a module, its defining file must appear in some ML Basis
75 file.
76 </p>
77 </li>
78 </ol></div>
79 </div>
80 </div>
81 <div class="sect1">
82 <h2 id="_next_steps">Next steps</h2>
83 <div class="sectionbody">
84 <div class="ulist"><ul>
85 <li>
86 <p>
87 <a href="MLBasisSyntaxAndSemantics">MLBasisSyntaxAndSemantics</a>
88 </p>
89 </li>
90 <li>
91 <p>
92 <a href="MLBasisExamples">MLBasisExamples</a>
93 </p>
94 </li>
95 <li>
96 <p>
97 <a href="MLBasisPathMap">MLBasisPathMap</a>
98 </p>
99 </li>
100 <li>
101 <p>
102 <a href="MLBasisAnnotations">MLBasisAnnotations</a>
103 </p>
104 </li>
105 <li>
106 <p>
107 <a href="MLBasisAvailableLibraries">MLBasisAvailableLibraries</a>
108 </p>
109 </li>
110 </ul></div>
111 </div>
112 </div>
113 </div>
114 <div id="footnotes"><hr></div>
115 <div id="footer">
116 <div id="footer-text">
117 </div>
118 <div id="footer-badges">
119 </div>
120 </div>
121 </body>
122 </html>