Import Upstream version 20180207
[hcoop/debian/mlton.git] / doc / guide / localhost / LineDirective
CommitLineData
7f918cf1
CE
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>LineDirective</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>LineDirective</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>To aid in the debugging of code produced by program generators such\r
32as <a href="http://www.eecs.harvard.edu/%7Enr/noweb/">Noweb</a>, MLton supports\r
33comments with line directives of the form</p></div>\r
34<div class="listingblock">\r
35<div class="content"><div class="highlight"><pre><span class="cm">(*#line l.c &quot;f&quot;*)</span><span class="w"></span>\r
36</pre></div></div></div>\r
37<div class="paragraph"><p>Here, <em>l</em> and <em>c</em> are sequences of decimal digits and <em>f</em> is the\r
38source file. The first character of a source file has the position\r
391.1. A line directive causes the front end to believe that the\r
40character following the right parenthesis is at the line and column of\r
41the specified file. A line directive only affects the reporting of\r
42error messages and does not affect program semantics (except for\r
43functions like <span class="monospaced">MLton.Exn.history</span> that report source file positions).\r
44Syntactically invalid line directives are ignored. To prevent\r
45incompatibilities with SML, the file name may not contain the\r
46character sequence <span class="monospaced">*)</span>.</p></div>\r
47</div>\r
48</div>\r
49</div>\r
50<div id="footnotes"><hr></div>\r
51<div id="footer">\r
52<div id="footer-text">\r
53</div>\r
54<div id="footer-badges">\r
55</div>\r
56</div>\r
57</body>\r
58</html>\r