From 9305f475250df547e7be4599632020334d15ada4 Mon Sep 17 00:00:00 2001 From: Kim Alvefur Date: Tue, 28 Mar 2023 11:42:20 +0200 Subject: teal-src/README: Words on Compiling to Lua --- teal-src/README.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) (limited to 'teal-src') diff --git a/teal-src/README.md b/teal-src/README.md index 6e3f9c26..e8c47035 100644 --- a/teal-src/README.md +++ b/teal-src/README.md @@ -24,6 +24,23 @@ Some editors and IDEs also have support, see [text editor support](https://github.com/teal-language/tl#text-editor-support) +## Compiling to Lua + +`GNUmakefile` contains a rule for building Lua files from Teal sources. +It also applies [LuaFormat](https://github.com/Koihik/LuaFormatter) to +make the resulting code more readable, albeit this makes the line +numbers no longer match the original Teal source. Sometimes minor +`luacheck` issues remain, such as types being represented as unused +tables, which can be removed. + +```bash +sensible-editor teal-src/prosody/util/example.tl +# Write some code, remember to run tl check +make util/example.lua +sensible-editor util/example.lua +# Apply any minor tweaks that may be needed +``` + ## Files of note `module.d.tl` -- cgit v1.2.3