From 37c9e1ce3851dc4cf8269a462df8850848e69edf Mon Sep 17 00:00:00 2001 From: Alexander M Pickering Date: Wed, 18 Dec 2024 20:38:56 -0600 Subject: Edits --- html/index.html | 30 ++++++++++++++++-------------- 1 file changed, 16 insertions(+), 14 deletions(-) (limited to 'html') diff --git a/html/index.html b/html/index.html index 22e9b6a..b65c90e 100644 --- a/html/index.html +++ b/html/index.html @@ -27,9 +27,9 @@

Rational

-

Unlike alternative distributions, Lua4Win comes with the Luarocks package manager and is a "batteries-not-included" distribution of Lua. Binary packages are built in the cloud and can be downloaded as-needed. The Lua4Win installer contains a copy of LuaJIT, Luarocks, Busybox, and 7zip; which allows it to come in at a slim 2MB. Updates and bugfixes can be done piecemeal instead of requireing new copies of the whole distribution every time a bug gets fixed.

+

Lua4Win is a distribution of the Lua programming language for Windows. Lua4Win comes with the Luarocks package manager and is a "batteries-not-included" distribution of Lua. Binary packages are built remotely and are downloaded as-needed. The Lua4Win installer contains a copy of LuaJIT, Luarocks, Busybox, and 7zip; which allows it to come in at a slim 2MB. Updates and bugfixes to libraries can be done piecemeal instead of requiring new copies of the whole distribution every time a bug gets fixed.

-
+

Usage

After installing, you can launch cmd.exe and run $ lua to get started.

$ lua
@@ -69,23 +69,25 @@ os.execute("notepad.exe " .. note_filename)

Installing Superpowers

You can use modules that implement more than the standard lua libraries by running the $ luarocks install >module name< command to download and install modules.

-
+
color.lua
- 
local eansi = require("eansi")
-eansi.enable = true
-print(eansi.toansi("green") .. "> implying you need modules" .. eansi(""))
+ 
$ luarocks install easni
- 
$ luarocks install eansi
-
-$ lua color.lua
+ 
local ansi = require("eansi")
+ansi.enable = true
+local green = ansi.toansi("green")
+print(green .. "> implying you need modules")
+
+
+ 
$ lua color.lua
-

Run luarocks --help for more options on the command line tool, and the Luarocks wiki for more extensive documentation.

+

Run $ luarocks --help for more options on the command line tool, and see the Luarocks wiki for more extensive documentation.

Sister languages

@@ -144,10 +146,10 @@ ab

Advanced Usage

-

Lua4Win allows you to install system-wide packages with the 

--tree system
flag, these packages will be located at 
[INSTALLDIR]/luarocks
. You may need to be running as an administratior to install to this location.

-

Lua4Win's luarocks config lives at 

[INSTALLDIR]/config/config-5.1.lua

-

All of Lua4Win's binary packages are built using mingw64, if you intend to build your own modules, they must be built with mingw64 if you want them to operate with Lua4Win-distributed Lua.

-

Some of Lua4Win's packages needed patching or modification, source code is generally mirrored at git.lua4.win, and packaging code is kept seperate, usually in a repo 

*-packaging

+

By default, Lua4Win will install packages in a user-local location, at %APPDATA%/luarocks. You can instead choose to install system-wide packages for all users with the --tree system flag, these packages will be located at [INSTALLDIR]/luarocks. You may need to be running as an administrator to install to this location.

+

Lua4Win's luarocks configuration lives at [INSTALLDIR]/config/config-5.1.lua, and is a regular Lua file you can modify.

+

All of Lua4Win's binary packages are built using mingw64. If you intend to build your own modules they must be built with mingw64 if you want them to interoperate with Lua4Win-distributed Lua.

+

Some of Lua4Win's packages needed patching or modification, source code is generally mirrored at git.lua4.win, and packaging code is kept separate- usually in a 

*-packaging
repo.

-- cgit v1.2.3-55-g6feb