76 lines
2.3 KiB
Groff
76 lines
2.3 KiB
Groff
.\" 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]).
|