This file is indexed.

/usr/share/doc/racket/scribble/running.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
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
<!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>7&nbsp;Running scribble</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="../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="../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,&quot;tocview_0&quot;);">&#9660;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">Scribble:<span class="mywbr"> &nbsp;</span> The Racket Documentation Tool</a></td></tr></table></div><div class="tocviewsublisttop" style="display: block;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="getting-started.html" class="tocviewlink" data-pltdoc="x">Getting Started</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="reader.html" class="tocviewlink" data-pltdoc="x">@ Syntax</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="generic-prose.html" class="tocviewlink" data-pltdoc="x">High-<wbr></wbr>Level Scribble API</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="plt-manuals.html" class="tocviewlink" data-pltdoc="x">Scribbling Documentation</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="lp.html" class="tocviewlink" data-pltdoc="x">Literate Programming</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="internals.html" class="tocviewlink" data-pltdoc="x">Low-<wbr></wbr>Level Scribble API</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="" class="tocviewselflink" data-pltdoc="x">Running <span class="stt">scribble</span></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,&quot;tocview_1&quot;);">&#9658;</a></td><td>7&nbsp;</td><td><a href="" class="tocviewselflink" data-pltdoc="x">Running <span class="stt">scribble</span></a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">7.1&nbsp;</td><td><a href="#%28part._.Extra_and_.Format-.Specific_.Files%29" class="tocviewlink" data-pltdoc="x">Extra and Format-<wbr></wbr>Specific Files</a></td></tr><tr><td align="right">7.2&nbsp;</td><td><a href="#%28part._xref-flags%29" class="tocviewlink" data-pltdoc="x">Handling Cross-<wbr></wbr>References</a></td></tr><tr><td align="right">7.3&nbsp;</td><td><a href="#%28part._.Selecting_an_.Image_.Format%29" class="tocviewlink" data-pltdoc="x">Selecting an Image Format</a></td></tr><tr><td align="right">7.4&nbsp;</td><td><a href="#%28part._.Passing_.Command-.Line_.Arguments_to_.Documents%29" class="tocviewlink" data-pltdoc="x">Passing Command-<wbr></wbr>Line Arguments to Documents</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">7.1<tt>&nbsp;</tt></span><a href="#%28part._.Extra_and_.Format-.Specific_.Files%29" class="tocsubseclink" data-pltdoc="x">Extra and Format-<wbr></wbr>Specific Files</a></td></tr><tr><td><span class="tocsublinknumber">7.2<tt>&nbsp;</tt></span><a href="#%28part._xref-flags%29" class="tocsubseclink" data-pltdoc="x">Handling Cross-<wbr></wbr>References</a></td></tr><tr><td><span class="tocsublinknumber">7.3<tt>&nbsp;</tt></span><a href="#%28part._.Selecting_an_.Image_.Format%29" class="tocsubseclink" data-pltdoc="x">Selecting an Image Format</a></td></tr><tr><td><span class="tocsublinknumber">7.4<tt>&nbsp;</tt></span><a href="#%28part._.Passing_.Command-.Line_.Arguments_to_.Documents%29" class="tocsubseclink" data-pltdoc="x">Passing Command-<wbr></wbr>Line Arguments to Documents</a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="versionbox"><span class="version">6.1</span></div><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, &quot;6.1&quot;, &quot;../&quot;);" onfocus="this.style.color=&quot;black&quot;; this.style.textAlign=&quot;left&quot;; if (this.value == &quot;...search manuals...&quot;) this.value=&quot;&quot;;" onblur="if (this.value.match(/^ *$/)) { this.style.color=&quot;#888&quot;; this.style.textAlign=&quot;center&quot;; this.value=&quot;...search manuals...&quot;; }"/></form>&nbsp;&nbsp;<a href="../index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;6.1&quot;);">top</a></span><span class="navright">&nbsp;&nbsp;<a href="latex-prefix.html" title="backward to &quot;6.10.6 Latex Prefix Support&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;Scribble: The Racket Documentation Tool&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="doc-index.html" title="forward to &quot;Index&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h3 x-source-module="(lib &quot;scribblings/scribble/scribble.scrbl&quot;)" x-part-tag="&quot;running&quot;">7<tt>&nbsp;</tt><a name="(part._running)"></a>Running <span class="stt">scribble</span></h3><p>The <span class="stt">scribble</span> command-line tool (also available as <a name="(idx._(gentag._79._(lib._scribblings/scribble/scribble..scrbl)))"></a><span class="stt">raco
scribble</span>) runs a Scribble document and renders it to a specific
format. Select a format with one of the following flags, where the
output name <span style="font-style: italic">fn</span> is by default the document source name without
its file suffix:</p><ul><li><p><span class="nobreak"><span class="stt">--html</span></span> &#8212;<wbr></wbr> a single HTML page <span class="stt">"<span style="font-style: italic">fn</span>.html"</span>,
plus CSS sources and needed image files; this mode is the
default if no format is specified</p></li><li><p><span class="nobreak"><span class="stt">--htmls</span></span> &#8212;<wbr></wbr> multiple HTML pages (and associated files) in
a <span class="stt">"<span style="font-style: italic">fn</span>"</span> directory, starting with
<span class="stt">"<span style="font-style: italic">fn</span>/index.html"</span></p></li><li><p><span class="nobreak"><span class="stt">--html-tree</span></span> <span class="sroman">&#8249;<span style="font-style: italic">n</span>&#8250;</span> &#8212;<wbr></wbr> HTML pages in a directory
tree up to <span class="sroman">&#8249;<span style="font-style: italic">n</span>&#8250;</span> layers deep; a tree of depth <span class="stt">0</span> is
equivalent to using <span class="nobreak"><span class="stt">--html</span></span>, and a tree of depth <span class="stt">1</span>
is equivalent to using <span class="nobreak"><span class="stt">--htmls</span></span></p></li><li><p><span class="nobreak"><span class="stt">--latex</span></span> &#8212;<wbr></wbr> LaTeX source <span class="stt">"<span style="font-style: italic">fn</span>.tex"</span>, plus
any needed additional files (such as non-standard class files)
needed to run <span class="stt">latex</span> or <span class="stt">pdflatex</span></p></li><li><p><span class="nobreak"><span class="stt">--pdf</span></span> &#8212;<wbr></wbr> PDF <span class="stt">"<span style="font-style: italic">fn</span>.pdf"</span> that is generated
via <span class="stt">pdflatex</span></p></li><li><p><span class="nobreak"><span class="stt">--dvipdf</span></span> &#8212;<wbr></wbr> PDF <span class="stt">"<span style="font-style: italic">fn</span>.pdf"</span> that is generated
via <span class="stt">latex</span>, <span class="stt">dvips</span>, and <span class="stt">pstopdf</span></p></li><li><p><span class="nobreak"><span class="stt">--latex-section</span></span> <span class="sroman">&#8249;<span style="font-style: italic">n</span>&#8250;</span> &#8212;<wbr></wbr> LaTeX source
<span class="stt">"<span style="font-style: italic">fn</span>.tex"</span> plus additional <span class="stt">".tex"</span> files to
be included in the enclosing document&rsquo;s preamble, where the
enclosing document must use the UTF-8 input encoding and T1
font encoding; use <span class="stt">1</span> for <span class="sroman">&#8249;<span style="font-style: italic">n</span>&#8250;</span> to make the rendered
document a section, <span class="stt">2</span> for a subsection, etc.</p></li><li><p><span class="nobreak"><span class="stt">--text</span></span> &#8212;<wbr></wbr> plain text in a single file
<span class="stt">"<span style="font-style: italic">fn</span>.txt"</span>, with non-ASCII content encoded as UTF-8</p></li><li><p><span class="nobreak"><span class="stt">--markdown</span></span> &#8212;<wbr></wbr> Markdown text in a single file
<span class="stt">"<span style="font-style: italic">fn</span>.md"</span>, with non-ASCII content encoded as UTF-8</p></li></ul><p>Use <span class="nobreak"><span class="stt">--dest-name</span></span> to specify a <span style="font-style: italic">fn</span> other than the default name,
but only when a single source file is provided. Use the <span class="nobreak"><span class="stt">--dest</span></span>
flag to specify a destination directory (for any number of source
files). Use <span class="nobreak"><span class="stt">--dest-base</span></span> to add a prefix to the name of each
support file that is generated or copied to the destination.</p><p>After all flags, provide one or more document sources, where each
source declares a module. The module should either have a <span class="RktSym">doc</span>
<a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=reference&amp;rel=eval-model.html%23%2528tech._submodule%2529&amp;version=6.1" class="techoutside Sq" data-pltdoc="x"><span class="techinside">submodule</span></a>
that exports <span class="RktSym">doc</span> as a <span class="RktSym"><a href="core.html#%28def._%28%28lib._scribble%2Fcore..rkt%29._part%29%29" class="RktValLink" data-pltdoc="x">part</a></span>, or it should directly
export <span class="RktSym">doc</span> as a <span class="RktSym"><a href="core.html#%28def._%28%28lib._scribble%2Fcore..rkt%29._part%29%29" class="RktValLink" data-pltdoc="x">part</a></span>. (The submodule is tried first,
and the main module is not directly loaded or evaluated if the
submodule can be loaded on its own.)</p><p>When multiple documents are rendered at the same time, cross-reference
information in one document is visible to the other documents. See
<a href="#%28part._xref-flags%29" data-pltdoc="x">Handling Cross-References</a> for information on references that cross
documents that are built separately.</p><p class="SHistory">Changed in version 1.4: Added <span class="nobreak"><span class="stt">--dvipdf</span></span>.</p><h4 x-source-module="(lib &quot;scribblings/scribble/scribble.scrbl&quot;)" x-part-tag="&quot;Extra_and_Format-Specific_Files&quot;">7.1<tt>&nbsp;</tt><a name="(part._.Extra_and_.Format-.Specific_.Files)"></a>Extra and Format-Specific Files</h4><p>Use the <span class="nobreak"><span class="stt">--style</span></span> flag to specify a format-specific file to adjust
the output style file for certain formats. For HTML (single-page or
multi-page) output, the style file should be a CSS file that is
applied after all other CSS files, and that may therefore override
some style properties. For Latex (or PDF) output, the style file
should be a <span class="stt">".tex"</span> file that can redefine Latex commands.
When a particular Scribble function needs particular CSS or Latex
support, however, a better option is to use a <span class="RktSym"><a href="core.html#%28def._%28%28lib._scribble%2Fhtml-properties..rkt%29._css-addition%29%29" class="RktValLink" data-pltdoc="x">css-addition</a></span> or
<span class="RktSym"><a href="core.html#%28def._%28%28lib._scribble%2Flatex-properties..rkt%29._tex-addition%29%29" class="RktValLink" data-pltdoc="x">tex-addition</a></span> style property so that the support is included
automatically; see <a href="config.html" data-pltdoc="x">Extending and Configuring Scribble Output</a> for more information.</p><p>In rare cases, use the <span class="nobreak"><span class="stt">--style</span></span> flag to specify a format-specific
base style file. For HTML (single-page or multi-page) output, the
style file should be a CSS file to substitute for
<span class="stt">"scribble.css"</span> in the <span class="stt">"scribble"</span> collection. For
Latex (or PDF) output, the style file should be a <span class="stt">".tex"</span> file
to substitute for <span class="stt">"scribble.tex"</span> in the <span class="stt">"scribble"</span>
collection. The <span class="nobreak"><span class="stt">--style</span></span> flag is rarely useful, because the
content of <span class="stt">"scribble.css"</span> or <span class="stt">"scribble.tex"</span> is
weakly specified; replacements must define all of the same styles, and
the set of styles can change across versions of Racket.</p><p>Use <span class="nobreak"><span class="stt">--prefix</span></span> to specify an alternate format-specific start of
the output file. For HTML output, the starting file specifies the
<span class="stt">DOCTYPE</span> declaration of each output HTML file as a substitute for
<span class="stt">"scribble-prefix.html"</span> in the <span class="stt">"scribble"</span>
collection. For Latex (or PDF) output (but not Latex-section output), the starting file specifies
the <span class="stt">\documentclass</span> declaration and initial <span class="stt">\usepackage</span>
declarations as a substitute for <span class="stt">"scribble-prefix.tex"</span> in the
<span class="stt">"scribble"</span> collection. See also <span class="RktSym"><a href="core.html#%28def._%28%28lib._scribble%2Fhtml-properties..rkt%29._html-defaults%29%29" class="RktValLink" data-pltdoc="x">html-defaults</a></span>,
<span class="RktSym"><a href="core.html#%28def._%28%28lib._scribble%2Flatex-properties..rkt%29._latex-defaults%29%29" class="RktValLink" data-pltdoc="x">latex-defaults</a></span>, and <a href="config.html" data-pltdoc="x">Extending and Configuring Scribble Output</a>.</p><p>For any output form, use the <span class="nobreak"><span class="stt">++extra</span></span> flag to add a needed file
to the build destination, such as an image file that is referenced in
the generated output but not included via <span class="RktSym"><a href="base.html#%28def._%28%28lib._scribble%2Fbase..rkt%29._image%29%29" class="RktValLink" data-pltdoc="x">image</a></span> (which copies
the file automatically).</p><h4 x-source-module="(lib &quot;scribblings/scribble/scribble.scrbl&quot;)" x-part-tag="&quot;xref-flags&quot;">7.2<tt>&nbsp;</tt><a name="(part._xref-flags)"></a>Handling Cross-References</h4><p>Cross references within a document or documents rendered together are
always resolved. When cross references span documents that are
rendered separately, cross-reference information needs to be saved and
loaded explicitly. Cross-reference information is format-specific, but
HTML-format information is usable for Latex (or PDF) or text rendering.</p><p>A Racket installation includes HTML-format cross-reference information
for all installed documentation. Each document&rsquo;s information is in a
separate file, so that loading all relevant files would be tedious.
The <span class="nobreak"><span class="stt">+m</span></span> or <span class="nobreak"><span class="stt">++main-xref-in</span></span> flag loads cross-reference
information for all installed documentation, so</p><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">scribble +m mine.scrbl</span></p><p>renders <span class="stt">"mine.scrbl"</span> to <span class="stt">"mine.html"</span> with
cross-reference links to the Racket installation&rsquo;s documentation.
(The <span class="stt">"racket-index"</span> package must be installed to use
<span class="nobreak"><span class="stt">+m</span></span>/<span class="nobreak"><span class="stt">++main-xref-in</span></span>.)</p><p>The <span class="nobreak"><span class="stt">++xref-in</span></span> flag loads cross-reference information by calling
a specified module&rsquo;s function. The <a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=raco&amp;rel=xref.html&amp;version=6.1" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">setup/xref</span></a> module
provides <span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=raco&amp;rel=xref.html%23%2528def._%2528%2528lib._setup%252Fxref..rkt%2529._load-collections-xref%2529%2529&amp;version=6.1" class="RktValLink Sq" data-pltdoc="x">load-collections-xref</a></span> to load cross-reference
information for all installed documentation, and <span class="nobreak"><span class="stt">+m</span></span> or
<span class="nobreak"><span class="stt">++main-xref-in</span></span> is just a shorthand for <span class="stt">++xref-in
setup/xref load-collections-xref</span>.</p><p>The <span class="nobreak"><span class="stt">--redirect-main</span></span> flag for HTML output redirects links to the local
installation&rsquo;s documentation to a given URL, such as
<span class="stt">http://docs.racket-lang.org/</span>. Beware that documentation links
sometimes change (although Scribble generates HTML paths and anchors
in a relatively stable way), so
<span class="stt">http://download.racket-lang.org/docs/</span><span style="font-style: italic">version</span><span class="stt">/html/</span> may be
more reliable when building with an installation for <span style="font-style: italic">version</span>.
The <span class="nobreak"><span class="stt">--redirect-main</span></span> flag is ignored for non-HTML output.</p><p>The <span class="nobreak"><span class="stt">--redirect</span></span> flag is like <span class="nobreak"><span class="stt">--redirect-main</span></span>, except
that it builds on the given URL to indicate a cross-reference tag that
is more stable than an HTML path and anchor (in case the documentation
for a function changes sections, for example). No server currently
exists to serve such tag requests, however.</p><p>For cross-references among documentation that is not part of the
Racket installation, use <span class="nobreak"><span class="stt">--info-out</span></span> to save information from a
document build and use <span class="nobreak"><span class="stt">++info-in</span></span> to load previously saved
information. For example, if <span class="stt">"c.scrbl"</span> refers to information
in <span class="stt">"a.scrbl"</span> and <span class="stt">"b.scrbl"</span>, then</p><p><div class="SIntrapara"><span class="hspace">&nbsp;&nbsp;</span><span class="stt">scribble --info-out a.sxref a.scrbl</span></div><div class="SIntrapara"><span class="hspace">&nbsp;&nbsp;</span><span class="stt">scribble --info-out b.sxref b.scrbl</span></div><div class="SIntrapara"><span class="hspace">&nbsp;&nbsp;</span><span class="stt">scribble ++info-in a.sxref ++info-in b.sxref c.scrbl</span></div></p><p>builds <span class="stt">"c.html"</span> with cross-reference links into
<span class="stt">"a.html"</span> and <span class="stt">"b.html"</span>.</p><h4 x-source-module="(lib &quot;scribblings/scribble/scribble.scrbl&quot;)" x-part-tag="&quot;Selecting_an_Image_Format&quot;">7.3<tt>&nbsp;</tt><a name="(part._.Selecting_an_.Image_.Format)"></a>Selecting an Image Format</h4><p>Use the <span class="nobreak"><span class="stt">++convert</span></span> <span class="sroman">&#8249;<span style="font-style: italic">fmt</span>&#8250;</span> flag to select <span class="sroman">&#8249;<span style="font-style: italic">fmt</span>&#8250;</span> as
a preferred image format to use when rendering a document that
includes values that can be converted to different image formats. The
<span class="sroman">&#8249;<span style="font-style: italic">fmt</span>&#8250;</span> argument can be <span class="stt">pdf</span>, <span class="stt">ps</span>, <span class="stt">png</span>,
<span class="stt">svg</span>, or <span class="stt">gif</span>, but a renderer typically supports only a
subset of those formats.</p><p>Use <span class="nobreak"><span class="stt">++convert</span></span> <span class="sroman">&#8249;<span style="font-style: italic">fmt</span>&#8250;</span> multiple times to specify multiple
preferred formats, where a <span class="sroman">&#8249;<span style="font-style: italic">fmt</span>&#8250;</span> earlier in the command line
take precedence over <span class="sroman">&#8249;<span style="font-style: italic">fmt</span>&#8250;</span>s specified later.</p><p>For example, to generate Latex sources with images in Encapsulated
PostScript format (so that the result works with <span class="stt">latex</span> instead
of <span class="stt">pdflatex</span>), combine <span class="nobreak"><span class="stt">--latex</span></span> with <span class="nobreak"><span class="stt">++convert</span></span><span class="stt">
</span><span class="stt">ps</span>. To generate HTML pages with images converted to SVG format
instead of PNG format, combine <span class="nobreak"><span class="stt">--html</span></span> with
<span class="nobreak"><span class="stt">++convert</span></span><span class="stt"> svg</span>.</p><p class="SHistory">Changed in version 1.4: Added <span class="nobreak"><span class="stt">++convert</span></span> support.</p><h4 x-source-module="(lib &quot;scribblings/scribble/scribble.scrbl&quot;)" x-part-tag="&quot;Passing_Command-Line_Arguments_to_Documents&quot;">7.4<tt>&nbsp;</tt><a name="(part._.Passing_.Command-.Line_.Arguments_to_.Documents)"></a>Passing Command-Line Arguments to Documents</h4><p>When <span class="stt">scribble</span> loads and renders a document module, by default
it sets <span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=reference&amp;rel=runtime.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._current-command-line-arguments%2529%2529&amp;version=6.1" class="RktValLink Sq" data-pltdoc="x">current-command-line-arguments</a></span> to an empty vector.
Use the <span class="nobreak"><span class="stt">++arg</span></span> flag (any number of times) to add a string to
<span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=reference&amp;rel=runtime.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._current-command-line-arguments%2529%2529&amp;version=6.1" class="RktValLink Sq" data-pltdoc="x">current-command-line-arguments</a></span>.</p><p>For example,</p><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">scribble ++arg --mode ++arg fast turtle.scrbl</span></p><p>causes <span class="RktPn">(</span><span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=reference&amp;rel=runtime.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._current-command-line-arguments%2529%2529&amp;version=6.1" class="RktValLink Sq" data-pltdoc="x">current-command-line-arguments</a></span><span class="RktPn">)</span> to return
<span class="RktVal">'</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">"--mode"</span><span class="stt"> </span><span class="RktVal">"fast"</span><span class="RktVal">)</span> while <span class="stt">"turtle.scrbl"</span> is loaded
and rendered, which could affect the content that
<span class="stt">"turtle.scrbl"</span> generates if it uses
<span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=reference&amp;rel=runtime.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._current-command-line-arguments%2529%2529&amp;version=6.1" class="RktValLink Sq" data-pltdoc="x">current-command-line-arguments</a></span>.</p><p class="SHistory">Changed in version 1.1: Added the empty-vector default and <span class="nobreak"><span class="stt">++arg</span></span> flag.</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, &quot;6.1&quot;, &quot;../&quot;);" onfocus="this.style.color=&quot;black&quot;; this.style.textAlign=&quot;left&quot;; if (this.value == &quot;...search manuals...&quot;) this.value=&quot;&quot;;" onblur="if (this.value.match(/^ *$/)) { this.style.color=&quot;#888&quot;; this.style.textAlign=&quot;center&quot;; this.value=&quot;...search manuals...&quot;; }"/></form>&nbsp;&nbsp;<a href="../index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;6.1&quot;);">top</a></span><span class="navright">&nbsp;&nbsp;<a href="latex-prefix.html" title="backward to &quot;6.10.6 Latex Prefix Support&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;Scribble: The Racket Documentation Tool&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="doc-index.html" title="forward to &quot;Index&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>