A# Language Documentation

Welcome to the official documentation for A#, a high-performance systems language that compiles C# syntax into low-level C--, then emits optimized binaries for CPU and GPU execution.

A# is ideal for developers who want the expressive power of C# with the control and clarity of systems programming — perfect for building operating systems, compilers, and high-performance runtimes.

---

What is A#?

A# is:

• C#-compatible: Any valid C# code is valid A# code.
• System-capable: A# extends C# with system-level constructs, making it suitable for OS kernels and hardware-near code.
• Compiler-driven: The A# compiler is override-driven, enabling auditability, reproducibility, and semantic clarity.
• LLVM-backed: The compiler lowers C# into C--, then emits custom LLVM IR for CPU, GPU, or hybrid targets.
• Tooling-rich: Includes semantic diagnostics, IR visualizers, and override introspection.

---

Compilation Pipeline

C# source code
     ↓
A# frontend (parsing + semantic analysis)
     ↓
C-- intermediate representation (override-pure, audit-friendly)
     ↓
Custom LLVM backend (targeting CPU, GPU, or both)
     ↓
Executable binary or runtime module