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 REPL, compile sources into Noct bytecode, or transpile sources to ANSI C or Emacs Lisp.

If no arguments are provided, runs the REPL.

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

OPTIONS
The following options are supported:

- -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 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.