Raz Gen2 · Language and toolchain reference

Raz Manual

A practical reference for understanding Raz source syntax, compiler behavior, native interoperability, and the standard library.

Documentation

Getting Started

Write a small Raz program and understand the source-to-C++ workflow.

First program »

Language Reference

Keywords, lexical forms, operators, types, declarations, calls, and source directives.

Browse language topics »

Compiler

Frontend stages, validation, RIR, and the C++17 backend.

Compiler architecture »

Standard Library

Available modules and the current public API surface.

Browse modules »

Runtime & Memory

Type representation, references, containers, pointers, and lifetime questions.

Runtime model »

Interop & Platform

Native headers, C++ calls, target assumptions, and ABI boundaries.

Interop reference »

Toolchain & Build

Compiler options, output files, and the authoritative build configuration.

Build reference »

Testing & Compatibility

Compile-only tests, generated output review, and regression policy.

Testing reference »

Project Development

Self-hosting principles, build rules, test policy, and documentation standards.

Development principles »

How to read this manual

Feature pages distinguish the current implementation from decisions that still need approval. Design references record where a concept was inspired by another language; they do not imply identical syntax or semantics.

Use the search field above to find a keyword, operator, type, compiler stage, or standard module. Token numbers are documented as internal lexer identifiers rather than stable language-level names.