REFERENCE · QUERY

Query language

Syntax

A query is one atom, a phrase connected by whitespace, or a disjunction connected by |. Whitespace and | inside a quoted atom belong to its text.

Unicode normalization and morphology expansion apply as compile options after lexing.

query       = atom / phrase / disjunction
phrase      = atom 1*(WS atom)
disjunction = atom 1*(OWS "|" OWS atom)

Atom tags

A colon after n, pro, num, v, adj, det, adv, j, intj, or lit marks POS. It applies only to that atom.

A concrete global POS conflicting with an atom tag is a compile error.

Alternatives

Whitespace around | is optional. Every alternative must be exactly one atom, and a query cannot mix phrase and disjunction composition.

Write a literal | as \| or "|". Quote the whole query in a CLI shell.

Syntax errors

Empty queries, unclosed quotes, trailing backslashes, unknown tags, empty tagged bodies, operand-free |, and phrase mixing are rejected.

Errors include the byte location and cause. No partial plan executes.