Bowie Documentation

This folder contains detailed documentation for the bowie interpreter project.

Documentation Map

• getting-started.md
  Build, run, install, and verify Bowie on local machines.
• language-reference.md
  Complete language-level reference (syntax, semantics, control flow, modules, async, errors).
• builtins-and-apis.md
  Exhaustive builtin function and runtime API reference (I/O, strings, JSON, HTTP, PostgreSQL, etc.).
• runtime-and-internals.md
  Interpreter architecture and runtime internals (lexer, parser, evaluator, object model, event loop).
• development.md
  Project structure, optional dependency behavior, extension guidelines, and testing suggestions.

Scope

This documentation is generated from the current source in:

• bowie/src/*.c
• bowie/src/*.h
• bowie/Makefile

It documents the implementation that exists today, including constraints and edge cases.

Quick Start

1. Go to the bowie project root.
2. Build with make.
3. Run a script with ./bowie your_script.bow.
4. Start REPL with ./bowie.

For full details, see getting-started.md.