lglicua Files

Briefly Introducing Project lglicua:

PUC-Rio provides Lua, a small, powerful, fast and free scripting language.

• Lua emerged from PUC-Rio's Tecgraf group, but is now in LabLua, within the Department of Computer Science.

• A substantial repository of third-party libraries from the wider Lua community is provided via a manager called LuaRocks.

• Tecgraf publishes a cross-platform scientific/technical toolkit, based on IM (Image Manipution), CD (Canvas Draw) and IUP (Toolkit for GUIs).

This project, lglicua, strives to help install and use Lua+LuaRocks+IM/CD/IUP on GNU/Linux platforms. For more detail about this Assistant, see the Full README.

If desired, the project can just be used as a quick way to get Lua, LuaRocks and a tailored set of rocks installed on a system, without using the Tecgraf IM/CD/IUP toolset. This includes having multiple versions of lua (e.g. 5.1 + 5.4), with corresponding LuaRocks trees, with commands to switch versions.

---

Release History:

0.1-beta2 (27 July 2024)

• Consolidated Lua build code to be generic, not family-specific;
• Added recently-released Lua 5.4.7;
• Updated LuaRocks from 3.9.2 to latest stable 3.11.1;

• Has been tested against more GNU/Linux distributions and releases. These come from the Debian/Ubuntu family (Debian, Kali, Linux Mint, MX and Ubuntu) or the Red Hat family (CentOS, CentOS-Stream and Rocky). Whitelisting by name and major version number is used. ** CentOS: Core-7, Stream-8 and Stream-9; ** Debian 12.5; ** Kali 2024.2; ** Linux Mint 19.3, 20.3, 21.3 and newly-released 22; ** MX 23.3_ahs_x64; ** Rocky: 8.10, 9.3 and 9.4; and ** Ubuntu: 22.04.4, 23.10 and 24.04.

• Linux kernels include 3.10, 4.18, 5.4, 5.14, 5.15, 6.1, 6.5, 6.8, 6.8.11 and 6.9.8.

• GCC versions span 4.8.5 (CentOS Core-7) to 13.2 (Linux Mint-22 and Ubuntu 24.04).

0.1-beta1 (20 June 2023)

• Added gcc-diagnostics.lua, which had previously been separated from build/parse-build.lua, but which had been omitted from the release files;
• Updated gcc-diagnostics to include new diagnostics issued by GCC 13.x;
• Moved build/gcc-diagnostics.lua into build/support/, and updated parse-build.lua accordingly; and
• tecmake.mak updated from 4.30 to 4.31, with trivial coding style changes that (a) improve code consistency, and (b) help lay the groundwork for future changes.

0.1-alpha8 (31 May 2023)

• Upgraded Lua 5.4 to 5.4.6 (skipped 5.4.5, which was withdrawn);
• "lua-install" now lets the user specify patchlevel (e.g. 5.4.4);
• "lua-install" allows optional Lua tailoring patches. The only supported one at present is "5.4+continue". All patches are reported in the Version/Copyright line. A terse Lua script demo, "cont", shows changes in behaviour due to continue:

    --- cont -- Try continue-keyword patch.
    local IsPerfectLE500 = {[6] = true, [28] = true, [496] = true, }
    for i = 1, 30 do
            if IsPerfectLE500[i] then
                    io.write(" PERFECT!: ",tostring(i),"\n") ; continue
            end
            io.write(tostring(i),",")
    end

** With continue ("./i lua-install 5.4+continue"):

    # Lua 5.4.6 +continue  Copyright (C) 1994-2023 Lua.org, PUC-Rio
    1,2,3,4,5, PERFECT!: 6
    7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27, PERFECT!: 28
    29,30,

** Without continue ("./i lua-install 5.4"; also, "continue" commented out on line 6, otherwise a syntax error occurs):

    # Lua 5.4.6  Copyright (C) 1994-2023 Lua.org, PUC-Rio
    1,2,3,4,5, PERFECT!: 6
    6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27, PERFECT!: 28
    28,29,30,

• Rocky 9.2, released 16 May 2023, works (and worked with -alpha7);
• Distributions using GNU/Linux Kernel 6, notably MX Linux 21.3, now work with the Assistant. Tecgraf's "tecmake.mak" has undergone a non-trivial set of patches to allow this to happen; the Assistant merely copies a modified tecmake.mak (and a modified iup/srcweb/config.mak, if applicable) over the top of the workspace (SourceForge-derived) version, each time a build is requested.

0.1-alpha7 (21 March 2023)

• Upgraded LuaRocks to version 3.9.2;
• Added support for Rocky 9 and 9.1 (Red Hat family);
• Added support for GNU/Linux Mint 21 and 21.1;
• Added support for Ubuntu 21.10;
• Some older (now unsupported) distributions are no longer tested, but may still work;
• build/parse-build.lua script has been updated to include GCC 12.x diagnostics, and has been reworked to reduce duplicate diagnostics;
• Long commands show progress information;
• Tecgraf project SVN fetch made more robust, with up to 5 tries for packages that fail to download, and better error handling if the entire download failed despite the extra retries.

0.1-alpha6 (16 February 2022)

• Clarified supported Lua versions and supported distributions (see README and "PROJECT/install/$ ./i" terse help).

0.1-alpha5 (13 February 2022)

• Added Rocky Linux 8.5 (Red Hat-family based) and MX Linux 21ahs (Ubuntu-family based) to the list of known distributions;
• Added support for all Lua versions from 5.1 onwards, including Lua 5.4.4, across both Ubuntu-family and (? CentOS?) Red Hat-family distros. At present, LuaJIT isn't supported;
• Lua is installed by compiling from source, possibly with backup help from Distribtion packages where available;
• Support for CentOS has been extended to all Lua major releases, despite 5.1 "baked-in" to CentOS-7 and 5.3 baked-in to Rocky 8.5;
• LuaRocks has been updated from 3.7.0 to 3.8.0;
• Fixed "cdpdf" demonstration, using math.floor in the script, in places where the Lua interface demands integers. This is a by-product of splitting "numbers" (double) in Lua 5.1 into subtypes "double" and "64-bit integer" from Lua 5.2 onwards;
• Updated "parse-build.lua" to handle warnings generated by GCC 11.2.

0.1-alpha4 (14 August 2021)

• Improved Lua 5.1/5.2/5.3 version support for Ubuntu/Linux Mint,
• Added support for CentOS-8 (Lua 5.3-only); previous support for CentOS-7 (Lua 5.1-only) remains;
• New install command lua-environment-force 5.x fer-real handles switching between supported+installed Lua versions;
• Changed LuaRocks from 3.3.1 to 3.7.0;
• Enhanced PosixExec.lua to automate and simplify child operations via a new Options parameter.
  Options include change working directory, file globbing, and setting environment variables (e.g. LC_ALL=C);
• parse-build.lua updated to handle new/reformatted disagnostics emitted by GCC 10;

0.1-alpha3 (18 July 2021)

• Fixed svn-update bug (introduced during Split CD implementation);
• Partial support for Lua versions other than 5.1;
• Added GNU/Linux Mint 20.2 to test rig;

0.1-alpha2 (21 May 2021)

• Split CD into CD+PDFlib-Lite-7+ftgl, as per Tecgraf;

0.1-alpha1 (Early May?)

• Version (effectively a Release Candidate) withdrawn after defects found;
• Implemented terse-flow installer help;
• Created a series of build/run help pages;

---

Copyright (C) 2016-2023 Grouse Software Pty Ltd. ABN 061 107 855

---

All third-party copyrights and trademarks are the property of their respective owners.