doc: add book,internal,reference,builtins sections

2026-10-19 11:11:43 +03:00
parent 306be6b82d
commit 81d07aa6e5
14 changed files with 420 additions and 2 deletions
@@ -0,0 +1,19 @@
+# Интерфейс компилятора
+
+Компилятор называется `fzc`.
+Он принимает исходные файлы `.fzs` и создаёт бинарный файл `.fzb`.
+
+```
+fzc [flags] <sources...>
+```
+
+| Флаг          | Назначение                                     |
+| ------------- | ---------------------------------------------- |
+| -h, --help    | Показать справку                               |
+| -v, --verbose | Вывести токены, AST, таблицу констант и опкоды |
+| -V, --version | Показать версию                                |
+| -o, --out     | Задать имя выходного файла                     |
+
+Если `-o` не задан, результат записывается в `a.fzb`. Пример: `fzc -v -o hello.fzb exl/hw.fzs`.
+
+VM запускается командой `fz [flags] <file path>`. Флаг `-d` или `--debug` печатает опкоды, не выполняя программу.