From 24f7e919339e7d29608a7029649118b76ba04393 Mon Sep 17 00:00:00 2001
From: Trevor Brown <admin@stratus3d.com>
Date: Mon, 17 Aug 2026 09:31:40 -0400
Subject: [PATCH] chore: generate asdf help callback scripts

---
 Makefile          |  2 +-
 bin/help.config   | 46 ++++++++++++++++++++++++++++++++++++++++++++++
 bin/help.deps     | 36 ++++++++++++++++++++++++++++++++++++
 bin/help.links    | 38 ++++++++++++++++++++++++++++++++++++++
 bin/help.overview | 23 +++++++++++++++++++++++
 5 files changed, 144 insertions(+), 1 deletion(-)
 create mode 100755 bin/help.config
 create mode 100755 bin/help.deps
 create mode 100755 bin/help.links
 create mode 100755 bin/help.overview

diff --git a/Makefile b/Makefile
index 7d48349..c097333 100644
--- a/Makefile
+++ b/Makefile
@@ -10,6 +10,6 @@ fmt:
 	shfmt --language-dialect bash --indent 2 --write bin/*
 
 lint:
-	shellcheck --shell bash --external-sources bin/*
+	shellcheck --shell bash bin/* lib/*
 
 .PHONY: precommit test test_luajit lint
diff --git a/bin/help.config b/bin/help.config
new file mode 100755
index 0000000..2a3524a
--- /dev/null
+++ b/bin/help.config
@@ -0,0 +1,46 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+IFS=$'\t\n'
+
+version="${ASDF_INSTALL_VERSION:-}"
+
+cat <<'EOF'
+Environment Variables:
+
+  ASDF_LUA_LUAROCKS_VERSION
+    Specify the LuaRocks version to install (Lua 5.x only, not LuaJIT).
+    If not set, the latest version of LuaRocks will be installed.
+    Example: export ASDF_LUA_LUAROCKS_VERSION=3.9.2
+EOF
+
+if [ -n "$version" ]; then
+  if [[ ! "$version" == LuaJIT-* ]]; then
+    IFS='.' read -ra version_array <<<"$version"
+    major_minor="${version_array[0]}${version_array[1]}"
+
+    if [ "$major_minor" = "54" ]; then
+      cat <<'EOF'
+
+  ASDF_LUA_LINUX_READLINE
+    Enable readline support for Lua 5.4.x on Linux.
+    Readline is optional for Lua 5.4 and disabled by default.
+    Set to 1 to enable: export ASDF_LUA_LINUX_READLINE=1
+EOF
+    fi
+  fi
+else
+  cat <<'EOF'
+
+  ASDF_LUA_LINUX_READLINE
+    Enable readline support for Lua 5.4.x on Linux.
+    Readline is optional for Lua 5.4 and disabled by default.
+    Set to 1 to enable: export ASDF_LUA_LINUX_READLINE=1
+
+Readline Support by Version:
+  - Lua 5.1 - 5.3: Readline is required (build fails without libreadline-dev)
+  - Lua 5.4: Readline is optional and disabled by default
+  - Lua 5.5+: Readline is loaded dynamically at runtime if available
+  - LuaJIT: Does not use readline
+EOF
+fi
diff --git a/bin/help.deps b/bin/help.deps
new file mode 100755
index 0000000..1929f68
--- /dev/null
+++ b/bin/help.deps
@@ -0,0 +1,36 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+IFS=$'\t\n'
+
+os="$(uname -s)"
+
+if [ "$os" = "Darwin" ]; then
+  cat <<EOF
+xcode-select
+EOF
+elif [ "$os" = "Linux" ]; then
+  if command -v apt-get >/dev/null 2>&1; then
+    cat <<EOF
+build-essential
+linux-headers
+libreadline-dev
+EOF
+  elif command -v yum >/dev/null 2>&1; then
+    cat <<EOF
+devtoolset-2
+readline-devel
+EOF
+  else
+    cat <<EOF
+gcc
+make
+readline-devel
+EOF
+  fi
+else
+  cat <<EOF
+gcc
+make
+EOF
+fi
diff --git a/bin/help.links b/bin/help.links
new file mode 100755
index 0000000..0c2f349
--- /dev/null
+++ b/bin/help.links
@@ -0,0 +1,38 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+IFS=$'\t\n'
+
+version="${ASDF_INSTALL_VERSION:-}"
+lua_type="Lua"
+
+if [ -n "$version" ]; then
+  if [[ "$version" == LuaJIT-* ]]; then
+    lua_type="LuaJIT"
+  fi
+fi
+
+if [ "$lua_type" = "LuaJIT" ]; then
+  cat <<EOF
+LuaJIT Homepage: https://luajit.org
+LuaJIT Repository: https://github.com/LuaJIT/LuaJIT
+Download: https://luajit.org/download.html
+Documentation: https://luajit.org/luajit.html
+Mailing List: https://luajit.org/list.html
+EOF
+else
+  cat <<EOF
+Lua Homepage: https://www.lua.org
+Documentation: https://www.lua.org/docs.html
+Reference Manual: https://www.lua.org/manual/5.5/
+Getting Started: https://www.lua.org/start.html
+Download: https://www.lua.org/download.html
+Mailing List: https://www.lua.org/lua-l.html
+Community: https://www.lua.org/community.html
+EOF
+fi
+
+cat <<EOF
+Plugin Repository: https://github.com/Stratus3D/asdf-lua
+LuaRocks: https://luarocks.org
+EOF
diff --git a/bin/help.overview b/bin/help.overview
new file mode 100755
index 0000000..f0f1bbd
--- /dev/null
+++ b/bin/help.overview
@@ -0,0 +1,23 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+IFS=$'\t\n'
+
+version="${ASDF_INSTALL_VERSION:-}"
+lua_type="Lua"
+
+if [ -n "$version" ]; then
+  if [[ "$version" == LuaJIT-* ]]; then
+    lua_type="LuaJIT"
+  fi
+fi
+
+if [ "$lua_type" = "LuaJIT" ]; then
+  cat <<EOF
+LuaJIT is a Just-In-Time Compiler for the Lua programming language. It combines a high-speed interpreter with a state-of-the-art JIT compiler, making it one of the fastest dynamic language implementations. LuaJIT is compatible with Lua 5.1 API and includes the FFI library for calling C functions and manipulating C data structures.
+EOF
+else
+  cat <<EOF
+Lua is a powerful, efficient, lightweight, embeddable scripting language. It supports procedural, object-oriented, functional, data-driven, and data description programming styles. Lua is dynamically typed, runs by interpreting bytecode with a register-based virtual machine, and has automatic memory management with incremental garbage collection.
+EOF
+fi