.TH GASM-TOKENS 1 "2026-09-19" "gasm" "User Commands"
.SH NAME
gasm-tokens \- print the lexical token stream of an assembly file
.SH SYNOPSIS
.B gasm tokens <file>
.SH DESCRIPTION
Print the lexical token stream of FILE: position, token kind and text,
one token per line.  FILE may be
.B \-
to read standard input.
.PP
This is the front end's raw view, for when the assembler's own
diagnostic is not enough: a mis-scanned operand or a swallowed comment
shows up here as the tokens the parser actually received.
.SH EXIT STATUS
Exits 0 on success and 1 when the file cannot be read.
.SH SEE ALSO
.BR gasm (1),
.BR gasm\-parse (1)