NOCT(1)

NAME
noct - Noct programming language CLI

SYNOPSIS
noct [file]
noct --compile files...
noct --ansic out.c in_files...
noct --elisp out.el in_files...

DESCRIPTION
The noct command is the command-line interface for the Noct programming language. It can directly run a program, run a REPL, compile sources into Noct bytecode, or transpile sources to ANSI C or Emacs Lisp.

If no arguments are provided, noct runs the REPL.

If no option is given and a file is provided, noct executes the program.

OPTIONS

--compile
    Compile one or more input source files into Noct bytecode files.

--ansic out.c in_files...
    Transpile the specified input source files into a single ANSI C source file out.c. The generated C file can be compiled with the Noct runtime.

--elisp out.el in_files...
    Transpile the specified input source files into a single Emacs Lisp file out.el. The resulting file can be loaded into Emacs to run the program using Noct's Emacs integration (if available).

OPERANDS

file
    Path to a Noct source file to execute. When present without other options, noct runs the program.

files
    One or more input source files.

EXIT STATUS
noct exits 0 on success, and >0 if an error occurs (syntax error, I/O failure, code generation error, or runtime failure).

EXAMPLES
Run REPL:

$ noct

Run a program:

$ noct hello.noct

Compile multiple sources to bytecode:

$ noct --compile lib.noct main.noct

Transpile to ANSI C:

$ noct --ansic aot_source.c main.noct lib.noct

Generate a single Emacs Lisp file:

$ noct --elisp app.el main.noct lib.noct

VERSION
Noct Programming Language, version 0.1.0

AUTHORS
Awe Morris and the Noct contributors

BUGS
Report issues at <awe@noctvm.io>.

Behavior and options are subject to change while Noct is pre-1.0.