main
Download
91 lines 3 KiBGroffModified 2026-03-15 raw
12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091
.\" Automatically generated by Pandoc 3.5
.\"
.TH "TOMO" "1" "June 11, 2024" ""
.SH NAME
tomo \- The programming language of tomorrow.
.SH SYNOPSIS
.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 files to a executables:
\f[B]tomo\f[R] \f[B]\-e\f[R] \f[I]file1.tm\f[R] \f[I]file2.tm\f[R]\&...
.TP
Build a package:
\f[B]tomo\f[R] \f[B]\-p\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]\-\-changelog\f[R]
Print the compiler change log and exit.
.TP
\f[B]\-\-transpile\f[R], \f[B]\-t\f[R] \f[I]file1.tm\f[R] \f[I]file2.tm\f[R]\&...
Transpile the given files to C.
.TP
\f[B]\-\-compile\-exe\f[R], \f[B]\-e\f[R] \f[I]file1.tm\f[R] \f[I]file2.tm\f[R]\&...
Compile the given files to executables.
.TP
\f[B]\-\-compile\-obj\f[R], \f[B]\-c\f[R] \f[I]file1.tm\f[R] \f[I]file2.tm\f[R]\&...
Compile the given files to static objects.
.TP
\f[B]\-\-help\f[R], \f[B]\-h\f[R]
Print the usage and exit.
.TP
\f[B]\-\-package\f[R], \f[B]\-p\f[R] \f[I]folder1\f[R] \f[I]folder2\f[R]\&...
Compile the input folders to shared packages.
.TP
\f[B]\-\-install\f[R], \f[B]\-I\f[R]
When using \f[B]\-e\f[R] or \f[B]\-L\f[R], install the resulting
executables or packages.
.TP
\f[B]\-\-show\-codegen\f[R] \f[I]\f[R], \f[B]\-C\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]\-\-force\-rebuild\f[R], \f[B]\-f\f[R]
Force rebuilding/recompiling.
.TP
\f[B]\-\-format\f[R] \f[I]file1.tm\f[R] \f[I]file2.tm\f[R]\&...
Autoformat the given files and print them to standard output.
.TP
\f[B]\-\-format\f[R] \f[I]file1.tm\f[R] \f[I]file2.tm\f[R]\&...
Autoformat the given files in\-place and overwrite the original files.
.TP
\f[B]\-\-optimization\f[R] \f[B]level\f[R], \f[B]\-O\f[R] \f[B]level\f[R]
Set the optimization level.
.TP
\f[B]\-\-prefix\f[R]
Print the Tomo installation prefix and exit.
.TP
\f[B]\-\-quiet\f[R], \f[B]\-q\f[R]
Run in quiet mode.
.TP
\f[B]\-\-run\f[R], \f[B]\-r\f[R]
Run an installed tomo program from
\f[B]\[ti]/.local/lib/tomo_vX.Y/\f[R].
.TP
\f[B]\-\-source\-mapping=\f[R], \f[B]\-m=\f[R] \f[B]<yes|no>\f[R]
Toggle whether source mapping should be enabled or disabled.
.TP
\f[B]\-\-uninstall\f[R], \f[B]\-u\f[R] \f[I]pkg1\f[R] \f[I]pkg2\f[R]\&...
Uninstall the given packages.
.TP
\f[B]\-\-verbose\f[R], \f[B]\-v\f[R]
Print extra verbose output.
.TP
\f[B]\-\-version\f[R]
Print the compiler version and exit.
.SH AUTHORS
Bruce Hill (\f[I]bruce\[at]bruce\-hill.com\f[R]).