From 1578a7025c3c70cbbdb110aa42125c9acb57aeda Mon Sep 17 00:00:00 2001
From: Arne Babenhauserheide <arne_bab@web.de>
Date: Sat, 8 Oct 2022 00:03:38 +0200
Subject: Allow 'chickadee play' to use languages other than Scheme.

---
 doc/chickadee.texi | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)

(limited to 'doc')

diff --git a/doc/chickadee.texi b/doc/chickadee.texi
index f561bae..b576641 100644
--- a/doc/chickadee.texi
+++ b/doc/chickadee.texi
@@ -278,6 +278,38 @@ Geiser} extension for Emacs is by far the best way to develop at the
 REPL with Guile.  Use @code{M-x connect-to-guile} to connect to the
 REPL server.
 
+@item --language=@var{language}
+
+Process the input program using @var{language}, the identifier of a
+language within Guile's language tower.  By default, unsurprisingly,
+Scheme is used.
+
+For example, to use the neat
+@url{https://www.draketo.de/software/wisp, Wisp} language as an
+alternative to Scheme's parenthetical syntax, pass
+@code{--language=wisp}.  Wisp is not included with Guile and must be
+installed separately.
+
+@item -x @var{extension}
+
+Add @var{extension} to the list of file extensions that Guile will
+load.
+
+For example, Wisp files canonically use the @file{.w} extension.
+Here's what a ``hello, world'' Chickadee program looks like in Wisp:
+
+@example
+define : draw alpha
+  draw-text "Hello, world!" : vec2 260.0 240.0
+@end example
+
+Assuming the above code is saved to a @file{hello.w} file,
+@command{chickadee play} be invoked as follows:
+
+@example
+chickadee play --language=wisp -x .w hello.w
+@end example
+
 @end table
 
 @node Invoking chickadee bundle
-- 
cgit v1.2.3