/usr/share/doc/racket/drracket/module.html is in racket-doc 6.1-4.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 | <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><title>2.1 Language Declared in Source</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,"tocview_0");">►</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">Dr<span class="mywbr"> </span>Racket:<span class="mywbr"> </span> The Racket Programming Environment</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1 </td><td><a href="interface-essentials.html" class="tocviewlink" data-pltdoc="x">Interface Essentials</a></td></tr><tr><td align="right">2 </td><td><a href="languages.html" class="tocviewselflink" data-pltdoc="x">Languages</a></td></tr><tr><td align="right">3 </td><td><a href="Interface_Reference.html" class="tocviewlink" data-pltdoc="x">Interface Reference</a></td></tr><tr><td align="right">4 </td><td><a href="extending-drracket.html" class="tocviewlink" data-pltdoc="x">Extending Dr<span class="mywbr"> </span>Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,"tocview_1");">▼</a></td><td>2 </td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Languages</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">2.1 </td><td><a href="" class="tocviewselflink" data-pltdoc="x">Language Declared in Source</a></td></tr><tr><td align="right">2.2 </td><td><a href="legacy.html" class="tocviewlink" data-pltdoc="x">Legacy Languages</a></td></tr><tr><td align="right">2.3 </td><td><a href="htdp-langs.html" class="tocviewlink" data-pltdoc="x"><span style="font-style: italic">How to Design Programs</span> Teaching Languages</a></td></tr><tr><td align="right">2.4 </td><td><a href="experimental-langs.html" class="tocviewlink" data-pltdoc="x">Other Experimental Languages</a></td></tr><tr><td align="right">2.5 </td><td><a href="output-syntax.html" class="tocviewlink" data-pltdoc="x">Output Printing Styles</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" style="color: #888;" type="text" value="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, "6.1", "../");" onfocus="this.style.color="black"; this.style.textAlign="left"; if (this.value == "...search manuals...") this.value="";" onblur="if (this.value.match(/^ *$/)) { this.style.color="#888"; this.style.textAlign="center"; this.value="...search manuals..."; }"/></form> <a href="../index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot("6.1");">top</a></span><span class="navright"> <a href="languages.html" title="backward to "2 Languages"" data-pltdoc="x">← prev</a> <a href="languages.html" title="up to "2 Languages"" data-pltdoc="x">up</a> <a href="legacy.html" title="forward to "2.2 Legacy Languages"" data-pltdoc="x">next →</a></span> </div><h4 x-source-module="(lib "scribblings/drracket/drracket.scrbl")" x-part-tag=""module"">2.1<tt> </tt><a name="(part._module)"></a>Language Declared in Source</h4><p>The <a name="(idx._(gentag._39._(lib._scribblings/drracket/drracket..scrbl)))"></a><span class="ssansserif">The Racket Language</span> mode
in DrRacket is a kind of meta-language, where the program itself
specifies its language, usually through a <a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=guide&rel=Module_Syntax.html%23%2528part._hash-lang%2529&version=6.1" class="RktModLink Sq" data-pltdoc="x"><span class="RktMod">#lang</span></a> line.</p><p>More generally, when using this mode, the
<a href="interface-essentials.html#%28tech._definitions._window%29" class="techoutside" data-pltdoc="x"><span class="techinside">definitions window</span></a> must contain a module in some form. Besides
<a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=guide&rel=Module_Syntax.html%23%2528part._hash-lang%2529&version=6.1" class="RktModLink Sq" data-pltdoc="x"><span class="RktMod">#lang</span></a>, a Racket module can be written as <span class="RktPn">(</span><span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=reference&rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&version=6.1" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="stt"> </span><span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=reference&rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&version=6.1" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="RktPn">)</span>; aside from comments, the <a href="interface-essentials.html#%28tech._definitions._window%29" class="techoutside" data-pltdoc="x"><span class="techinside">definitions window</span></a>
must contain exactly one module.</p><p>In the details pane of the language dialog, some of the configuration
options correspond to using various libraries and thus can be used
without DrRacket. Here’s how, for the ones that are straightforward
(the ones not mentioned here require more sophisticated configuration
of various libraries).</p><ul><li><p><span style="font-weight: bold">Dynamic Properties</span>:
The radio buttons corresond to various uses of the <a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=errortrace&rel=errortrace-library.html&version=6.1" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">errortrace/errortrace-lib</span></a> library.</p><p>The <span style="font-style: italic">No Debugging or profiling</span> option means not to use the library at all.</p><p>The <span style="font-style: italic">Debugging</span> option means <span class="RktPn">(</span><span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=reference&rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._current-compile%2529%2529&version=6.1" class="RktValLink Sq" data-pltdoc="x">current-compile</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=errortrace&rel=errortrace-library.html%23%2528def._%2528%2528lib._errortrace%252Ferrortrace-lib..rkt%2529._make-errortrace-compile-handler%2529%2529&version=6.1" class="RktValLink Sq" data-pltdoc="x">make-errortrace-compile-handler</a></span><span class="RktPn">)</span><span class="RktPn">)</span> as well as
adding <span class="RktPn">(</span><span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=reference&rel=Manipulating_Paths.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._build-path%2529%2529&version=6.1" class="RktValLink Sq" data-pltdoc="x">build-path</a></span><span class="stt"> </span><span class="RktVal">"compiled"</span><span class="stt"> </span><span class="RktVal">"errortrace"</span><span class="RktPn">)</span> to <span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=reference&rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._use-compiled-file-paths%2529%2529&version=6.1" class="RktValLink Sq" data-pltdoc="x">use-compiled-file-paths</a></span>.</p><p>The <span style="font-style: italic">Debugging and profiling</span> option means to use <a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=errortrace&rel=errortrace-library.html&version=6.1" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">errortrace/errortrace-lib</span></a> library’s
<span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=errortrace&rel=using-errortrace.html%23%2528def._%2528%2528lib._errortrace%252Ferrortrace-lib..rkt%2529._profiling-enabled%2529%2529&version=6.1" class="RktValLink Sq" data-pltdoc="x">profiling-enabled</a></span> in conjunction with <span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=reference&rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._current-eval%2529%2529&version=6.1" class="RktValLink Sq" data-pltdoc="x">current-eval</a></span>.</p><p>The <span style="font-style: italic">Syntactic test suite coverage</span> option means to use <span class="RktSym">test-coverage-enabled</span>
in conjunction with <span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=reference&rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._current-eval%2529%2529&version=6.1" class="RktValLink Sq" data-pltdoc="x">current-eval</a></span>.</p><p>The other three checkboxes save compiled <span class="stt">.zo</span> files and adjust the compiler.</p><p><div class="SIntrapara">The <span style="font-style: italic">populate compiled/ directories</span> option corresponds to
</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=reference&rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._current-load%252Fuse-compiled%2529%2529&version=6.1" class="RktValLink Sq" data-pltdoc="x">current-load/use-compiled</a></span></td></tr><tr><td><span class="hspace"> </span><span class="RktPn">(</span><span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=raco&rel=make.html%23%2528def._%2528%2528lib._compiler%252Fcm..rkt%2529._make-compilation-manager-load%252Fuse-compiled-handler%2529%2529&version=6.1" class="RktValLink Sq" data-pltdoc="x">make-compilation-manager-load/use-compiled-handler</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=raco&rel=make.html%23%2528def._%2528%2528lib._compiler%252Fcm..rkt%2529._manager-skip-file-handler%2529%2529&version=6.1" class="RktValLink Sq" data-pltdoc="x">manager-skip-file-handler</a></span></td></tr><tr><td><span class="hspace"> </span><span class="RktPn">(</span><span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=reference&rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7Ece%7Ebb%2529%2529&version=6.1" class="RktStxLink Sq" data-pltdoc="x">λ</a></span><span class="hspace"> </span><span class="RktPn">(</span><span class="RktSym">p</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace"> </span><span class="RktPn">(</span><span class="RktSym">file-date-in-paths</span></td></tr><tr><td><span class="hspace"> </span><span class="RktSym">p</span></td></tr><tr><td><span class="hspace"> </span><span class="RktPn">(</span><span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=reference&rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&version=6.1" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace"> </span><span class="RktPn">(</span><span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=planet&rel=Utility_Libraries.html%23%2528def._%2528%2528lib._planet%252Fconfig..rkt%2529._.C.A.C.H.E-.D.I.R%2529%2529&version=6.1" class="RktValLink Sq" data-pltdoc="x">CACHE-DIR</a></span><span class="RktPn">)</span><span class="hspace"> </span><span class="RktPn">(</span><span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=reference&rel=collects.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._current-library-collection-paths%2529%2529&version=6.1" class="RktValLink Sq" data-pltdoc="x">current-library-collection-paths</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">plus adding either <span class="RktPn">(</span><span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=reference&rel=Manipulating_Paths.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._build-path%2529%2529&version=6.1" class="RktValLink Sq" data-pltdoc="x">build-path</a></span><span class="stt"> </span><span class="RktVal">"compiled"</span><span class="stt"> </span><span class="RktVal">"drracket"</span><span class="RktPn">)</span> or
<span class="RktPn">(</span><span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=reference&rel=Manipulating_Paths.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._build-path%2529%2529&version=6.1" class="RktValLink Sq" data-pltdoc="x">build-path</a></span><span class="stt"> </span><span class="RktVal">"compiled"</span><span class="stt"> </span><span class="RktVal">"drracket"</span><span class="stt"> </span><span class="RktVal">"errortrace"</span><span class="RktPn">)</span>
to the front of <span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=reference&rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._use-compiled-file-paths%2529%2529&version=6.1" class="RktValLink Sq" data-pltdoc="x">use-compiled-file-paths</a></span>, depending if the
<span style="font-style: italic">Debugging</span> option is set or not.</div></p><p><div class="SIntrapara">The <span style="font-style: italic">Preserve stacktrace</span> option corresponds to
</div><div class="SIntrapara"><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=reference&rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._compile-context-preservation-enabled%2529%2529&version=6.1" class="RktValLink Sq" data-pltdoc="x">compile-context-preservation-enabled</a></span><span class="hspace"> </span><span class="RktVal">#t</span><span class="RktPn">)</span></p></blockquote></div></p><p>The <span style="font-style: italic">Enforce constant definitions (enables some inlining)</span> option
corresponds to calling <span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=reference&rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._compile-enforce-module-constants%2529%2529&version=6.1" class="RktValLink Sq" data-pltdoc="x">compile-enforce-module-constants</a></span>;
checking it passes <span class="RktVal">#t</span> and leaving it unchecked passes <span class="RktVal">#f</span>.</p></li><li><p><span style="font-weight: bold">Output Syntax</span>: The output syntax options correspond to settings in the <a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=reference&rel=pretty-print.html&version=6.1" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/pretty</span></a> library
and the <a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=mzlib&rel=mzlib_pconvert.html&version=6.1" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">mzlib/pconvert</span></a> library.</p></li><li><p><span style="font-weight: bold">Collection Paths</span>: This corresponds to setting the <span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=reference&rel=collects.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._current-library-collection-paths%2529%2529&version=6.1" class="RktValLink Sq" data-pltdoc="x">current-library-collection-paths</a></span> parameter.</p></li><li><p><span style="font-weight: bold">Command-line arguments</span>: This corresponds to setting the <span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=reference&rel=runtime.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._current-command-line-arguments%2529%2529&version=6.1" class="RktValLink Sq" data-pltdoc="x">current-command-line-arguments</a></span> parameter.</p></li></ul><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" style="color: #888;" type="text" value="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, "6.1", "../");" onfocus="this.style.color="black"; this.style.textAlign="left"; if (this.value == "...search manuals...") this.value="";" onblur="if (this.value.match(/^ *$/)) { this.style.color="#888"; this.style.textAlign="center"; this.value="...search manuals..."; }"/></form> <a href="../index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot("6.1");">top</a></span><span class="navright"> <a href="languages.html" title="backward to "2 Languages"" data-pltdoc="x">← prev</a> <a href="languages.html" title="up to "2 Languages"" data-pltdoc="x">up</a> <a href="legacy.html" title="forward to "2.2 Legacy Languages"" data-pltdoc="x">next →</a></span> </div></div></div><div id="contextindicator"> </div></body></html>
|