Release 1.5.3

.gitignore

@@ -6,6 +6,8 @@
 /scratch.fnl
 /chroot
 /bootstrap/view.lua
+/bootstrap/macros.lua
+/bootstrap/match.lua
 /test/faith.lua
 
 # items related to manpage generation

Makefile

@@ -225,6 +225,7 @@ guard-%:
 # 1. Check for changes which need to be mentioned in help text or man page
 # 2. Date `changelog.md` and update download links in `setup.md`
 # 3. Run `make prerelease VERSION=$VERSION`
-# 4. Run `make release VERSION=$VERSION`
-# 5. Update fennel submodule in fennel-lang.org and make upload there
-# 6. Announce on the mailing list
+# 4. Update fennel-lang.org's fennel submodule and `make html` there
+# 5. Run `make release VERSION=$VERSION`
+# 6. Run `make upload` in fennel-lang.org.
+# 7. Announce on the mailing list

changelog.md

@@ -6,6 +6,12 @@ Note that since 0.3.0, no deprecations have actually resulted in
 removals. They are advisory only and we have no plans to break the
 deprecated forms.
 
+## 1.5.3 / 2025-02-16
+
+### Bug Fixes
+
+* Correct a typo causing builds to fail on a fresh checkout.
+
 ## 1.5.2 / 2025-02-16
 
 ### New Features

man/man3/fennel-api.3

@@ -14,7 +14,7 @@
 . ftr VB CB
 . ftr VBI CBI
 .\}
-.TH "fennel-api" "3" "2025-02-10" "fennel 1.5.2" "Fennel\[aq]s Lua API"
+.TH "fennel-api" "3" "2025-02-16" "fennel 1.5.3" "Fennel\[aq]s Lua API"
 .hy
 .SH NAME
 .PP

man/man5/fennel-reference.5

@@ -14,7 +14,7 @@
 . ftr VB CB
 . ftr VBI CBI
 .\}
-.TH "fennel-reference" "5" "2025-02-10" "fennel 1.5.2" "Fennel Reference"
+.TH "fennel-reference" "5" "2025-02-16" "fennel 1.5.3" "Fennel Reference"
 .hy
 .SH NAME
 .PP
@@ -1328,7 +1328,7 @@ can return a number corresponding to any of the table\[aq]s
 If a table has nils and you want to know the last consecutive numeric
 index starting at 1, you must calculate it yourself with
 \f[V]ipairs\f[R]; if you want to know the maximum numeric key in a table
-with nils, you can use \f[V]table.maxn\f[R] on some versions of Lua.
+with nils, you can use \f[V]table.maxn\f[R] on Lua <= 5.2.
 .PP
 Example:
 .IP
@@ -2103,6 +2103,21 @@ site.
 list/symbol as its third argument in order to provide pinpointed error
 messages.
 .PP
+The following functions standardize Lua globals that change between
+5.1-5.4.
+To limit common Lua-compatibility boilerplate such as
+\f[V](local unpack (or _G.unpack table.unpack))\f[R] from macro code,
+the following helpers are present in the macro environment:
+.IP \[bu] 2
+\f[V]unpack\f[R] - \f[V]_G.unpack\f[R] in Lua 5.1/LuaJit,
+\f[V]table.unpack\f[R] in Lua >= 5.2
+.IP \[bu] 2
+\f[V]pack\f[R] - Equivalent to \f[V]table.pack\f[R] available in Lua 5.2
+and up.
+\f[V](pack :a nil :c nil nil)\f[R] -> \f[V]{1 :a 3 :c :n 5}\f[R].
+Useful for reliably storing and correctly reproducing multi-values that
+contain \f[V]nil\f[R].
+.PP
 These functions can be used from within macros only, not from any
 \f[V]eval-compiler\f[R] call:
 .IP \[bu] 2
@@ -2111,6 +2126,7 @@ Returns the symbol or \f[V]nil\f[R].
 .IP \[bu] 2
 \f[V]macroexpand\f[R] - performs macroexpansion on its argument form;
 returns an AST.
+.SS Note: Compile-time List implementation
 .PP
 Note that lists are compile-time concepts that don\[aq]t exist at
 runtime; they are implemented as tables which have a special metatable
@@ -2119,6 +2135,7 @@ brackets.
 Similarly symbols are tables with a string entry for their name and a
 marker metatable.
 You can use \f[V]tostring\f[R] to get the name of a symbol.
