/usr/share/doc/racket/demo-manual-s1/index.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 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 | <!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>S1 Manual All-Styles Document</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="../scribble-style.css" title="default"/><script type="text/javascript" src="../scribble-common.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="" class="tocviewselflink" data-pltdoc="x">S1 Manual All-<wbr></wbr>Styles Document</a></td></tr></table></div><div class="tocviewsublistonly" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1 </td><td><a href="#%28part._.Code_.Styles%29" class="tocviewlink" data-pltdoc="x">Code Styles</a></td></tr><tr><td align="right">2 </td><td><a href="#%28part._.Definition_.Blocks%29" class="tocviewlink" data-pltdoc="x">Definition Blocks</a></td></tr><tr><td align="right">3 </td><td><a href="#%28part._bitmap-dc_%29" class="tocviewlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bitmap-<wbr></wbr>dc%</span></span></a></td></tr><tr><td align="right">4 </td><td><a href="#%28part._.Miscellaneous%29" class="tocviewlink" data-pltdoc="x">Miscellaneous</a></td></tr><tr><td align="right">5 </td><td><a href="#%28part._.Bibliography%29" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="#%28part._doc-bibliography%29" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr></table></div></div></div><div class="tocsub"><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber"></span><a href="#%28part._top%29" class="tocsubseclink" data-pltdoc="x">S1 Manual All-<wbr></wbr>Styles Document</a></td></tr><tr><td><span class="tocsublinknumber">1<tt> </tt></span><a href="#%28part._.Code_.Styles%29" class="tocsubseclink" data-pltdoc="x">Code Styles</a></td></tr><tr><td><span class="tocsublinknumber">2<tt> </tt></span><a href="#%28part._.Definition_.Blocks%29" class="tocsubseclink" data-pltdoc="x">Definition Blocks</a></td></tr><tr><td><span class="tocsublinknumber">3<tt> </tt></span><a href="#%28part._bitmap-dc_%29" class="tocsubseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bitmap-<wbr></wbr>dc%</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4<tt> </tt></span><a href="#%28part._.Miscellaneous%29" class="tocsubseclink" data-pltdoc="x">Miscellaneous</a></td></tr><tr><td><span class="tocsublinknumber">5<tt> </tt></span><a href="#%28part._.Bibliography%29" class="tocsubseclink" data-pltdoc="x">Bibliography</a></td></tr><tr><td><span class="tocsublinknumber"></span><a href="#%28part._doc-bibliography%29" class="tocsubseclink" data-pltdoc="x">Bibliography</a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="versionbox"><span class="versionNoNav">6.1</span></div><h2 x-source-module="(lib "scribblings/scribble/demo-manual-s1.scrbl")" x-part-tag=""top""><a name="(part._top)"></a><a name="(part._.Manual_.All-.Styles_.Document)"></a>S1 Manual All-Styles Document</h2><table cellspacing="0" cellpadding="0"><tr><td><p><span class="hspace"> </span><a href="#%28part._.Code_.Styles%29" class="toptoclink" data-pltdoc="x">1<span class="hspace"> </span>Code Styles</a></p></td></tr><tr><td><p><span class="hspace"></span></p></td></tr><tr><td><p><span class="hspace"> </span><a href="#%28part._.Definition_.Blocks%29" class="toptoclink" data-pltdoc="x">2<span class="hspace"> </span>Definition Blocks</a></p></td></tr><tr><td><p><span class="hspace"></span></p></td></tr><tr><td><p><span class="hspace"> </span><a href="#%28part._bitmap-dc_%29" class="toptoclink" data-pltdoc="x">3<span class="hspace"> </span><span class="RktSym"><span class="RktValLink">bitmap-dc%</span></span></a></p></td></tr><tr><td><p><span class="hspace"></span></p></td></tr><tr><td><p><span class="hspace"> </span><a href="#%28part._.Miscellaneous%29" class="toptoclink" data-pltdoc="x">4<span class="hspace"> </span>Miscellaneous</a></p></td></tr><tr><td><p><span class="hspace"></span></p></td></tr><tr><td><p><span class="hspace"> </span><a href="#%28part._.Bibliography%29" class="toptoclink" data-pltdoc="x">5<span class="hspace"> </span>Bibliography</a></p></td></tr><tr><td><p><span class="hspace"></span></p></td></tr><tr><td><p><span class="hspace"> </span><a href="#%28part._doc-bibliography%29" class="toptoclink" data-pltdoc="x">Bibliography</a></p></td></tr></table><h3 x-source-module="(lib "scribblings/scribble/demo-manual-s1.scrbl")" x-part-tag=""Code_Styles"">1<tt> </tt><a name="(part._.Code_.Styles)"></a>Code Styles</h3><ul><li><p><span class="stt">RktSym</span> (identifier without <span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=reference&rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-label%2529%2529&version=6.1" class="RktStxLink Sq" data-pltdoc="x">for-label</a></span> binding):
<span class="RktSym">unbound</span> or <span class="RktSym">example</span></p></li><li><p><span class="stt">RktValLink</span> (link to variable form): <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></p></li><li><p><span class="stt">RktValDef</span> (definition of variable, normally combined with <span class="stt">RktValLink</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._list%2529%2529&version=6.1" class="RktValLink Sq" data-pltdoc="x">list</a></span> in</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><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._list%2529%2529&version=6.1" class="RktValDef Sq RktValLink" data-pltdoc="x">list</a></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace"> </span>→<span class="hspace"> </span><span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=reference&rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%252Fc%2529%2529&version=6.1" class="RktValLink Sq" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr></table></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>value</p></div></div><p class="RForeground"><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._list%2529%2529&version=6.1" class="RktValDef Sq RktValLink" data-pltdoc="x">list</a></span><span class="hspace"> </span>:<span class="hspace"> </span><span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=reference&rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%252Fc%2529%2529&version=6.1" class="RktValLink Sq" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr></table></blockquote></div></p></li><li><p><span class="stt">RktStxLink</span> (link to syntactic form): <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._lambda%2529%2529&version=6.1" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span></p></li><li><p><span class="stt">RktStxDef</span> (definition of syntactic form, normally combined with <span class="stt">RktStxLink</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._lambda%2529%2529&version=6.1" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span> in</p><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><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._lambda%2529%2529&version=6.1" class="RktStxDef Sq RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace"> </span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></li><li><p><span class="stt">RktSymDef</span> (definition without binding, normally a mistake, combined with <span class="stt">RktSym</span>):
<span class="RktSym">unbound-identifier</span> in</p><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><span class="RktSym"><span class="RktSymDef RktSym">unbound-identifier</span></span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></li><li><p><span class="stt">RktVar</span> (local variable or meta-variable): <span class="RktVar">variable</span> or <span class="RktVar">example</span></p></li><li><p><span class="stt">RktRes</span> (REPL result): <span class="RktRes">'(1<span class="stt"> </span>2<span class="stt"> </span>3)</span> or <span class="RktRes">example</span></p></li><li><p><span class="stt">RktOut</span> (as written to the current output port): <span class="RktOut">example</span></p></li><li><p><span class="stt">RktErr</span> (errors): <span class="RktErr">example</span> or the error message in</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><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=reference&rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&version=6.1" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace"> </span><span class="RktVal">1</span><span class="hspace"> </span><span class="RktVal">'</span><span class="RktVal">a</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">+: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace"> </span><span class="RktErr">expected: number?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace"> </span><span class="RktErr">given: 'a</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace"> </span><span class="RktErr">argument position: 2nd</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace"> </span><span class="RktErr">other arguments...:</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace"> </span><span class="RktErr"></span><span class="hspace"> </span><span class="RktErr">1</span></p></td></tr></table></blockquote></li><li><p><span class="stt">RktCmt</span> (comments): <span class="RktCmt">example</span> or</p><blockquote class="SCodeFlow"><p><span class="RktCmt">;</span><span class="RktCmt"> </span><span class="RktCmt">comment</span></p></blockquote></li><li><p><span class="stt">RktVal</span> (values): <span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="stt"> </span><span class="RktVal">2</span><span class="stt"> </span><span class="RktVal">3</span><span class="RktVal">)</span> or <span class="RktVal">example</span></p></li><li><p><span class="stt">highlighted</span> (highlight via background): <span class="RktPn">(</span><span class="RktSym">not-this</span><span class="stt"> </span><span class="highlighted"><span class="RktSym">example</span></span><span class="stt"> </span><span class="RktSym">nor-this</span><span class="RktPn">)</span></p></li><li><p><span class="stt">RktIn</span> on a <span class="stt">RktInBG</span>: <span class="RktInBG"><span class="hspace"></span><span class="RktIn">example</span><span class="hspace"></span></span></p></li><li><p><span class="stt">RktPn</span> (parentheses, etc.): <span class="RktPn">(</span><span class="RktPn">[</span><span class="RktPn">{</span><span class="RktPn">}</span><span class="RktPn">]</span><span class="RktPn">)</span> or <span class="RktPn">example</span></p></li><li><p><span class="stt">RktRdr</span> (reader shorthands): non-parentheses in <span class="RktPn">(</span><span class="RktRdr">#`</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace"> </span><span class="RktRdr">,@</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="RktPn">)</span></p></li><li><p><span class="stt">RktMeta</span> (the <span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=reference&rel=quasiquote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._unquote%2529%2529&version=6.1" class="RktStxLink Sq" data-pltdoc="x">unquote</a></span> comma):
<span class="RktRdr">,</span><span class="RktVal">1</span> or <span class="RktMeta">example</span> or “#reader” below.</p><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace"> </span><span class="RktMeta">#reader</span><span class="hspace"> </span><span class="RktSym">module</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller"> package:</span> <span class="stt">base</span></span></td></tr></table></li><li><p><span class="stt">RktMod</span> (module name; normally <span class="stt">RktModLink</span> instead): <span class="RktMod">example</span></p></li><li><p><span class="stt">RktModLink</span> (a linked module reference): <a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=reference&rel=index.html&version=6.1" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/base</span></a></p></li><li><p><span class="stt">RktOpt</span> (option-argument brackets): brackets in <span class="RktOpt">[</span><span class="RktSym">in-example</span><span class="RktOpt">]</span></p></li><li><p><span class="stt">RktKw</span> (not normally used): <span class="RktKw">example</span></p></li></ul><p>The <span class="stt">RktBlk</span> style class is used for a table of multiple lines (more
than 1) of Racket code:</p><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=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&version=6.1" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace"> </span><span class="RktSym">x</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=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&version=6.1" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace"> </span><span class="RktVal">1</span><span class="hspace"> </span><span class="RktVal">2</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=reference&rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&version=6.1" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace"> </span><span class="RktSym">x</span><span class="hspace"> </span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr></table></blockquote><h3 x-source-module="(lib "scribblings/scribble/demo-manual-s1.scrbl")" x-part-tag=""Definition_Blocks"">2<tt> </tt><a name="(part._.Definition_.Blocks)"></a>Definition Blocks</h3><p><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><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=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&version=6.1" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=reference&rel=index.html&version=6.1" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/base</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller"> package:</span> <span class="stt">base</span></span></td></tr></table></p><p>The module-declaration box above is in a <span class="stt">defmodule</span> table. The
package-specification part is in an <span class="stt">RpackageSpec</span> wrapper.</p><p>The definitions below are marked so that they are not link targets. If
they were link targets, the table-of-contents panel on the left would
have entries for them.</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><table cellspacing="0" cellpadding="0" class="prototype RForeground"><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=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&version=6.1" class="RktValDef Sq RktValLink" data-pltdoc="x">cons</a></span></td><td><span class="hspace"> </span></td><td><span class="RktVar">really-long-name-for-the-first-argument</span></td><td><span class="hspace"> </span></td><td><span class="hspace"> </span></td><td><span class="hspace"> </span></td><td><span class="hspace"> </span></td></tr><tr><td><span class="hspace"> </span></td><td><span class="hspace"> </span></td><td><span class="RktVar">really-long-name-for-the-second-argument</span><span class="RktPn">)</span></td><td><span class="hspace"> </span></td><td>→</td><td><span class="hspace"> </span></td><td><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._pair%7E3f%2529%2529&version=6.1" class="RktValLink Sq" data-pltdoc="x">pair?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">really-long-name-for-the-first-argument</span><span class="hspace"> </span>:<span class="hspace"> </span><span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=reference&rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%252Fc%2529%2529&version=6.1" class="RktValLink Sq" data-pltdoc="x">any/c</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td><span class="hspace"> </span></td><td><span class="RktVar">really-long-name-for-the-second-argument</span></td><td><span class="hspace"> </span></td><td>:</td><td><span class="hspace"> </span></td><td><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=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._or%252Fc%2529%2529&version=6.1" class="RktValLink Sq" data-pltdoc="x">or/c</a></span><span class="hspace"> </span><span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=reference&rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%252Fc%2529%2529&version=6.1" class="RktValLink Sq" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace"> </span><span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=reference&rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%252Fc%2529%2529&version=6.1" class="RktValLink Sq" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">This definition box starts with a <span class="stt">SVInsetFlow</span> wrapper, which is a
<a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=scribble&rel=base.html&version=6.1" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">scribble/base</span></a> style class for the
<span class="RktVal">'</span><span class="RktVal">vertical-inset</span> style name on a block; it should give the
block suitable vertical space before and after.</div></p><p>The next layer is a <span class="stt">boxed</span> plus <span class="stt">RBoxed</span> table. The <span class="stt">boxed</span>
style class is from <a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=scribble&rel=base.html&version=6.1" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">scribble/base</span></a> and the
<span class="RktVal">'</span><span class="RktVal">boxed</span> style name on a table. The <span class="stt">RBoxed</span> style class is
from the <span class="RktSym">scribble/manual</span> layer. Both <span class="stt">boxed</span> and <span class="stt">RBoxed</span>
are used for all definition boxes by <span class="RktSym">scribble/manual</span> forms.</p><p>The initial content of the table includes a <span class="stt">SubFlow</span> (a
<span class="RktSym">scribble/base</span> style class for non-indented flow) to combine
blocks for the background label with the first line of the table. The
background label “procedure” has an <span class="stt">RBackgroundLabel</span> outer
wrapper, which makes the label float right. (The wrapper also has the
<span class="stt">SIEHidden</span> style class, which built-in for all Scribble HTML output
and makes the label hidden on Internet Explorer 6 and earlier.) The
background label has an <span class="stt">RBackgroundLabelInner</span> inner wrapper, which
makes the label suitably faint. The content part of the first line is
wrapped in <span class="stt">RForeground</span>, which ensures that it is in front of the
background label.</p><p>In a procedure definition box:</p><ul><li><p>When the initial “prototype” call in the definition box spans
multiple lines, the table that contains the call has the
<span class="stt">prototype</span> style class in addition to <span class="stt">RForeground</span>.</p></li><li><p>When the contract or default value for an argument spans
multiple lines, then the contract, the “=” for a value (if
any), and value (if any) are wrapped in an table with the
<span class="stt">argcontract</span> style class.</p></li></ul><p>Finally, the definition box and all of the associated explanation text
are wrapped in <span class="stt">SIntrapara</span> blocks and grouped into a single
<span class="stt"><p></span>.</p><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><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._lambda%2529%2529&version=6.1" class="RktStxDef Sq RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace"> </span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="stt"> </span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">example</span></td><td align="left" valign="baseline"><span class="stt"> </span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt"> </span></td><td align="left" valign="baseline"><span class="RktVar">good</span></td></tr><tr><td align="right" valign="baseline"><span class="stt"> </span></td><td align="left" valign="baseline"><span class="stt"> </span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt"> </span></td><td align="left" valign="baseline"><span class="RktVar">bad</span></td></tr></table></td></tr></table></blockquote><p>When a syntactic-from specification has a grammar, the grammar is in a
table with the <span class="stt">specgrammar</span> style class.</p><p>Since no explanation flow is attached to the above <span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=scribble&rel=doc-forms.html%23%2528form._%2528%2528lib._scribble%252Fmanual..rkt%2529._defform%2529%2529&version=6.1" class="RktStxLink Sq" data-pltdoc="x">defform</a></span> use,
there’s no <span class="stt">SIntrapara</span> block around the table (just a <span class="stt"><p></span>).</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><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="RktValDef Sq RktValLink" data-pltdoc="x">cons</a></span><span class="hspace"> </span><span class="RktVar">a</span><span class="hspace"> </span><span class="RktVar">d</span><span class="RktPn">)</span><span class="hspace"> </span>→<span class="hspace"> </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._pair%7E3f%2529%2529&version=6.1" class="RktValLink Sq" data-pltdoc="x">pair?</a></span></p></blockquote></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">a</span><span class="hspace"> </span>:<span class="hspace"> </span><span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=reference&rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%252Fc%2529%2529&version=6.1" class="RktValLink Sq" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">d</span><span class="hspace"> </span>:<span class="hspace"> </span><span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=reference&rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%252Fc%2529%2529&version=6.1" class="RktValLink Sq" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><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._lambda%2529%2529&version=6.1" class="RktStxDef Sq RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace"> </span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Putting definitions together with <span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=scribble&rel=doc-forms.html%23%2528form._%2528%2528lib._scribble%252Fmanual..rkt%2529._deftogether%2529%2529&version=6.1" class="RktStxLink Sq" data-pltdoc="x">deftogether</a></span> converts the
<span class="stt">RBoxed</span> and <span class="stt">boxed</span> tables that would be generated for the
individual definitions into tables with the <span class="stt">together</span> style
class. The tables are then combined as rows in a new table with the
<span class="stt">RBoxed</span> and <span class="stt">boxed</span> style classes.</div></p><p>A <span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=scribble&rel=doc-forms.html%23%2528form._%2528%2528lib._scribble%252Fmanual..rkt%2529._defsubform%2529%2529&version=6.1" class="RktStxLink Sq" data-pltdoc="x">defsubform</a></span>, <span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=scribble&rel=doc-forms.html%23%2528form._%2528%2528lib._scribble%252Fmanual..rkt%2529._specsubform%2529%2529&version=6.1" class="RktStxLink Sq" data-pltdoc="x">specsubform</a></span>, etc., such as</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktVar">lambda</span><span class="hspace"> </span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote><p>is indented though a wrapper with a <span class="stt">leftindent</span> style class.</p><a name="(part._bitmap-dc_)"></a><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>class</p></div></div><p class="RForeground"><span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=draw&rel=bitmap-dc_.html&version=6.1" class="RktValLink Sq" data-pltdoc="x">bitmap-dc%</a></span><span class="hspace"> </span>:<span class="hspace"> </span><span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=reference&rel=objectutils.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._class%7E3f%2529%2529&version=6.1" class="RktValLink Sq" data-pltdoc="x">class?</a></span></p></blockquote></td></tr><tr><td><p><span class="hspace"> </span>superclass:<span class="hspace"> </span><span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=reference&rel=createclass.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._object%7E25%2529%2529&version=6.1" class="RktValLink Sq" data-pltdoc="x">object%</a></span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><span class="hspace"> </span>extends:<span class="hspace"> </span></td><td><span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=draw&rel=dc___.html&version=6.1" class="RktValLink Sq" data-pltdoc="x">dc<%></a></span></td></tr></table></td></tr></table></div><div class="SIntrapara">In multi-page mode, this class definition gets its own page, and
there’s an “inherited methods” table in the margin. The table has
style class <span class="stt">inherited</span>, and the words “inherited methods:” and
“from” have style class <span class="stt">inheritedlbl</span>.</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>method</p></div></div><p class="RForeground"><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=ivaraccess.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._send%2529%2529&version=6.1" class="RktStxLink Sq" data-pltdoc="x">send</a></span><span class="hspace"> </span><span class="RktVar">a-bitmap-dc</span><span class="hspace"> </span><span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=draw&rel=bitmap-dc_.html%23%2528meth._%2528%2528%2528lib._racket%252Fdraw..rkt%2529._bitmap-dc%7E25%2529._set-bitmap%2529%2529&version=6.1" class="RktValDef Sq RktValLink" data-pltdoc="x">set-bitmap</a></span><span class="hspace"> </span><span class="RktVar">bm</span><span class="RktPn">)</span><span class="hspace"> </span>→<span class="hspace"> </span><span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=reference&rel=data-structure-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%2529%2529&version=6.1" class="RktStxLink Sq" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">bm</span><span class="hspace"> </span>:<span class="hspace"> </span><span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=reference&rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%252Fc%2529%2529&version=6.1" class="RktValLink Sq" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A method example; nothing new here, but note how the defined
identifier is not at the start of the box.
</div><div class="SIntrapara"></div></p><h3 x-source-module="(lib "scribblings/scribble/demo-manual-s1.scrbl")" x-part-tag=""Miscellaneous"">4<tt> </tt><a name="(part._.Miscellaneous)"></a>Miscellaneous</h3><p>In <span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=scribble&rel=Miscellaneous.html%23%2528def._%2528%2528lib._scribble%252Fmanual..rkt%2529._filebox%2529%2529&version=6.1" class="RktValLink Sq" data-pltdoc="x">filebox</a></span> rendering,</p><blockquote class="Rfilebox"><p class="Rfiletitle"><span class="Rfilename"><span class="stt">"example.rkt"</span></span></p><blockquote class="Rfilecontent"><p>This is a file box</p></blockquote></blockquote><p>a <span class="stt">Rfilebox</span> wrapper surrounds the file name in a <span class="stt">Rfiletitle</span>
outer wrapper and an <span class="stt">Rfilename</span> inner wrapper, plus the file
content in an <span class="stt">Rfilecontent</span> wrapper.</p><blockquote class="insetpara"><p>The <span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=scribble&rel=Miscellaneous.html%23%2528def._%2528%2528lib._scribble%252Fmanual..rkt%2529._inset-flow%2529%2529&version=6.1" class="RktValLink Sq" data-pltdoc="x">inset-flow</a></span> form generates a
<span class="RktSym">nested-flow</span> with style class <span class="stt">insetpara</span>.</p></blockquote><p class="SHistory">Changed in version 1.0: History paragraphs have the <span class="stt">SHistory</span> style class.</p><h3 x-source-module="(lib "scribblings/scribble/demo-manual-s1.scrbl")" x-part-tag=""Bibliography"">5<tt> </tt><a name="(part._.Bibliography)"></a>Bibliography</h3><p>The bibliography table for the citation [<a href="#%28cite._.Example%29" data-pltdoc="x">Example</a>] as the
<span class="stt">RBibliography</span> style class.</p><h3 x-source-module="(lib "scribblings/scribble/demo-manual-s1.scrbl")" x-part-tag=""doc-bibliography""><a name="(part._doc-bibliography)"></a>Bibliography</h3><p><table cellspacing="0" cellpadding="0" class="RBibliography"><tr><td><a name="(cite._.Example)"></a>[Example]</td><td><span class="hspace"> </span></td><td><span class="bibentry">“Example bibliography entry.”</span></td></tr></table></p></div></div><div id="contextindicator"> </div></body></html>
|