tomo/docs/tomo.1.md

% TOMO(1) % Bruce Hill (bruce@bruce-hill.com) % June 11, 2024

NAME

tomo - The programming language of tomorrow.

SYNOPSIS

Run the REPL:

tomo

Run a program:

tomo program.tm [[--] args...]

Transpile tomo files to C files:

tomo -t file1.tm file2.tm...

Compile files to static object files:

tomo -c file1.tm file2.tm...

Compile file to an executable:

tomo -e file1.tm

Build a shared library:

tomo -s=mylib.1.2.3 file1.tm file2.tm...

DESCRIPTION

Tomo is a programming language that is statically typed, compiled, small, and garbage-collected, with concise syntax and built-in support for high-performance, low-overhead datastructures. It compiles by first outputting C code, which is then compiled using a C compiler of your choice.

OPTIONS

-h, --help

Print the usage and exit.

-t, --transpile

Transpile the input files to C code without compiling them.

-c, --compile-obj

Compile the input files to static objects, rather than running them.

-e, --compile-exe

Compile the input file to an executable.

-L, --library

Compile the input files to a shared library file and header.

-I, --install

Install the compiled executable or library.

-C , --show-codegen

Set a program (e.g. cat or bat) to display the generated code

--c-compiler

Set which C compiler is used.

-O level, --optimization level

Set the optimization level.

-v, --verbose

Print extra verbose output.

-r, --run

Run an installed tomo program from ~/.local/share/tomo/installed.

ENVIRONMENT VARIABLES

Some options can be configured by setting environment variables.

CC=c-compiler

Set which C compiler is used.