feat(discard): add docs

bakpakin · Nov 19, 2024 · 991a167 · 991a167
1 parent 72a32ca
commit 991a167
Show file tree

Hide file tree

Showing 6 changed files with 1,634 additions and 2,022 deletions.
diff --git a/changelog.md b/changelog.md
@@ -14,6 +14,10 @@ deprecated forms.
 * Accept `:global-mangle false` in compiler opts to disable global mangling.
 * Macro sandbox can now read (but not write) files.
 
+### New Features
+
+* Add support for discarding (Clojure's `#_`).
+
 ### Bug Fixes
 
 * Work around string formatting bug in Fengari.

diff --git a/from-clojure.md b/from-clojure.md
@@ -464,6 +464,20 @@ other macros.
 
 Lists and symbols are strictly compile-time concepts in Fennel.
 
+## Discards
+
+Just like Clojure, Fennel supports the `#_` <https://clojure.org/guides/weird_characters#_discard>
+
+```fennel
+[1 #_ {:a :b} 3 #_ #_ (+ 4 5) 6 7 #_]
+```
+
+expands to
+
+```fennel
+[1 3 7]
+```
+
 ## Errors
 
 There are two kinds of ways to represent failure in Lua and