+.SS Sandboxing
 .PP
 As of 1.0.0 the compiler will not allow access to the outside world
 (\f[V]os\f[R], \f[V]io\f[R], etc) from macros.

man/man7/fennel-tutorial.7

@@ -14,7 +14,7 @@
 . ftr VB CB
 . ftr VBI CBI
 .\}
-.TH "fennel-tutorial" "7" "2025-02-10" "fennel 1.5.2" "Getting Started with Fennel"
+.TH "fennel-tutorial" "7" "2025-02-16" "fennel 1.5.3" "Getting Started with Fennel"
 .hy
 .SH NAME
 .PP

setup.md

@@ -35,12 +35,12 @@ installed on your system.
 This method requires you to manually update the `fennel` script when
 you want to use a newer version that has come out.
 
-1. Download [the fennel script](https://fennel-lang.org/downloads/fennel-1.5.2)
-2. Run `chmod +x fennel-1.5.2` to make it executable
+1. Download [the fennel script](https://fennel-lang.org/downloads/fennel-1.5.3)
+2. Run `chmod +x fennel-1.5.3` to make it executable
 3. Download [and verify](https://fennel-lang.org/security#signatures)
-   the [signature](https://fennel-lang.org/downloads/fennel-1.5.2.asc)
+   the [signature](https://fennel-lang.org/downloads/fennel-1.5.3.asc)
    (optional).
-4. Move `fennel-1.5.2` to a directory on your `$PATH`, such as `/usr/local/bin`
+4. Move `fennel-1.5.3` to a directory on your `$PATH`, such as `/usr/local/bin`
 
 **Note**: You can rename the script to `fennel` for convenience. Or
 you can leave the version in the name, which makes it easy to keep
@@ -57,11 +57,11 @@ This method requires you to manually update the `fennel` binary when
 you want to use a newer version that has come out.
 
  1. Choose one the options below, depending on your system:
-      - [GNU/Linux x86_64](https://fennel-lang.org/downloads/fennel-1.5.2-x86_64)
-        ([signature](https://fennel-lang.org/downloads/fennel-1.5.2-x86_64.asc))
-      - [Windows](https://fennel-lang.org/downloads/fennel-1.5.2.exe)
-        ([signature](https://fennel-lang.org/downloads/fennel-1.5.2.exe.asc))
- 2. Run `chmod +x fennel-1.5.2*` to make it executable
+      - [GNU/Linux x86_64](https://fennel-lang.org/downloads/fennel-1.5.3-x86_64)
+        ([signature](https://fennel-lang.org/downloads/fennel-1.5.3-x86_64.asc))
+      - [Windows](https://fennel-lang.org/downloads/fennel-1.5.3.exe)
+        ([signature](https://fennel-lang.org/downloads/fennel-1.5.3.exe.asc))
+ 2. Run `chmod +x fennel-1.5.3*` to make it executable
  3. Download [and verify](https://fennel-lang.org/security#signatures) the signature
     (optional).
  4. Move the downloaded binary to a directory on your `$PATH`, such as `/usr/local/bin`
@@ -93,7 +93,7 @@ them all here; please [see the wiki page on distribution for details](https://wi
 
 The Fennel compiler can be added to your application and then loaded from Lua.
 
- 1. Add [fennel.lua](https://fennel-lang.org/downloads/fennel-1.5.2.lua) to your code repository.
+ 1. Add [fennel.lua](https://fennel-lang.org/downloads/fennel-1.5.3.lua) to your code repository.
  2. Add the following line to your Lua code:
 
 ```lua

src/fennel.fnl

@@ -186,7 +186,7 @@
 (let [env (specials.make-compiler-env nil compiler.scopes.compiler {})]
   (set env.utils utils) ; for import-macros to propagate compile opts
   (set env.get-function-metadata specials.get-function-metadata)
-  (load-macros (embed-src "build/macros.lua") env)
-  (load-macros (embed-src "build/match.lua") env))
+  (load-macros (embed-src "bootstrap/macros.lua") env)
+  (load-macros (embed-src "bootstrap/match.lua") env))
 
 mod

src/fennel/utils.fnl

@@ -5,7 +5,7 @@
 
 (local view (require :fennel.view))
 
-(local version :1.5.2)
+(local version :1.5.3)
 
 ;;; Cross-Lua compat helpers