aboutsummaryrefslogtreecommitdiff
path: root/man/man1/tomo.1
blob: 60760d24bb30b4e77ac38c1155abd2b00c8eeddf (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
.\" Automatically generated by Pandoc 3.1.13
.\"
.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 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]\-\-changelog\f[R]
Print the compiler change log and exit.
.TP
\f[B]\-\-compile\-exe\f[R], \f[B]\-e\f[R]
Compile the input file to an executable.
.TP
\f[B]\-\-compile\-obj\f[R], \f[B]\-c\f[R]
Compile the input files to static objects, rather than running them.
.TP
\f[B]\-\-help\f[R], \f[B]\-h\f[R]
Print the usage and exit.
.TP
\f[B]\-\-install\f[R], \f[B]\-I\f[R]
Install the compiled executable or library.
.TP
\f[B]\-\-library\f[R], \f[B]\-L\f[R]
Compile the input files to a shared library file and header.
.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]
Autoformat a file and print it to standard output.
.TP
\f[B]\-\-format\-inplace\f[R]
Autoformat a file in\-place.
.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/share/tomo_vX.Y/installed\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]\-\-transpile\f[R], \f[B]\-t\f[R]
Transpile the input files to C code without compiling them.
.TP
\f[B]\-\-uninstall\f[R], \f[B]\-u\f[R]
Uninstall a compiled executable or library.
.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]).