.\" Automatically generated by Pandoc 3.1.12.1
.\"
.TH "TOMO" "1" "June 11, 2024" "" ""
.SH NAME
tomo \- The programming language of tomorrow.
.SH SYNOPSIS
.TP
Run the REPL:
\f[B]tomo\f[R]
.TP
Run a program:
\f[B]tomo\f[R] \f[I]program.tm\f[R] [[\f[B]\-\-\f[R]]
\f[I]args\&...\f[R]]
.TP
Transpile tomo files to C files:
\f[B]tomo\f[R] \f[B]\-t\f[R] \f[I]file1.tm\f[R] \f[I]file2.tm\f[R]\&...
.TP
Compile files to static object files:
\f[B]tomo\f[R] \f[B]\-c\f[R] \f[I]file1.tm\f[R] \f[I]file2.tm\f[R]\&...
.TP
Compile file to an executable:
\f[B]tomo\f[R] \f[B]\-e\f[R] \f[I]file1.tm\f[R]
.TP
Build a shared library:
\f[B]tomo\f[R] \f[B]\-s=\f[R]\f[I]mylib.1.2.3\f[R] \f[I]file1.tm\f[R]
\f[I]file2.tm\f[R]\&...
.SH 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.
.SH OPTIONS
.TP
\f[B]\-h\f[R], \f[B]\-\-help\f[R]
Print the usage and exit.
.TP
\f[B]\-t\f[R], \f[B]\-\-transpile\f[R]
Transpile the input files to C code without compiling them.
.TP
\f[B]\-c\f[R], \f[B]\-\-compile\-obj\f[R]
Compile the input files to static objects, rather than running them.
.TP
\f[B]\-e\f[R], \f[B]\-\-compile\-exe\f[R]
Compile the input file to an executable.
.TP
\f[B]\-L\f[R], \f[B]\-\-library\f[R]
Compile the input files to a library \f[B].so\f[R] file and header.
.TP
\f[B]\-I\f[R], \f[B]\-\-install\f[R]
Install the compiled executable or library.
.TP
\f[B]\-C\f[R] \f[I]\f[R], \f[B]\-\-show\-codegen\f[R] \f[I]\f[R]
Set a program (e.g.\ \f[B]cat\f[R] or \f[B]bat\f[R]) to display the
generated code
.TP
\f[B]\-\-c\-compiler\f[R]
Set which C compiler is used.
.TP
\f[B]\-O\f[R] \f[B]level\f[R], \f[B]\-\-optimization\f[R] \f[B]level\f[R]
Set the optimization level.
.TP
\f[B]\-v\f[R], \f[B]\-\-verbose\f[R]
Print extra verbose output.
.TP
\f[B]\-r\f[R], \f[B]\-\-run\f[R]
Run an installed tomo program from
\f[B]\[ti]/.local/share/tomo/installed\f[R].
.SS ENVIRONMENT VARIABLES
Some options can be configured by setting environment variables.
.TP
\f[B]CC=\f[R]\f[I]c\-compiler\f[R]
Set which C compiler is used.
.SH AUTHORS
Bruce Hill (\f[I]bruce\[at]bruce\-hill.com\f[R]).