aboutsummaryrefslogtreecommitdiffhomepage
path: root/test/external/metalang99/ARCHITECTURE.md
blob: b1fe1ccf16c6e42159c2def2b757b0b3655d1977 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
# Architecture

_This document describes the high-level architecture of Metalang99._

## Interpreter

The interpreter interprets the core metalanguage described in the [specification].

[specification]: https://github.com/hirrolot/metalang99/blob/master/spec/spec.pdf

### `eval/eval.h`

`eval/eval.h` exposes a single macro `ML99_PRIV_EVAL` which evaluates a given metaprogram. It is implemented as a machine in [continuation-passing style] which is described in the specification too.

[continuation-passing style]: https://en.wikipedia.org/wiki/Continuation-passing_style

### `eval/rec.h`

`eval/rec.h` contains a macro recursion engine upon which everything executes.

## Standard library

The Metalang99 standard library is a set of functions implemented using the core metalanguage. They are located inside corresponding files listed at the [documentation]'s front page.

[documentation]: https://metalang99.readthedocs.io/en/latest/