41 lines
1.8 KiB
Groff
41 lines
1.8 KiB
Groff
.TH GASM-LSP 1 "2026-10-01" "gasm" "User Commands"
|
|
.SH NAME
|
|
gasm-lsp \- run the Plan 9 assembly language server
|
|
.SH SYNOPSIS
|
|
.B gasm lsp
|
|
.SH DESCRIPTION
|
|
Run the language server over standard input/output: JSON-RPC 2.0 with
|
|
Content-Length framing. Point an LSP-capable editor at the binary and
|
|
associate it with
|
|
.I .s
|
|
files; the target architecture is inferred from the file suffix
|
|
(_amd64.s, _arm64.s, _riscv64.s, _loong64.s).
|
|
.PP
|
|
Provides completion, hover, document symbols, push and pull diagnostics,
|
|
semantic-token highlighting, go-to-definition, find references, rename,
|
|
formatting, inlay hints, code actions, signature help, document
|
|
highlights, workspace symbol search, include document links and folding
|
|
ranges. Completion offers the architecture's registers and
|
|
instructions, the TEXT, DATA and GLOBL directives, the annotation and
|
|
padding pseudo-ops (PCALIGN, FUNCDATA, PCDATA, the BYTE family) and the
|
|
textflag constants; hover documents mnemonics, registers,
|
|
pseudo-registers and the directives. Syntax highlighting is delivered
|
|
as LSP semantic tokens, so no editor-specific grammar is required.
|
|
.PP
|
|
Definition, references and rename work across every open document and
|
|
the wider workspace on disk: the server indexes the .s files under the
|
|
workspace root that the editor has never opened, an open buffer always
|
|
shadows its disk copy, and watched-file events together with a per-query
|
|
freshness check keep the index current.
|
|
.PP
|
|
The quick fixes add the missing textflag.h include, set the TEXT
|
|
argument area to the size the
|
|
.B //\ func
|
|
signature implies, declare that area when it is omitted entirely, add a
|
|
missing RET, and remove an unused label.
|
|
.SH EXIT STATUS
|
|
Runs until the client closes the session; exits 0 on a clean shutdown.
|
|
.SH SEE ALSO
|
|
.BR gasm (1),
|
|
.BR gasm\-lint (1)
|