Command Usage

Solstice programming language
Usage: solstice <file> [-h] [--help] [-p] [--print] [-b <file>] [--bytecode <file>] [-c <file>] [--compile <file>]
Args:
  <file>:                         Solstice source file
  -h or --help:                   Prints this help message and exits
  -p or --print:                  Prints textual version of Ground bytecode to console
  -b <file> or --bytecode <file>: Generates Ground bytecode (.grbc) and saves it to the provided filename
  -c <file> or --compile <file>:  Compiles Ground to Linux x86_64 assembly, outputs a binary to the provided filename (experimental)
  If no extra arguments are provided, the generated Ground bytecode will be executed.

Arguments:

<file>

The Solstice source file to run.

There should never be more than one file, as Solstice allows files to import each other, rather than compiling multiple files into one manually.

-h or --help

Shows the help message above.

-p or --print

Prints the textual version of the generated Ground bytecode to the console.

This is useful for debugging the compiler, and ensuring the correct output is produced for the GroundVM.

-b <file> or --bytecode <file>

Outputs Ground bytecode (in grbc format) and saves it in the file <file>.

Ground bytecode is useful for distributing software in a format where the target machine does not need Solstice installed, only the Ground VM.

Run the compiled bytecode with:

ground -b <file>

-c <file> or --compile <file>

Compiles the Ground bytecode to assembly using the Tram backend, outputting a binary named <file>.

Requires Ground to be built with Tram support, and Tram to be installed on your system.

This backend is experimental and does not support all features.