/usr/share/doc/racket/drracket/create-exe.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 | <!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.11 Creating Executables</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="buttons.html" class="tocviewlink" 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="" class="tocviewselflink" 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="color-scheme.html" title="backward to "1.10 Color Schemes"" data-pltdoc="x">← prev</a> <a href="interface-essentials.html" title="up to "1 Interface Essentials"" data-pltdoc="x">up</a> <a href="follow-log.html" title="forward to "1.12 Following Log Messages"" data-pltdoc="x">next →</a></span> </div><h4 x-source-module="(lib "scribblings/drracket/drracket.scrbl")" x-part-tag=""create-exe"">1.11<tt> </tt><a name="(part._create-exe)"></a>Creating Executables</h4><p>DrRacket’s <span class="ssansserif">Create Executable...</span> menu item lets you create
an executable for your program that you can start without first
starting DrRacket. To create an executable, first save your program to
a file and set the language and teachpacks. Click <span class="ssansserif">Run</span>,
just to make sure that the program is working as you expect. The
executable you create will not have a read-eval-print-loop, so be sure
to have an expression that starts your program running in the
definitions window before creating the executable.</p><p>Once you are satisfied with your program, choose the <span class="ssansserif">Create
Executable...</span> menu item from the <span class="ssansserif">Racket</span> menu. You will be
asked to choose an executable file name or an archive file name. In
the latter case, unpack the generated archive (on this machine or
another one) to access the executable. In either case, you will be
able to start the executable in the same way that you start any other
program on your computer.</p><p>The result of <span class="ssansserif">Create Executable...</span> is either a
<span style="font-style: italic">launcher executable</span>, a <span style="font-style: italic">stand-alone executable</span>, or
a <span style="font-style: italic">distribution archive</span>, and it uses either a
<span style="font-style: italic">Racket</span> (textual) or <span style="font-style: italic">GRacket</span> (graphical) engine.
For programs implemented with certain languages, <span class="ssansserif">Create
Executable...</span> will prompt you to choose the executable type and
engine, while other languages support only one type or engine.</p><p>Each type has advantages and disadvantages:</p><ul><li><p>A <a name="(tech._launcher._executable)"></a><span style="font-style: italic">launcher executable</span> uses the latest version of
your program source file when it starts. It also accesses library
files from your DrRacket installation when it runs. Since a launcher
executable contains specific paths to access those files, launchers
usually cannot be moved from one machine to another.</p></li><li><p>A <a name="(tech._stand._alone._executable)"></a><span style="font-style: italic">stand-alone executable</span> embeds a compiled copy of
your program and any Racket libraries that your program uses. When
the executable is started, it uses the embedded copies and does not
need your original source file. It may, however, access your DrRacket
installation for DLLs, frameworks, shared libraries, or helper
executables. Consequently, a stand-alone executable usually cannot be
moved from one machine to another.</p></li><li><p>A <a name="(tech._distribution._archive)"></a><span style="font-style: italic">distribution archive</span> packages a stand-alone
executable together with any needed DLLs, frameworks, shared
libraries, and helper executables. A distribution archive can be
unpacked and run on any machine with the same operating system as
yours.</p></li></ul><p>In general, DrRacket’s gives you the most options when it infers a
language from a program’s source. Most other languages only allow one
type of executable. The teaching languages, for example, create
stand-alone executables in distributions. The legacy languages create
only launchers.</p><p><span style="font-weight: bold">Tip:</span> Disable debugging in the language dialog before creating
your executable. With debugging enabled, you will see a stack trace
with error messages, but your program will run more slowly. To
disable debugging, open the language dialog, click the <span class="ssansserif">Show
Details</span> button, and select <span class="ssansserif">No debugging or profiling</span>, if
it is available.</p><p>When you create an executable in some languages, you can supply
additional files to determine the executable’s icon and similar
properties, depending on the platform. The file’s purpose is
determined by its suffix:</p><ul><li><p>On Windows, supply an <span class="stt">".ico"</span> file for an icon. Only
16x16, 32x32, or 48x48 images from the <span class="stt">".ico"</span> file are
used.</p></li><li><p>On Mac OS X, supply an <span class="stt">".icns"</span> file for an icon. You
can set the application’s creator with an <span class="stt">".creator"</span>
file (whose first four bytes are used), and you can set
documents for the application through a <span class="stt">".utiexports"</span>
file (see <span class="RktVal">'</span><span class="RktVal">uti-exports</span> in
<span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=raco&rel=exe.html%23%2528def._%2528%2528lib._compiler%252Fembed..rkt%2529._create-embedding-executable%2529%2529&version=6.1" class="RktValLink Sq" data-pltdoc="x">create-embedding-executable</a></span> for more information).</p></li><li><p>On Unix, supply a <span class="stt">".png"</span> or <span class="stt">".ico"</span> file for
an icon.</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="color-scheme.html" title="backward to "1.10 Color Schemes"" data-pltdoc="x">← prev</a> <a href="interface-essentials.html" title="up to "1 Interface Essentials"" data-pltdoc="x">up</a> <a href="follow-log.html" title="forward to "1.12 Following Log Messages"" data-pltdoc="x">next →</a></span> </div></div></div><div id="contextindicator"> </div></body></html>
|