GSP(1) General Commands Manual GSP(1)

gsp — HTML-compatible markup language

gsp [-cd] [-I dirname] [file ...]

gsp -h

This manual documents the gsp cli tool. For documentation regarding the GSP language itself, see the SEE ALSO section of this manual.

gsp is a utility to transpile gsp(7) formatted documents into valid HTML. Files provided as command-line arguments are transpiled with the results written to the standard output. If no arguments or the special filename ‘-’ is provided, then input will be read from the standard input.

The options are as follows:

Transliterate GSP comments into HTML comments. The default behaviour is to drop comments.
Do not automatically generate a doctype declaration at the beginning of the document.
Display help information by opening this manual page.
dirname
Add dirname to the macro search path. By default the macro search path is empty.

The gsp utility exits 0 on success, and >0 if an error occurs.

Compile the files head.gsp and tail.gsp into one HTML document:

$ gsp head.gsp tail.gsp >out.html

Use your own document type instead of the HTML5 one:

$ { printf '%s' "$doctype"; gsp -d index.gsp; } >index.html

gspesc(1), gsp(7), gsp-macros(7)

Thomas Voss <mail@thomasvoss.com>

May 5, 2026 GSP 4.2