/usr/share/doc/racket/tools/Signatures.html is in racket-doc 6.7-3.
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 24 25 26 27 | <!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>11 Signatures</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 Plugins</a></td></tr></table></div><div class="tocviewsublistonly" style="display: block;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1 </td><td><a href="implementing-tools.html" class="tocviewlink" data-pltdoc="x">Implementing Dr<span class="mywbr"> </span>Racket Plugins</a></td></tr><tr><td align="right">2 </td><td><a href="adding-languages.html" class="tocviewlink" data-pltdoc="x">Adding Languages to Dr<span class="mywbr"> </span>Racket</a></td></tr><tr><td align="right">3 </td><td><a href="Creating_New_Kinds_of_DrRacket_Frames.html" class="tocviewlink" data-pltdoc="x">Creating New Kinds of Dr<span class="mywbr"> </span>Racket Frames</a></td></tr><tr><td align="right">4 </td><td><a href="Extending_the_Existing_DrRacket_Classes.html" class="tocviewlink" data-pltdoc="x">Extending the Existing Dr<span class="mywbr"> </span>Racket Classes</a></td></tr><tr><td align="right">5 </td><td><a href="Expanding_and_Breaking.html" class="tocviewlink" data-pltdoc="x">Expanding the User’s Program Text and Breaking</a></td></tr><tr><td align="right">6 </td><td><a href="Editor_Modes.html" class="tocviewlink" data-pltdoc="x">Editor Modes</a></td></tr><tr><td align="right">7 </td><td><a href="Language-Specific_Capabilities.html" class="tocviewlink" data-pltdoc="x">Language-<wbr></wbr>Specific Capabilities</a></td></tr><tr><td align="right">8 </td><td><a href="Check_Syntax.html" class="tocviewlink" data-pltdoc="x">Check Syntax</a></td></tr><tr><td align="right">9 </td><td><a href="Cooperating_with_Background_Check_Syntax.html" class="tocviewlink" data-pltdoc="x">Cooperating with Background Check Syntax</a></td></tr><tr><td align="right">10 </td><td><a href="Teaching_Languages.html" class="tocviewlink" data-pltdoc="x">Teaching Languages</a></td></tr><tr><td align="right">11 </td><td><a href="" class="tocviewselflink" data-pltdoc="x">Signatures</a></td></tr><tr><td align="right">12 </td><td><a href="drracket_get_extend.html" class="tocviewlink" data-pltdoc="x"><span class="stt">drracket:<span class="mywbr"> </span>get/<span class="mywbr"> </span>extend</span></a></td></tr><tr><td align="right">13 </td><td><a href="drracket_unit.html" class="tocviewlink" data-pltdoc="x"><span class="stt">drracket:<span class="mywbr"> </span>unit</span></a></td></tr><tr><td align="right">14 </td><td><a href="drracket_language.html" class="tocviewlink" data-pltdoc="x"><span class="stt">drracket:<span class="mywbr"> </span>language</span></a></td></tr><tr><td align="right">15 </td><td><a href="drracket_language-configuration.html" class="tocviewlink" data-pltdoc="x"><span class="stt">drracket:<span class="mywbr"> </span>language-<wbr></wbr>configuration</span></a></td></tr><tr><td align="right">16 </td><td><a href="drracket_debug.html" class="tocviewlink" data-pltdoc="x"><span class="stt">drracket:<span class="mywbr"> </span>debug</span></a></td></tr><tr><td align="right">17 </td><td><a href="drracket_rep.html" class="tocviewlink" data-pltdoc="x"><span class="stt">drracket:<span class="mywbr"> </span>rep</span></a></td></tr><tr><td align="right">18 </td><td><a href="drracket_frame.html" class="tocviewlink" data-pltdoc="x"><span class="stt">drracket:<span class="mywbr"> </span>frame</span></a></td></tr><tr><td align="right">19 </td><td><a href="drracket_help-desk.html" class="tocviewlink" data-pltdoc="x"><span class="stt">drracket:<span class="mywbr"> </span>help-<wbr></wbr>desk</span></a></td></tr><tr><td align="right">20 </td><td><a href="drracket_eval.html" class="tocviewlink" data-pltdoc="x"><span class="stt">drracket:<span class="mywbr"> </span>eval</span></a></td></tr><tr><td align="right">21 </td><td><a href="drracket_modes.html" class="tocviewlink" data-pltdoc="x"><span class="stt">drracket:<span class="mywbr"> </span>modes</span></a></td></tr><tr><td align="right">22 </td><td><a href="drracket_module-language-tools.html" class="tocviewlink" data-pltdoc="x"><span class="stt">drracket:<span class="mywbr"> </span>module-<wbr></wbr>language-<wbr></wbr>tools</span></a></td></tr><tr><td align="right">23 </td><td><a href="drracket_module-language.html" class="tocviewlink" data-pltdoc="x"><span class="stt">drracket:<span class="mywbr"> </span>module-<wbr></wbr>language</span></a></td></tr><tr><td align="right">24 </td><td><a href="drracket_tracing.html" class="tocviewlink" data-pltdoc="x"><span class="stt">drracket:<span class="mywbr"> </span>tracing</span></a></td></tr><tr><td align="right">25 </td><td><a href="Backwards_Compatibility.html" class="tocviewlink" data-pltdoc="x">Backwards Compatibility</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><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="#%28form._%28%28lib._drracket%2Ftool-lib..rkt%29._drracket~3atool~5e%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym">drracket:<span class="mywbr"> </span>tool^</span></a></td></tr><tr><td><a href="#%28form._%28%28lib._drracket%2Ftool-lib..rkt%29._drracket~3atool-exports~5e%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym">drracket:<span class="mywbr"> </span>tool-<wbr></wbr>exports^</span></a></td></tr><tr><td><a href="#%28sig-val._%28%28lib._drracket%2Ftool-lib..rkt%29._drracket~3atool-exports~5e._phase1%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym">phase1</span></a></td></tr><tr><td><a href="#%28sig-val._%28%28lib._drracket%2Ftool-lib..rkt%29._drracket~3atool-exports~5e._phase2%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym">phase2</span></a></td></tr></table></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.7", "../");" 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.7");">top</a></span><span class="navright"> <a href="Teaching_Languages.html" title="backward to "10 Teaching Languages"" data-pltdoc="x">← prev</a> <a href="index.html" title="up to "DrRacket Plugins"" data-pltdoc="x">up</a> <a href="drracket_get_extend.html" title="forward to "12 drracket:get/extend"" data-pltdoc="x">next →</a></span> </div><h3 x-source-module="(lib "scribblings/tools/tools.scrbl")" x-source-pkg="drracket" x-part-tag=""Signatures"">11<tt> </tt><a name="(part._.Signatures)"></a>Signatures</h3><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>signature</p></div></div><p class="RForeground"><a name="(form._((lib._drracket/tool-lib..rkt)._drracket~3atool~5e))"></a><span title="Provided from: drracket/tool-lib, drracket/tool, drscheme/tool-lib, drscheme/tool | Package: drracket"><span class="RktSym"><span class="RktSymDef RktSym">drracket:tool^</span></span></span><span class="hspace"> </span>:<span class="hspace"> </span>signature</p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara"><blockquote class="leftindent"><p>This signature includes all of the names in this manual that begin
with <span class="stt">drracket:</span> (except these two signatures).</p></blockquote></div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>signature</p></div></div><p class="RForeground"><a name="(form._((lib._drracket/tool-lib..rkt)._drracket~3atool-exports~5e))"></a><span title="Provided from: drracket/tool-lib, drracket/tool, drscheme/tool-lib, drscheme/tool | Package: drracket"><span class="RktSym"><span class="RktSymDef RktSym">drracket:tool-exports^</span></span></span><span class="hspace"> </span>:<span class="hspace"> </span>signature</p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara"><blockquote class="leftindent"><p>The <span class="RktSym">drracket:tool-exports^</span> signature contains two
names: <span class="RktSym">phase1</span> and
<span class="RktSym">phase2</span>.
After all of the tools are loaded, all of
the <span class="stt">phase1</span> functions are called and then all of the
<span class="stt">phase2</span> functions are called. Certain primitives can
only be called during the dynamic extent of those calls.</p><p>This mechanism is designed to support DrRacket’s
<span class="RktSym"><a href="drracket_language.html#%28def._%28%28lib._drracket%2Ftool-lib..rkt%29._drracket~3alanguage~3alanguage~3c~25~3e%29%29" class="RktValLink" data-pltdoc="x">drracket:language:language<%></a></span> extension
capabilities. That is, this mechanism enables two tools to
cooperate via new capabilities of languages. The first phase
is used for adding functionality that each language must
support and the second is used for creating instances of
languages. As an example, a tool may require certain
specialized language-specific information. It uses phase1 to
extend the <span class="RktSym"><a href="drracket_language.html#%28def._%28%28lib._drracket%2Ftool-lib..rkt%29._drracket~3alanguage~3alanguage~3c~25~3e%29%29" class="RktValLink" data-pltdoc="x">drracket:language:language<%></a></span> interface
and supply a default implementation of the interface
extension. Then, other languages that are aware of the
extension can supply non-default implementations of the
additional functionality.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(sig-val._((lib._drracket/tool-lib..rkt)._drracket~3atool-exports~5e._phase1))"></a><span class="RktSym">phase1</span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace"> </span>→<span class="hspace"> </span><span class="RktSym"><a href="https://download.racket-lang.org/docs/6.7/html/local-redirect/index.html?doc=reference&rel=void.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._void%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">void?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">These functions can be called only in the dynamic extent
of a call to <span class="RktSym">phase1</span> (see
above for details).
</div><div class="SIntrapara"><ul><li><p><span class="RktSym"><a href="drracket_language.html#%28def._%28%28lib._drracket%2Ftool-lib..rkt%29._drracket~3alanguage~3aextend-language-interface%29%29" class="RktValLink" data-pltdoc="x">drracket:language:extend-language-interface</a></span></p></li><li><p><span class="RktSym"><a href="drracket_unit.html#%28def._%28%28lib._drracket%2Ftool-lib..rkt%29._drracket~3aunit~3aadd-to-program-editor-mixin%29%29" class="RktValLink" data-pltdoc="x">drracket:unit:add-to-program-editor-mixin</a></span></p></li></ul></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(sig-val._((lib._drracket/tool-lib..rkt)._drracket~3atool-exports~5e._phase2))"></a><span class="RktSym">phase2</span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace"> </span>→<span class="hspace"> </span><span class="RktSym"><a href="https://download.racket-lang.org/docs/6.7/html/local-redirect/index.html?doc=reference&rel=void.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._void%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">void?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">These functions can be called only in the dynamic extent
of a call to <span class="RktSym">phase2</span> (see
above for details).
</div><div class="SIntrapara"><ul><li><p><span class="RktSym"><a href="drracket_language-configuration.html#%28def._%28%28lib._drracket%2Ftool-lib..rkt%29._drracket~3alanguage-configuration~3aadd-language%29%29" class="RktValLink" data-pltdoc="x">drracket:language-configuration:add-language</a></span></p></li><li><p><span class="RktSym"><a href="drracket_language.html#%28def._%28%28lib._drracket%2Ftool-lib..rkt%29._drracket~3alanguage~3aget-default-mixin%29%29" class="RktValLink" data-pltdoc="x">drracket:language:get-default-mixin</a></span></p></li><li><p><span class="RktSym"><a href="drracket_language.html#%28def._%28%28lib._drracket%2Ftool-lib..rkt%29._drracket~3alanguage~3aget-language-extensions%29%29" class="RktValLink" data-pltdoc="x">drracket:language:get-language-extensions</a></span></p></li></ul></div></p></blockquote></div></p><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.7", "../");" 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.7");">top</a></span><span class="navright"> <a href="Teaching_Languages.html" title="backward to "10 Teaching Languages"" data-pltdoc="x">← prev</a> <a href="index.html" title="up to "DrRacket Plugins"" data-pltdoc="x">up</a> <a href="drracket_get_extend.html" title="forward to "12 drracket:get/extend"" data-pltdoc="x">next →</a></span> </div></div></div><div id="contextindicator"> </div></body></html>
|