From dbde9388571b788bf7c0f06f23521ad2f94ebfa1 Mon Sep 17 00:00:00 2001
From: RayPals <raypals@noreply.codeberg.org>
Date: Mon, 1 Jun 2026 00:53:29 +0200
Subject: [PATCH] Add docs/FORMATTER.md from Claro v1.17.26 zip

---
 docs/FORMATTER.md | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)
 create mode 100644 docs/FORMATTER.md

diff --git a/docs/FORMATTER.md b/docs/FORMATTER.md
new file mode 100644
index 0000000..e705887
--- /dev/null
+++ b/docs/FORMATTER.md
@@ -0,0 +1,25 @@
+# Claro Formatter
+
+Run:
+```bash
+claro fmt file.claro
+claro fmt file.claro --inplace
+```
+
+## What it does (Beta18)
+- Removes trailing whitespace
+- Normalizes indentation for common block structures:
+  - TEACH/LEARNED
+  - IF/ELSE/ENDIF
+  - FOR/DONE
+  - TRY/CATCH/ENDTRY
+  - DO/DONE
+  - REPEAT/UNTIL
+  - COMMENT/ENDCOMMENT
+
+Indentation step is 4 spaces.
+
+## What it does NOT do yet
+- Reflow long lines
+- Rename variables
+- Enforce style beyond indentation and whitespace