summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/chickadee.texi32
1 files changed, 32 insertions, 0 deletions
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