summaryrefslogtreecommitdiff
path: root/manuals/chickadee/Invoking-chickadee-play.html
diff options
context:
space:
mode:
authorDavid Thompson <dthompson2@worcester.edu>2022-10-25 07:25:01 -0400
committerDavid Thompson <dthompson2@worcester.edu>2022-10-25 07:26:05 -0400
commitd54995cad9ddf652cd2f7abb128d5d251f9454f1 (patch)
tree34c7b4676b4e3615a2a66980868b4d767c6867b6 /manuals/chickadee/Invoking-chickadee-play.html
parentbb44696ee1d8263b58976fec1bcd8e030f97f8e4 (diff)
projects: Update chickadee for 0.9.0 release.
Diffstat (limited to 'manuals/chickadee/Invoking-chickadee-play.html')
-rw-r--r--manuals/chickadee/Invoking-chickadee-play.html41
1 files changed, 37 insertions, 4 deletions
diff --git a/manuals/chickadee/Invoking-chickadee-play.html b/manuals/chickadee/Invoking-chickadee-play.html
index 0c9c065..2841c18 100644
--- a/manuals/chickadee/Invoking-chickadee-play.html
+++ b/manuals/chickadee/Invoking-chickadee-play.html
@@ -98,8 +98,7 @@ the Chickadee game contained within a Scheme source file.
events from the game loop:
</p>
<ul>
-<li> load-game
-</li><li> quit-game
+<li> quit-game
</li><li> draw
</li><li> update
</li><li> key-press
@@ -170,8 +169,8 @@ controlled via the following options:
<dt><code>--repl</code></dt>
<dd>
<p>Launch a REPL in the terminal. This will allow the game environment
-to debugged and modified without having to stop and restart the game
-after each change.
+to be debugged and modified without having to stop and restart the
+game after each change.
</p>
</dd>
<dt><code>--repl-server[=<var>port</var>]</code></dt>
@@ -184,6 +183,40 @@ REPL with Guile. Use <code>M-x connect-to-guile</code> to connect to the
REPL server.
</p>
</dd>
+<dt><code>--language=<var>language</var></code></dt>
+<dd>
+<p>Process the input program using <var>language</var>, the identifier of a
+language within Guile&rsquo;s language tower. By default, unsurprisingly,
+Scheme is used.
+</p>
+<p>For example, to use the neat
+<a href="https://www.draketo.de/software/wisp">Wisp</a> language as an
+alternative to Scheme&rsquo;s parenthetical syntax, pass
+<code>--language=wisp</code>. Wisp is not included with Guile and must be
+installed separately.
+</p>
+</dd>
+<dt><code>-x <var>extension</var></code></dt>
+<dd>
+<p>Add <var>extension</var> to the list of file extensions that Guile will
+load.
+</p>
+<p>For example, Wisp files canonically use the <samp>.w</samp> extension.
+Here&rsquo;s what a &ldquo;hello, world&rdquo; Chickadee program looks like in Wisp:
+</p>
+<div class="example">
+<pre class="example">define : draw alpha
+ draw-text &quot;Hello, world!&quot; : vec2 260.0 240.0
+</pre></div>
+
+<p>Assuming the above code is saved to a <samp>hello.w</samp> file,
+<code>chickadee play</code> be invoked as follows:
+</p>
+<div class="example">
+<pre class="example">chickadee play --language=wisp -x .w hello.w
+</pre></div>
+
+</dd>
</dl>
<hr>