/usr/share/doc/racket/drracket/buttons.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 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 | <!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>1.1 Buttons</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="tocviewselflink" data-pltdoc="x">Interface Essentials</a></td></tr><tr><td align="right">2 </td><td><a href="languages.html" class="tocviewlink" 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>1 </td><td><a href="interface-essentials.html" class="tocviewlink" data-pltdoc="x">Interface Essentials</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">1.1 </td><td><a href="" class="tocviewselflink" data-pltdoc="x">Buttons</a></td></tr><tr><td align="right">1.2 </td><td><a href="choose-language.html" class="tocviewlink" data-pltdoc="x">Choosing a Language</a></td></tr><tr><td align="right">1.3 </td><td><a href="editor.html" class="tocviewlink" data-pltdoc="x">Editing with Parentheses</a></td></tr><tr><td align="right">1.4 </td><td><a href="Searching.html" class="tocviewlink" data-pltdoc="x">Searching</a></td></tr><tr><td align="right">1.5 </td><td><a href="Tabbed_Editing.html" class="tocviewlink" data-pltdoc="x">Tabbed Editing</a></td></tr><tr><td align="right">1.6 </td><td><a href="interactions-window.html" class="tocviewlink" data-pltdoc="x">The Interactions Window</a></td></tr><tr><td align="right">1.7 </td><td><a href="Graphical_Syntax.html" class="tocviewlink" data-pltdoc="x">Graphical Syntax</a></td></tr><tr><td align="right">1.8 </td><td><a href="debugger.html" class="tocviewlink" data-pltdoc="x">Graphical Debugging Interface</a></td></tr><tr><td align="right">1.9 </td><td><a href="module-browser.html" class="tocviewlink" data-pltdoc="x">The Module Browser</a></td></tr><tr><td align="right">1.10 </td><td><a href="color-scheme.html" class="tocviewlink" data-pltdoc="x">Color Schemes</a></td></tr><tr><td align="right">1.11 </td><td><a href="create-exe.html" class="tocviewlink" data-pltdoc="x">Creating Executables</a></td></tr><tr><td align="right">1.12 </td><td><a href="follow-log.html" class="tocviewlink" data-pltdoc="x">Following Log Messages</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="interface-essentials.html" title="backward to "1 Interface Essentials"" data-pltdoc="x">← prev</a> <a href="interface-essentials.html" title="up to "1 Interface Essentials"" data-pltdoc="x">up</a> <a href="choose-language.html" title="forward to "1.2 Choosing a Language"" data-pltdoc="x">next →</a></span> </div><h4 x-source-module="(lib "scribblings/drracket/drracket.scrbl")" x-part-tag=""buttons"">1.1<tt> </tt><a name="(part._buttons)"></a>Buttons</h4><p>The left end of the row of buttons in DrRacket contains a miniature
button with the <a name="(idx._(gentag._1._(lib._scribblings/drracket/drracket..scrbl)))"></a>current file’s
name. Clicking the button opens a menu that shows the file’s full
pathname. Selecting one of the menu entries produces an open-file
dialog starting in the corresponding directory.</p><p>Below the filename button is a <a name="(idx._(gentag._2._(lib._scribblings/drracket/drracket..scrbl)))"></a><span class="ssansserif">(define ...)</span>
button for a pop-up menu of names that are defined in the definitions
window. Selecting an item from the menu moves the blinking caret to
the corresponding definition.</p><p>The <a name="(idx._(gentag._3._(lib._scribblings/drracket/drracket..scrbl)))"></a><span class="ssansserif">Save</span> button appears whenever the definitions
window is modified. Clicking the button saves the contents of the
definitions window to a file. The current name of the file appears to
the left of the <span class="ssansserif">Save</span> button, but a file-selection dialog
appears if the file has never been saved before.</p><p>The <a name="(idx._(gentag._4._(lib._scribblings/drracket/drracket..scrbl)))"></a><span class="ssansserif">Step</span> button—<wbr></wbr>which appears only for the
<span style="font-style: italic">How to Design Programs</span> teaching languages <span class="ssansserif">Beginning Student</span> through
<span class="ssansserif">Intermediate Student with Lambda</span>—<wbr></wbr>starts the
<a name="(idx._(gentag._5._(lib._scribblings/drracket/drracket..scrbl)))"></a>Stepper, which shows the evaluation of a program as a
series of small steps. Each evaluation step replaces an expression in
the program with an equivalent one using the evaluation rules of
DrRacket. For example, a step might replace <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="stt"> </span><span class="RktVal">1</span><span class="stt"> </span><span class="RktVal">2</span><span class="RktPn">)</span> with
<span class="RktVal">3</span>. These are the same rules used by DrRacket to evaluate a
program. Clicking <span class="ssansserif">Step</span> opens a new window that contains
the program from the definitions window, plus several new buttons:
these buttons allow navigation of the evaluation as a series of steps.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>The debugging interface is described further in
<a href="debugger.html" data-pltdoc="x">Graphical Debugging Interface</a>, later in this manual.</p></blockquote></blockquote></blockquote><p>The <a name="(idx._(gentag._6._(lib._scribblings/drracket/drracket..scrbl)))"></a><span class="ssansserif">Debug</span> button—<wbr></wbr>which does <span style="font-style: italic">not</span> appear
for the <span style="font-style: italic">How to Design Programs</span> teaching languages—<wbr></wbr>starts a more conventional
stepping <a name="(idx._(gentag._7._(lib._scribblings/drracket/drracket..scrbl)))"></a>debugger. It runs the program in the definitions
window like the <span class="ssansserif">Run</span> button, but also opens a debugging
panel with several other buttons that provide control over the
program’s execution.</p><p>Clicking the <a name="(idx._(gentag._8._(lib._scribblings/drracket/drracket..scrbl)))"></a><span class="ssansserif">Check Syntax</span> button annotates the
program text in the definitions window. It add the following
annotations:</p><ul><li><p><span style="font-weight: bold">Syntactic Highlighting:</span> Imported variables and locally
defined variables are highlighted with color
changes. Documented identifiers are hyperlinked (via a
right-click) to the documentation page.</p></li><li><p><span style="font-weight: bold">Lexical Structure:</span> The lexical structure is shown with
arrows overlaid on the program text. When the mouse cursor
passes over a variable, DrRacket draws an arrow from the
binding location to the variable, or from the binding location
to every bound occurrence of the variable.</p><p><a name="(idx._(gentag._9._(lib._scribblings/drracket/drracket..scrbl)))"></a><a name="(idx._(gentag._10._(lib._scribblings/drracket/drracket..scrbl)))"></a>In addition to indicating
definite references with blue arrows, DrRacket also draws
arrows to indicate potential references within macro
definitions. Potential arrows are drawn in purple and annotated
with a question mark to indicate uncertainty, because DrRacket
cannot predict how such identifiers will eventually be
used. Their roles may depend on the arguments to the macro and
the context the macro is used in.</p><p><a name="(idx._(gentag._11._(lib._scribblings/drracket/drracket..scrbl)))"></a>Additionally, right-clicking (or
Control-clicking on Mac OS X) on a variable activates a
pop-up menu that lets you jump from binding location to bound
location and vice versa, <a name="(idx._(gentag._12._(lib._scribblings/drracket/drracket..scrbl)))"></a>α-rename the
variable, or tack the arrows so they do not disappear.</p></li><li><p><a name="(idx._(gentag._13._(lib._scribblings/drracket/drracket..scrbl)))"></a><span style="font-weight: bold">Tail Calls:</span> Any
sub-expression that is (syntactically) in tail-position with
respect to its enclosing context is annotated by drawing a
light purple arrow from the tail expression to its surrounding
expression.</p></li><li><p><span style="font-weight: bold">Require Annotations:</span> Right-clicking (or
Control-clicking on Mac OS X) on the argument to
<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> activates a pop-up menu that lets you open the
file that contains the <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>d module.</p><p>Passing the mouse cursor over a <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> expression
inside a module shows all of the variables that are used from
that <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> expression. Additionally, if no
variables are used from that require expression, it is colored
like an unbound variable.</p><p>Finally, passing the mouse cursor over a variable that is
imported from a module shows the module that it is imported
from in a status line at the bottom of the frame.</p></li></ul><p>Check Syntax also runs automatically as you edit your program,
and the bottom, rightmost corner of the DrRacket window
shows its status. A red dot means that something has gone wrong;
move your mouse over the dot to find out what is wrong. Mis-matched parentheses indicates
that the buffer’s parens are also mismatched; mouse over the parens for details.</p><p>When nothing goes wrong, the colors indicate the stages processing of the program:
blue (expanding), purple (computing check syntax information), orchid (updating the
editor with the check syntax information), and green (finished).</p><p>Also, right-clicking in that area yields a menu that lets you disable
(or re-eneable) automatic Check Syntax.</p><p>The <a name="(idx._(gentag._14._(lib._scribblings/drracket/drracket..scrbl)))"></a><span class="ssansserif">Run</span> button evaluates the program in the
<a href="interface-essentials.html#%28tech._definitions._window%29" class="techoutside" data-pltdoc="x"><span class="techinside">definitions window</span></a> and resets the <a href="interface-essentials.html#%28tech._interactions._window%29" class="techoutside" data-pltdoc="x"><span class="techinside">interactions window</span></a>.</p><p>The <a name="(idx._(gentag._15._(lib._scribblings/drracket/drracket..scrbl)))"></a><span class="ssansserif">Break</span> button interrupts an evaluation, or
beeps if DrRacket is not evaluating anything. For example, after
clicking <span class="ssansserif">Run</span> or entering an expression into the
interactions window, click <span class="ssansserif">Break</span> to cancel the
evaluation. Click the <span class="ssansserif">Break</span> button once to try to interrupt
the evaluation gracefully; click the button twice to kill the
evaluation immediately.</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.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="interface-essentials.html" title="backward to "1 Interface Essentials"" data-pltdoc="x">← prev</a> <a href="interface-essentials.html" title="up to "1 Interface Essentials"" data-pltdoc="x">up</a> <a href="choose-language.html" title="forward to "1.2 Choosing a Language"" data-pltdoc="x">next →</a></span> </div></div></div><div id="contextindicator"> </div></body></html>
|