Getting Started

Get a compiler that runs, then a program that runs.

sysl compiles through LLVM: the compiler emits textual LLVM IR and hands it to clang to assemble and link. So there are two things to install — the compiler itself, and a toolchain for it to hand its output to. On macOS and on Linux one brew install does both; elsewhere, the compiler builds from source and the toolchain comes from your package manager.

By the end of this section you will have run a sysl program you wrote yourself. The tour picks up from there, and the command line is here for when you want more of the tool than run.

If you write C, coming from C is the shortest way in: what translates straight across, what changes shape, and the refusals a C program meets first.

Pages

Installation — Install the compiler from the tap, or build it from source.

Your first program — A file with no ceremony in it, and what the compiler did with it.

The command line — The subcommands, the flags they share, and what each one leaves as an exit status.

Coming from C — What translates straight across, what changes shape, and the refusals a C program runs into first.