Add docs/FORMATTER.md from Claro v1.17.26 zip

2026-06-01 00:53:29 +02:00
parent 72b1ab8f98
commit dbde938857
1 changed files with 25 additions and 0 deletions
@@ -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