*View this file with results and syntax highlighting [here](https://mlochbaum.github.io/BQN/doc/index.html).*

# BQN documentation

BQN's documentation describes what features it has, how to use them (with examples), and why they were chosen. For a linear introduction to the language, see the [tutorials](../tutorial/README.md). For all of the particulars without so much discussion, see the [specification](../spec/README.md).

Overview:
- [Syntax](syntax.md)
- [Types](types.md)
- [Primitives](primitive.md)
- [Paradigms](paradigms.md)
- See also [help index](../help/README.md); [summary gist](https://gist.github.com/dzaima/52b47f898c5d43f72dc2637d6cdadedd)
- And [system values](../spec/system.md) (not always implemented)

References:
- [Glossary](glossary.md)
- [BQN-Dyalog dictionary](fromDyalog.md)
- [BQN-J dictionary](fromJ.md)
- [BQN as combinatory logic](birds.md)

Concepts:
- [Context-free grammar](context.md)
- [Expression syntax](expression.md)
- [Arrays](array.md)
- [Based array theory](based.md)
- [Array notation and display](arrayrepr.md)
- [Array indices](indices.md)
- [Fill elements](fill.md)
- [The leading axis model](leading.md)
- [Tacit programming](tacit.md)
- [Function trains](train.md)
- [Blocks](block.md) (including function and modifier definition)
- [Lexical scoping](lexical.md)
- [Functional programming](functional.md)
- [Control flow](control.md)
- [Namespaces](namespace.md)
- [Object-oriented programming](oop.md)

Primitives:
- [Arithmetic: `+-×÷⋆√⌊⌈|≤<>≥=≠`](arithmetic.md)
- [Array depth: `≡` and `⚇`](depth.md)
- [Array dimensions: `≢=≠`](shape.md)
- [Assert and Catch: `!` and `⎊`](assert.md)
- [Atop and Over: `∘○`](compose.md)
- [Before and After: `⊸⟜`](hook.md)
- [Cells and Rank: `˘⎉`](rank.md)
- [Choose: `◶`](choose.md)
- [Constant: `˙`](constant.md)
- [Deshape and Reshape: `⥊`](reshape.md)
- [Enclose: `<`](enclose.md)
- [Find: `⍷`](find.md)
- [Fold and Insert: `´˝`](fold.md)
- [Group: `⊔`](group.md)
- [Identity functions: `⊢⊣`](identity.md)
- [Indices and Replicate: `/`](replicate.md)
- [Join and Join To: `∾`](join.md)
- [Logical functions: `∧∨¬`](logic.md)
- [Match: `≡≢`](match.md)
- [Mapping: `¨⌜`](map.md)
- [Ordering functions: `∧∨⍋⍒`](order.md)
- [Pair: `⋈`](pair.md)
- [Pick: `⊑`](pick.md)
- [Prefixes and Suffixes: `↑↓`](prefixes.md)
- [Range: `↕`](range.md)
- [Repeat: `⍟`](repeat.md)
- [Reverse and Rotate: `⌽`](reverse.md)
- [Scan: `` ` ``](scan.md)
- [Search functions: `⊐⊒∊`](search.md)
- [Select: `⊏`](select.md)
- [Self and Swap: `˜`](swap.md)
- [Self-search functions: `⊐⊒∊⍷`](selfcmp.md)
- [Shift functions: `»«`](shift.md)
- [Solo, Couple, and Merge: `≍>`](couple.md)
- [Take and Drop: `↑`](take.md)
- [Transpose: `⍉`](transpose.md)
- [Under: `⌾`](under.md)
- [Undo: `⁼`](undo.md)
- [Valences: `⊘`](valences.md)
- [Windows: `↕`](windows.md)

Environment:
- [Embedded BQN](embed.md)
- [ReBQN](rebqn.md)