Overview
This section provides detailed, technical documentation of Mux's syntax and semantics.
Purpose
The Language Reference is the authoritative source for:
- Exact syntax definitions
- Semantic behavior
- Edge cases and corner cases
- Implementation details
This is different from the Language Guide, which focuses on teaching and examples.
Contents
Core Reference
| Topic | Description |
|---|---|
| Lexical Structure | Tokens, keywords, identifiers, literals, comments |
| Operators | Operator precedence, associativity, behavior |
Behavior Reference
| Topic | Description |
|---|---|
| Statements | Detailed semantics of each statement type |
| Expressions | Expression evaluation rules |
| Memory Model | Reference counting specifics |
Quick Reference
| Topic | Description |
|---|---|
| Operators | Operator precedence table |
| Memory Model | Memory layout diagrams |
Reference vs Guide
| Language Guide | Language Reference |
|---|---|
| Learning-oriented | Reference-oriented |
| Concept explanations | Precise rules |
| Practical examples | Formal definitions |
| Progressive complexity | Topic-by-topic organization |
Additional Resources
- Language Guide - Practical language documentation
- README.md - Comprehensive language specification
- Source Code - The compiler itself is the ultimate reference
Contributing
If you find discrepancies between documentation and implementation, please file an issue.