about summary refs log tree commit diff stats
path: root/main.lua
diff options
context:
space:
mode:
authorKartik K. Agaram <vc@akkartik.com>2023-04-09 11:00:35 -0700
committerKartik K. Agaram <vc@akkartik.com>2023-04-09 11:12:36 -0700
commit4b43e9e85d985bcedd105fa9693ae751e5b6d0b6 (patch)
tree2075470990071df57ba9dda3dd078841ab14bef9 /main.lua
parent25e7eb99a9f0d23dc2948812ba5f61da95d73948 (diff)
downloadtext.love-4b43e9e85d985bcedd105fa9693ae751e5b6d0b6.tar.gz
deemphasize the source editor
This repo does not support freewheeling modification. It's a primitive
to enable freewheeling modification in downstream forks.

The source editor is a convenience, but it's a sharp tool and can easily
leave the app in a broken state that requires dropping down to external
tools (editor, file manager) to fix.
Diffstat (limited to 'main.lua')
-rw-r--r--main.lua12
1 files changed, 10 insertions, 2 deletions
diff --git a/main.lua b/main.lua
index 13f2d6a..a59c483 100644
--- a/main.lua
+++ b/main.lua
@@ -1,5 +1,13 @@
--- Entrypoint for the app. You can edit this file from within the app if
--- you're careful.
+-- Wrapper that combines the app with a 'source editor' that allows editing
+-- the app in place.
+--
+-- The source editor is a sharp tool. I find it convenient, but I also often
+-- end up in a bad state that requires dropping down to external tools
+-- (editor, file manager) to fix.
+--
+-- Downstream forks provide a better, "freewheeling" experience for editing
+-- apps live. The source editor provides a half-baked experience for editing
+-- some of the primitives used by true freewheeling apps.
 
 -- files that come with LÖVE; we can't edit those from within the app
 utf8 = require 'utf8'