.TH FENNEL 1
fennel \- a lisp programming language that runs on Lua
[\fB--compile \fIfilename\fR] |
[\fB--eval \fIsource\fR] |
[\fIfilename\fP] [\fIargs ...\fR]
This manual page documents briefly the
is the main entry point for Fennel, a lisp programming language that
runs on Lua runtimes. With no options or arguments, it runs an
interactive Read-Eval-Print loop (REPL).
Given a filename as its first argument, it runs that file and passes
it the subsequent arguments. Ahead-of-time compilation can be invoked
A summary of options is included below.
Start an interactive repl session.
.B \-\-compile \fIfilename\fP
Perform ahead-of-time compilation on the provided file and write the
Lua output to stdout.
.B \-\-eval \fIsource\fP
Evaluate a piece of source code and print the result.
When running a repl or a file,
is installed by default so that the
function can load Fennel files in addition to Lua files. This flag
disables that behavior. Has no effect for ahead-of-time compilation.
.B \-\-indent \fIval\fP
When compiling, use the given string as indentation for the compiler
output. This should consist of whitespace.
.B \-\-add-package-path \fIpath\fP
Add the given path to
so that the
function will know to look there when searching for Lua modules.
.B \-\-add-fennel-path \fIpath\fP
Same as above, but for Fennel's path used when searching for Fennel
.B \-\-globals \fIVAR1[,VAR2...]\fP
Allow VAR1, VAR2, etc as globals in addition to the standard set of
globals. This enables strict global checking even in ahead-of-time
compilation where it otherwise would be disabled.
.B \-\-globals-only \fIVAR1[,VAR2...]\fP
Same as above, but without the addition of the standard set of globals.
Instead of loading required modules at runtime, compile them inline
into the main file being compiled. Only useful during ahead-of-time
Compile bitwise operations to use LuaJIT's bitop library instead of Lua
5.3+ bitwise operators.
.B \-\-load \fIFILE\fP
Load the specified file before any command is run.
.B \-\-compile-binary \fIFILE\fP \fIOUT\fP \fILUA_LIB\fP \fILUA_DIR\fP
Compile FILE to a standalone binary OUT using LUA_LIB and the Lua
header files in LUA_DIR. See
.B \-\-compile-binary \-\-help
Do not limit compiler environment to minimal sandbox.
.B \-h, \-\-help
Print a help message and exit
.B \-v, \-\-version
Print the version number and exit
See https://fennel-lang.org for documentation on Fennel. The syntax is
based on the lisp family of languages while the semantics are very
close to Lua, so Lua's reference manual is helpful.
The mailing list is at https://lists.sr.ht/~technomancy/fennel while
the issue tracker is at https://todo.sr.ht/~technomancy/fennel.
Calvin Rose and contributors:
Copyright © 2016-2021, Released under the MIT/X11 license