Move manpage into docs

1 files changed, 76 insertions, 0 deletions

diff --git a/docs/tomo.1.md b/docs/tomo.1.md
new file mode 100644
index 00000000..c641d0d3
--- /dev/null
+++ b/docs/tomo.1.md
@@ -0,0 +1,76 @@
+% 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 library `.so` file and header.
+
+`-I`, `--install`
+: Install the compiled executable or library.
+
+`-C` *<program>*, `--show-codegen` *<program>*
+: 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.