From c88767887f78721c09663c9a22faa2a9586e484f Mon Sep 17 00:00:00 2001 From: Richard Beckmann Date: Fri, 14 Mar 2025 23:10:57 +0000 Subject: docs: fix and optimize links in the documentation --- docs/browse_rocks.md | 2 +- docs/creating_a_rock.md | 4 +- docs/creating_luarocks_with_gnu_autotools.md | 8 +- docs/credits.md | 6 +- docs/dependencies.md | 2 +- docs/download.md | 4 +- docs/installation_instructions_for_unix.md | 2 +- docs/installation_instructions_for_windows.md | 4 +- docs/integrating_distro_modules_with_luarocks.md | 6 +- docs/luarocks.md | 2 +- docs/luarocks_through_a_proxy.md | 4 +- docs/more_resources.md | 16 +- docs/namespaces.md | 15 +- docs/release_history.md | 278 +++++++++++------------ docs/rock_file_format.md | 4 +- docs/rockspec_format.md | 24 +- docs/welcome.md | 2 +- 17 files changed, 191 insertions(+), 192 deletions(-) diff --git a/docs/browse_rocks.md b/docs/browse_rocks.md index 80be38d8..00840fa5 100644 --- a/docs/browse_rocks.md +++ b/docs/browse_rocks.md @@ -2,7 +2,7 @@ To browse rocks, simply go to: -* [http://luarocks.org](http://luarocks.org) +* [https://luarocks.org](https://luarocks.org) You can also use the [luarocks search](luarocks_search.md) command in the [luarocks](luarocks.md) command-line tool. diff --git a/docs/creating_a_rock.md b/docs/creating_a_rock.md index 07de5ca5..1d42b07f 100644 --- a/docs/creating_a_rock.md +++ b/docs/creating_a_rock.md @@ -231,7 +231,7 @@ luarocks doc ROCKNAME Now, to complete the rockspec for public consumption we need to fill the sources.url field. For that, we need the code to be available online. We have two approaches for that: if you have your source code in an online repository -such as [GitHub](GitHub)(https://github.com), you may use that directly. +such as [GitHub](https://github.com), you may use that directly. Alternatively, you can publish a tarball with the sources on the web. ### Method 1: using a repository such as Github @@ -315,7 +315,7 @@ tar czvpf luafruits-1.0.tar.gz luafruits-1.0/ And now we're ready to publish the tarball online. You can upload it to any public web server; if you need hosting space, you can use the Pages feature -from [GitHub](GitHub)(https://github.com). Your source section would then look +from [GitHub](https://github.com). Your source section would then look something like this: ```lua diff --git a/docs/creating_luarocks_with_gnu_autotools.md b/docs/creating_luarocks_with_gnu_autotools.md index 3e684691..3463ca72 100644 --- a/docs/creating_luarocks_with_gnu_autotools.md +++ b/docs/creating_luarocks_with_gnu_autotools.md @@ -5,7 +5,7 @@ default builds non-relocatable packages. For many programs it's not necessary to do anything particular to make them relocatable; applications which need to find resources at run-time may be problematic. See GNU Smalltalk for one approach (look at the RELOCATABILITY section in its configure.ac). -[Zee](http://github.com/rrthomas/zee) uses another approach, of patching in +[Zee](https://github.com/rrthomas/zee) uses another approach, of patching in paths for in-place running of the program during development, and relying on Lua search paths at run-time, purely to find Lua modules. Search for 'in_place_lua_path'. @@ -25,7 +25,7 @@ package="@PACKAGE@" detailed = [[ ]], - homepage = "http://github.com//@PACKAGE@/", + homepage = "https://github.com//@PACKAGE@", license = "" } dependencies = { @@ -60,8 +60,8 @@ EXTRA_DIST = $(PACKAGE).rockspec.in DISTCLEANFILES = $(PACKAGE).rockspec ``` -You can use [woger](http://github.com/rrthomas/woger/) to automate your +You can use [woger](https://github.com/rrthomas/woger) to automate your releases, uploading rockspecs to luarocks.org and announcements to the Lua mailing list. The details are evolving, so see woger itself for details, and a frequently-updated project such as -[luaposix](http://github.com/luaposix/luaposix/) for example Makefile.am code. +[luaposix](https://github.com/luaposix/luaposix) for example Makefile.am code. diff --git a/docs/credits.md b/docs/credits.md index e5d6232c..458f64c3 100644 --- a/docs/credits.md +++ b/docs/credits.md @@ -7,11 +7,11 @@ various forms by a number of organizations over the years and we thank every one of them: * [CNPq](http://www.cnpq.br) -* [Fábrica Digital](http://www.fabricadigital.com.br/) +* [Fábrica Digital](https://www.fabricadigital.com.br/) * [FINEP](http://www.finep.gov.br/) -* [IMPA](http://www.impa.br/) +* [IMPA](https://impa.br/) * [LabLua](http://www.lua.inf.puc-rio.br/) -* [itch.io](http://itch.io/) +* [itch.io](https://itch.io/) * [Kong](http://getkong.org/) # Developers diff --git a/docs/dependencies.md b/docs/dependencies.md index eab287aa..407fc678 100644 --- a/docs/dependencies.md +++ b/docs/dependencies.md @@ -17,7 +17,7 @@ it was installed and LuaRocks failed to find it. Dependencies of a rock are specified in its [rockspec](rockspec_format.md) file. See the complete specification of the dependency syntax in the [Rockspec format](rockspec_format.md) page and examples in rockspec files of the [public -rocks server](http://luarocks.org/). +rocks server](https://luarocks.org). # Dependency modes diff --git a/docs/download.md b/docs/download.md index fd8c6655..9413ed10 100644 --- a/docs/download.md +++ b/docs/download.md @@ -7,7 +7,7 @@ Latest release: **LuaRocks 3.11.1** - '31/May/2024' * [Tarball for Unix](https://luarocks.org/releases/luarocks-3.11.1.tar.gz) * [Windows all-in-one executable (32-bit)](https://luarocks.org/releases/luarocks-3.11.1-windows-32.zip) * [Windows all-in-one executable (64-bit)](https://luarocks.org/releases/luarocks-3.11.1-windows-64.zip) -* [other files](https://luarocks.github.io/luarocks/releases) +* [other files](https://luarocks.github.io/luarocks/releases/) For release notes and older versions, see the [release history](release_history.md). @@ -35,5 +35,5 @@ git clone git://github.com/luarocks/luarocks.git There is also a web interface available at: -* [http://github.com/luarocks/luarocks](http://github.com/luarocks/luarocks) +* [https://github.com/luarocks/luarocks](https://github.com/luarocks/luarocks) diff --git a/docs/installation_instructions_for_unix.md b/docs/installation_instructions_for_unix.md index a13db9f6..cdcdf64b 100644 --- a/docs/installation_instructions_for_unix.md +++ b/docs/installation_instructions_for_unix.md @@ -41,7 +41,7 @@ Once Lua and its dependencies are installed, it is time to install LuaRocks: * Go to the unpacked LuaRocks directory. -* To configure, build and install LuaRocks, run the following commands. The `./configure` script will attempt to detect your installation of Lua. If you get any error messages, see the section "Customizing your settings", below. +* To configure, build and install LuaRocks, run the following commands. The `./configure` script will attempt to detect your installation of Lua. If you get any error messages, see the section "[Customizing your settings](#customizing-your-settings)", below. ``` -$ ./configure --with-lua-include=/usr/local/include diff --git a/docs/installation_instructions_for_windows.md b/docs/installation_instructions_for_windows.md index be7ff400..f362ec5a 100644 --- a/docs/installation_instructions_for_windows.md +++ b/docs/installation_instructions_for_windows.md @@ -4,14 +4,14 @@ There are two packages for Windows: * if you already have a Lua installation, the single binary package which you can use: get the [latest windows-32.zip file - here](http://luarocks.github.io/luarocks/releases), unpack it and you'll + here](https://luarocks.github.io/luarocks/releases/), unpack it and you'll have a luarocks.exe ready to use. Make sure the executable is available from your executable PATH so you can run luarocks from the command line the same way you run lua. * we also provide an all-in-one package which includes Lua 5.1 and LuaRocks in source format; get the [latest win32.zip file - here](http://luarocks.github.io/luarocks/releases). The instructions below + here](https://luarocks.github.io/luarocks/releases/). The instructions below are about this package. This page refers to the second method. The all-in-one package includes diff --git a/docs/integrating_distro_modules_with_luarocks.md b/docs/integrating_distro_modules_with_luarocks.md index fb073500..b6c054ab 100644 --- a/docs/integrating_distro_modules_with_luarocks.md +++ b/docs/integrating_distro_modules_with_luarocks.md @@ -151,14 +151,14 @@ Continuing the examples above: * /usr/lib/luarocks/rocks-5.3/lua-cjson/2.1.0-0/lua-cjson-2.1.0-0.rockspec For simplicity, I would recommend just copying over the appropriate rockspec -file from [luarocks.org](http://luarocks.org) and bundling them in the package +file from [luarocks.org](https://luarocks.org) and bundling them in the package metadata. For completeness, this is how the one for LPeg 1.0 looks like: ``` package = "LPeg" version = "1.0.0-1" source = { - url = "http://www.inf.puc-rio.br/~roberto/lpeg/lpeg-1.0.0.tar.gz", + url = "https://www.inf.puc-rio.br/~roberto/lpeg/lpeg-1.0.0.tar.gz", md5 = "0aec64ccd13996202ad0c099e2877ece", } description = { @@ -171,7 +171,7 @@ description = { we expect from a pattern-matching library (and more, as we can define entire grammars). ]], - homepage = "http://www.inf.puc-rio.br/~roberto/lpeg.html", + homepage = "https://www.inf.puc-rio.br/~roberto/lpeg/lpeg.html", maintainer = "Gary V. Vaughan ", license = "MIT/X11" } diff --git a/docs/luarocks.md b/docs/luarocks.md index 91bb6731..6338743b 100644 --- a/docs/luarocks.md +++ b/docs/luarocks.md @@ -15,7 +15,7 @@ Variables from the "variables" table of the [configuration file](config_file_for |- | --only-server=_server_ || Fetch rocks/rockspecs from this server only (overrides any entries in the config file) |- -| --only-sources=_url_ || Restrict downloads of sources to URLs starting with the given URL. For example, --only-sources=http://luarocks.org will allow LuaRocks to download sources only if the URL given in the rockspec starts with http://luarocks.org . +| --only-sources=_url_ || Restrict downloads of sources to URLs starting with the given URL. For example, --only-sources=https://luarocks.org will allow LuaRocks to download sources only if the URL given in the rockspec starts with https://luarocks.org . |- | --tree=_tree_ || Which tree to operate on. |- diff --git a/docs/luarocks_through_a_proxy.md b/docs/luarocks_through_a_proxy.md index 589142fc..3d7d3b2d 100644 --- a/docs/luarocks_through_a_proxy.md +++ b/docs/luarocks_through_a_proxy.md @@ -31,6 +31,6 @@ This adds the following to your `~/.gitconfig`: ## External references -* [curl manpage](http://www.hmug.org/man/1/curl.php) +* [curl manpage](https://www.manpagez.com/man/1/curl/) * ["How to use wget through proxy"](http://blog.taragana.com/index.php/archive/how-to-use-wget-through-proxy/) -* ["Tell git to use https instead of git protocol"](http://jgoodall.me/posts/2013/05/29/git-use-https) +* ["Tell git to use https instead of git protocol"](https://jgoodall.me/2013/05/29/git-use-https.html) diff --git a/docs/more_resources.md b/docs/more_resources.md index 587ebb67..0adaffa1 100644 --- a/docs/more_resources.md +++ b/docs/more_resources.md @@ -12,21 +12,21 @@ On LuaRocks: On Lua: -* [Lua mailing list](http://www.lua.org/lua-l.html) - for questions about the Lua language itself or specific Lua modules (most module authors hang out there!) -* [Lua documentation](http://www.lua.org/docs.html) - documentation on the Lua language, including the reference manual +* [Lua mailing list](https://www.lua.org/lua-l.html) - for questions about the Lua language itself or specific Lua modules (most module authors hang out there!) +* [Lua documentation](https://www.lua.org/docs.html) - documentation on the Lua language, including the reference manual * [Lua Forum](https://luaforum.com) - a beginner friendly Lua community On LuaJIT: -* [LuaJIT mailing list](http://luajit.org/list.html) - for LuaJIT-specific discussion +* [LuaJIT mailing list](https://luajit.org/list.html) - for LuaJIT-specific discussion ## Presentations on LuaRocks Some past presentations discussing LuaRocks: -* [LuaRocks: fostering an ecosystem for Lua modules](http://hisham.hm/talks#fosdem2015), presented by Hisham Muhammad at FOSDEM 2015, Brussels, Belgium -* [What's new in LuaRocks](http://hisham.hm/talks#luawshop14), presented by Hisham Muhammad at the Lua Workshop 2014, Moscow, Russia -* [LuaRocks - past, present and future](http://hisham.hm/talks#luawshop13), presented by Hisham Muhammad at the Lua Workshop 2013, Toulouse, France -* [LuaRocks 2.0](http://hisham.hm/talks#luawshop09), presented by Hisham Muhammad at the Lua Workshop 2009, Rio de Janeiro, Brazil -* [LuaRocks: o sistema de pacotes de extensão para a linguagem Lua](http://hisham.hm/talks#fisl9), presented by Hisham Muhammad at FISL 9.0 - IX International Forum on Free Software, Porto Alegre, Brazil +* [LuaRocks: fostering an ecosystem for Lua modules](https://hisham.hm/talks#fosdem2015), presented by Hisham Muhammad at FOSDEM 2015, Brussels, Belgium +* [What's new in LuaRocks](https://hisham.hm/talks#luawshop14), presented by Hisham Muhammad at the Lua Workshop 2014, Moscow, Russia +* [LuaRocks - past, present and future](https://hisham.hm/talks#luawshop13), presented by Hisham Muhammad at the Lua Workshop 2013, Toulouse, France +* [LuaRocks 2.0](https://hisham.hm/talks#luawshop09), presented by Hisham Muhammad at the Lua Workshop 2009, Rio de Janeiro, Brazil +* [LuaRocks: o sistema de pacotes de extensão para a linguagem Lua](https://hisham.hm/talks#fisl9), presented by Hisham Muhammad at FISL 9.0 - IX International Forum on Free Software, Porto Alegre, Brazil diff --git a/docs/namespaces.md b/docs/namespaces.md index f00c692a..4591c1c4 100644 --- a/docs/namespaces.md +++ b/docs/namespaces.md @@ -19,14 +19,13 @@ repository is an address (a local directory or a remote URL) where LuaRocks can find a `manifest-5.x` file and .rock and .rockspec files. We also call such repository a "manifest", for short. -The [LuaRocks.org](LuaRocks.org)(LuaRocks.org)(https://luarocks.org) website -features a root manifest at `https://luarocks.org` as well as per-user -manifests at `https://luarocks.org/manifests/`. Entries in the -root manifest are operated in a first-come first-served manner, but even if -someone else has already taken a rock name, you can upload your own version of -it to your user manifest. You can refer to a per-user manifest the same way as -any other rocks server, adding to your configuration or using it with the -`--server` flag. This means that you were always able to install your own +The [LuaRocks.org](https://luarocks.org) website features a root manifest at +`https://luarocks.org` as well as per-user manifests at +`https://luarocks.org/manifests/`. Entries in the root +manifest are operated in a first-come first-served manner, but even if someone +else has already taken a rock name, you can upload your own version of it to +your user manifest. You can refer to a per-user manifest the same way as any +other rocks server, adding to your configuration or using it with the`--server` flag. This means that you were always able to install your own version of a rock using a command such as `luarocks install --server=https://luarocks.org/manifests/`. However, you could not specifically depend on it from another rockspec, and once installed, the diff --git a/docs/release_history.md b/docs/release_history.md index 4759fe17..52c61893 100644 --- a/docs/release_history.md +++ b/docs/release_history.md @@ -1,40 +1,40 @@ # Release history -**Version 3.11.1** - 31/May/2024 - [Source tarball for Unix](http://luarocks.org/releases/luarocks-3.11.1.tar.gz) - -[Windows binary (32-bit)](http://luarocks.org/releases/luarocks-3.11.1-windows-32.zip) - -[Windows binary (64-bit)](http://luarocks.org/releases/luarocks-3.11.1-windows-64.zip) - -[Linux binary (x86_64)](http://luarocks.org/releases/luarocks-3.11.1-linux-x86_64.zip) - -[other files](http://luarocks.github.io/luarocks/releases) - -**Version 3.11.0** - 13/Mar/2024 - [Source tarball for Unix](http://luarocks.org/releases/luarocks-3.11.0.tar.gz) - -[Windows binary (32-bit)](http://luarocks.org/releases/luarocks-3.11.0-windows-32.zip) - -[Windows binary (64-bit)](http://luarocks.org/releases/luarocks-3.11.0-windows-64.zip) - -[Linux binary (x86_64)](http://luarocks.org/releases/luarocks-3.11.0-linux-x86_64.zip) - -[other files](http://luarocks.github.io/luarocks/releases) - -**Version 3.10.0** - 27/Feb/2024 - [Source tarball for Unix](http://luarocks.org/releases/luarocks-3.10.0.tar.gz) - -[Windows binary (32-bit)](http://luarocks.org/releases/luarocks-3.10.0-windows-32.zip) - -[Windows binary (64-bit)](http://luarocks.org/releases/luarocks-3.10.0-windows-64.zip) - -[Linux binary (x86_64)](http://luarocks.org/releases/luarocks-3.10.0-linux-x86_64.zip) - -[other files](http://luarocks.github.io/luarocks/releases) - -**Version 3.9.2** - 08/Dec/2022 - [Source tarball for Unix](http://luarocks.org/releases/luarocks-3.9.2.tar.gz) - -[Windows binary (32-bit)](http://luarocks.org/releases/luarocks-3.9.2-windows-32.zip) - -[Windows binary (64-bit)](http://luarocks.org/releases/luarocks-3.9.2-windows-64.zip) - -[Linux binary (x86_64)](http://luarocks.org/releases/luarocks-3.9.2-linux-x86_64.zip) - -[other files](http://luarocks.github.io/luarocks/releases) - -**Version 3.9.1** - 01/Jul/2022 - [Source tarball for Unix](http://luarocks.org/releases/luarocks-3.9.1.tar.gz) - -[Windows binary (32-bit)](http://luarocks.org/releases/luarocks-3.9.1-windows-32.zip) - -[Windows binary (64-bit)](http://luarocks.org/releases/luarocks-3.9.1-windows-64.zip) - -[Linux binary (x86_64)](http://luarocks.org/releases/luarocks-3.9.1-linux-x86_64.zip) - -[other files](http://luarocks.github.io/luarocks/releases) - -**Version 3.9.0** - 17/Apr/2022 - [Source tarball for Unix](http://luarocks.org/releases/luarocks-3.9.0.tar.gz) - -[Windows binary (32-bit)](http://luarocks.org/releases/luarocks-3.9.0-windows-32.zip) - -[Windows binary (64-bit)](http://luarocks.org/releases/luarocks-3.9.0-windows-64.zip) - -[Linux binary (x86_64)](http://luarocks.org/releases/luarocks-3.9.0-linux-x86_64.zip) - -[other files](http://luarocks.github.io/luarocks/releases) +**Version 3.11.1** - 31/May/2024 - [Source tarball for Unix](https://luarocks.github.io/luarocks/releases/luarocks-3.11.1.tar.gz) - +[Windows binary (32-bit)](https://luarocks.github.io/luarocks/releases/luarocks-3.11.1-windows-32.zip) - +[Windows binary (64-bit)](https://luarocks.github.io/luarocks/releases/luarocks-3.11.1-windows-64.zip) - +[Linux binary (x86_64)](https://luarocks.github.io/luarocks/releases/luarocks-3.11.1-linux-x86_64.zip) - +[other files](https://luarocks.github.io/luarocks/releases/) + +**Version 3.11.0** - 13/Mar/2024 - [Source tarball for Unix](https://luarocks.github.io/luarocks/releases/luarocks-3.11.0.tar.gz) - +[Windows binary (32-bit)](https://luarocks.github.io/luarocks/releases/luarocks-3.11.0-windows-32.zip) - +[Windows binary (64-bit)](https://luarocks.github.io/luarocks/releases/luarocks-3.11.0-windows-64.zip) - +[Linux binary (x86_64)](https://luarocks.github.io/luarocks/releases/luarocks-3.11.0-linux-x86_64.zip) - +[other files](https://luarocks.github.io/luarocks/releases/) + +**Version 3.10.0** - 27/Feb/2024 - [Source tarball for Unix](https://luarocks.github.io/luarocks/releases/luarocks-3.10.0.tar.gz) - +[Windows binary (32-bit)](https://luarocks.github.io/luarocks/releases/luarocks-3.10.0-windows-32.zip) - +[Windows binary (64-bit)](https://luarocks.github.io/luarocks/releases/luarocks-3.10.0-windows-64.zip) - +[Linux binary (x86_64)](https://luarocks.github.io/luarocks/releases/luarocks-3.10.0-linux-x86_64.zip) - +[other files](https://luarocks.github.io/luarocks/releases/) + +**Version 3.9.2** - 08/Dec/2022 - [Source tarball for Unix](https://luarocks.github.io/luarocks/releases/luarocks-3.9.2.tar.gz) - +[Windows binary (32-bit)](https://luarocks.github.io/luarocks/releases/luarocks-3.9.2-windows-32.zip) - +[Windows binary (64-bit)](https://luarocks.github.io/luarocks/releases/luarocks-3.9.2-windows-64.zip) - +[Linux binary (x86_64)](https://luarocks.github.io/luarocks/releases/luarocks-3.9.2-linux-x86_64.zip) - +[other files](https://luarocks.github.io/luarocks/releases/) + +**Version 3.9.1** - 01/Jul/2022 - [Source tarball for Unix](https://luarocks.github.io/luarocks/releases/luarocks-3.9.1.tar.gz) - +[Windows binary (32-bit)](https://luarocks.github.io/luarocks/releases/luarocks-3.9.1-windows-32.zip) - +[Windows binary (64-bit)](https://luarocks.github.io/luarocks/releases/luarocks-3.9.1-windows-64.zip) - +[Linux binary (x86_64)](https://luarocks.github.io/luarocks/releases/luarocks-3.9.1-linux-x86_64.zip) - +[other files](https://luarocks.github.io/luarocks/releases/) + +**Version 3.9.0** - 17/Apr/2022 - [Source tarball for Unix](https://luarocks.github.io/luarocks/releases/luarocks-3.9.0.tar.gz) - +[Windows binary (32-bit)](https://luarocks.github.io/luarocks/releases/luarocks-3.9.0-windows-32.zip) - +[Windows binary (64-bit)](https://luarocks.github.io/luarocks/releases/luarocks-3.9.0-windows-64.zip) - +[Linux binary (x86_64)](https://luarocks.github.io/luarocks/releases/luarocks-3.9.0-linux-x86_64.zip) - +[other files](https://luarocks.github.io/luarocks/releases/) * `builtin` build mode now always respects CC, CFLAGS and LDFLAGS * Check that lua.h version matches the desired Lua version @@ -53,35 +53,35 @@ * LuaRocks test suite now runs on Lua 5.4 and LuaJIT * Internal dependencies of standalone LuaRocks executable were bumped -**Version 3.8.0** - 08/Nov/2021 - [Source tarball for Unix](http://luarocks.org/releases/luarocks-3.8.0.tar.gz) - -[Windows binary (32-bit)](http://luarocks.org/releases/luarocks-3.8.0-windows-32.zip) - -[Windows binary (64-bit)](http://luarocks.org/releases/luarocks-3.8.0-windows-64.zip) - -[Linux binary (x86_64)](http://luarocks.org/releases/luarocks-3.8.0-linux-x86_64.zip) - -[other files](http://luarocks.github.io/luarocks/releases) - -**Version 3.7.0** - 13/Apr/2021 - [Source tarball for Unix](http://luarocks.org/releases/luarocks-3.7.0.tar.gz) - -[Windows binary (32-bit)](http://luarocks.org/releases/luarocks-3.7.0-windows-32.zip) - -[Windows binary (64-bit)](http://luarocks.org/releases/luarocks-3.7.0-windows-64.zip) - -[Linux binary (x86_64)](http://luarocks.org/releases/luarocks-3.7.0-linux-x86_64.zip) - -[other files](http://luarocks.github.io/luarocks/releases) - -**Version 3.6.0** - 30/Mar/2021 - [Source tarball for Unix](http://luarocks.org/releases/luarocks-3.6.0.tar.gz) - -[Windows binary (32-bit)](http://luarocks.org/releases/luarocks-3.6.0-windows-32.zip) - -[Windows binary (64-bit)](http://luarocks.org/releases/luarocks-3.6.0-windows-64.zip) - -[Linux binary (x86_64)](http://luarocks.org/releases/luarocks-3.6.0-linux-x86_64.zip) - -[other files](http://luarocks.github.io/luarocks/releases) - -**Version 3.5.0** - 10/Dec/2020 - [Source tarball for Unix](http://luarocks.org/releases/luarocks-3.5.0.tar.gz) - -[Windows binary (32-bit)](http://luarocks.org/releases/luarocks-3.5.0-windows-32.zip) - -[Windows binary (64-bit)](http://luarocks.org/releases/luarocks-3.5.0-windows-64.zip) - -[Linux binary (x86_64)](http://luarocks.org/releases/luarocks-3.5.0-linux-x86_64.zip) - -[other files](http://luarocks.github.io/luarocks/releases) - -**Version 3.4.0** - 25/Sep/2020 - [Source tarball for Unix](http://luarocks.org/releases/luarocks-3.4.0.tar.gz) - -[Windows binary (32-bit)](http://luarocks.org/releases/luarocks-3.4.0-windows-32.zip) - -[Windows binary (64-bit)](http://luarocks.org/releases/luarocks-3.4.0-windows-64.zip) - -[Linux binary (x86_64)](http://luarocks.org/releases/luarocks-3.4.0-linux-x86_64.zip) - -[other files](http://luarocks.github.io/luarocks/releases) +**Version 3.8.0** - 08/Nov/2021 - [Source tarball for Unix](https://luarocks.github.io/luarocks/releases/luarocks-3.8.0.tar.gz) - +[Windows binary (32-bit)](https://luarocks.github.io/luarocks/releases/luarocks-3.8.0-windows-32.zip) - +[Windows binary (64-bit)](https://luarocks.github.io/luarocks/releases/luarocks-3.8.0-windows-64.zip) - +[Linux binary (x86_64)](https://luarocks.github.io/luarocks/releases/luarocks-3.8.0-linux-x86_64.zip) - +[other files](https://luarocks.github.io/luarocks/releases/) + +**Version 3.7.0** - 13/Apr/2021 - [Source tarball for Unix](https://luarocks.github.io/luarocks/releases/luarocks-3.7.0.tar.gz) - +[Windows binary (32-bit)](https://luarocks.github.io/luarocks/releases/luarocks-3.7.0-windows-32.zip) - +[Windows binary (64-bit)](https://luarocks.github.io/luarocks/releases/luarocks-3.7.0-windows-64.zip) - +[Linux binary (x86_64)](https://luarocks.github.io/luarocks/releases/luarocks-3.7.0-linux-x86_64.zip) - +[other files](https://luarocks.github.io/luarocks/releases/) + +**Version 3.6.0** - 30/Mar/2021 - [Source tarball for Unix](https://luarocks.github.io/luarocks/releases/luarocks-3.6.0.tar.gz) - +[Windows binary (32-bit)](https://luarocks.github.io/luarocks/releases/luarocks-3.6.0-windows-32.zip) - +[Windows binary (64-bit)](https://luarocks.github.io/luarocks/releases/luarocks-3.6.0-windows-64.zip) - +[Linux binary (x86_64)](https://luarocks.github.io/luarocks/releases/luarocks-3.6.0-linux-x86_64.zip) - +[other files](https://luarocks.github.io/luarocks/releases/) + +**Version 3.5.0** - 10/Dec/2020 - [Source tarball for Unix](https://luarocks.github.io/luarocks/releases/luarocks-3.5.0.tar.gz) - +[Windows binary (32-bit)](https://luarocks.github.io/luarocks/releases/luarocks-3.5.0-windows-32.zip) - +[Windows binary (64-bit)](https://luarocks.github.io/luarocks/releases/luarocks-3.5.0-windows-64.zip) - +[Linux binary (x86_64)](https://luarocks.github.io/luarocks/releases/luarocks-3.5.0-linux-x86_64.zip) - +[other files](https://luarocks.github.io/luarocks/releases/) + +**Version 3.4.0** - 25/Sep/2020 - [Source tarball for Unix](https://luarocks.github.io/luarocks/releases/luarocks-3.4.0.tar.gz) - +[Windows binary (32-bit)](https://luarocks.github.io/luarocks/releases/luarocks-3.4.0-windows-32.zip) - +[Windows binary (64-bit)](https://luarocks.github.io/luarocks/releases/luarocks-3.4.0-windows-64.zip) - +[Linux binary (x86_64)](https://luarocks.github.io/luarocks/releases/luarocks-3.4.0-linux-x86_64.zip) - +[other files](https://luarocks.github.io/luarocks/releases/) * `luarocks make` now supports `--only-deps` * `luarocks make` new flag: `--no-install`, which only performs the compilation step @@ -104,25 +104,25 @@ * Fix detection of Lua path based on arg variable * Fix regression on dependency matching of luarocks.loader -**Version 3.3.1** - 07/Feb/2020 - [All Unix](http://luarocks.org/releases/luarocks-3.3.1.tar.gz) - -[Windows all-in-one executable (32-bit)](http://luarocks.org/releases/luarocks-3.3.1-windows-32.zip) - -[Windows all-in-one executable (64-bit)](http://luarocks.org/releases/luarocks-3.3.1-windows-64.zip) - -[other files](http://luarocks.github.io/luarocks/releases) +**Version 3.3.1** - 07/Feb/2020 - [All Unix](https://luarocks.github.io/luarocks/releases/luarocks-3.3.1.tar.gz) - +[Windows all-in-one executable (32-bit)](https://luarocks.github.io/luarocks/releases/luarocks-3.3.1-windows-32.zip) - +[Windows all-in-one executable (64-bit)](https://luarocks.github.io/luarocks/releases/luarocks-3.3.1-windows-64.zip) - +[other files](https://luarocks.github.io/luarocks/releases/) * Fix downgrades of rocks containing directories: stop it from creating spurious 0-byte files where directories have been * Fix error message when attempting to copy a file that is missing * Detect OpenBSD-specific dependency paths -**Version 3.3.0** - 28/Jan/2020 - [All Unix](http://luarocks.org/releases/luarocks-3.3.0.tar.gz) - -[Windows all-in-one executable](http://luarocks.org/releases/luarocks-3.3.0-windows-32.zip) - -[other files](http://luarocks.github.io/luarocks/releases) +**Version 3.3.0** - 28/Jan/2020 - [All Unix](https://luarocks.github.io/luarocks/releases/luarocks-3.3.0.tar.gz) - +[Windows all-in-one executable](https://luarocks.github.io/luarocks/releases/luarocks-3.3.0-windows-32.zip) - +[other files](https://luarocks.github.io/luarocks/releases/) -**Version 3.2.1** - 05/Sep/2019 - [All Unix](http://luarocks.org/releases/luarocks-3.2.1.tar.gz) - -[Windows all-in-one executable](http://luarocks.org/releases/luarocks-3.2.1-windows-32.zip) - -[other files](http://luarocks.github.io/luarocks/releases) +**Version 3.2.1** - 05/Sep/2019 - [All Unix](https://luarocks.github.io/luarocks/releases/luarocks-3.2.1.tar.gz) - +[Windows all-in-one executable](https://luarocks.github.io/luarocks/releases/luarocks-3.2.1-windows-32.zip) - +[other files](https://luarocks.github.io/luarocks/releases/) -**Version 3.2.0** - 28/Aug/2019 - [All Unix](http://luarocks.org/releases/luarocks-3.2.0.tar.gz) - -[Windows all-in-one executable](http://luarocks.org/releases/luarocks-3.2.0-windows-32.zip) - [other files](https://luarocks.github.io/luarocks/releases) +**Version 3.2.0** - 28/Aug/2019 - [All Unix](https://luarocks.github.io/luarocks/releases/luarocks-3.2.0.tar.gz) - +[Windows all-in-one executable](https://luarocks.github.io/luarocks/releases/luarocks-3.2.0-windows-32.zip) - [other files](https://luarocks.github.io/luarocks/releases) * Bugfix: luarocks path does not change the order of pre-existing path items when prepending or appending to path variables * Bugfix: fix directory detection on the Mac @@ -136,17 +136,17 @@ * install.bat: Improved detection for Visual Studio 2017 and higher * Bundled LuaSec in all-in-one binary bumped to version 0.8.1 -**Version 3.1.3** - 06/Jun/2019 - [All Unix](http://luarocks.org/releases/luarocks-3.1.3.tar.gz) - -[Windows all-in-one executable](http://luarocks.org/releases/luarocks-3.1.3-windows-32.zip) +**Version 3.1.3** - 06/Jun/2019 - [All Unix](https://luarocks.github.io/luarocks/releases/luarocks-3.1.3.tar.gz) - +[Windows all-in-one executable](https://luarocks.github.io/luarocks/releases/luarocks-3.1.3-windows-32.zip) -**Version 3.1.2** - 07/May/2019 - [All Unix](http://luarocks.org/releases/luarocks-3.1.2.tar.gz) - -[Windows all-in-one executable](http://luarocks.org/releases/luarocks-3.1.2-windows-32.zip) +**Version 3.1.2** - 07/May/2019 - [All Unix](https://luarocks.github.io/luarocks/releases/luarocks-3.1.2.tar.gz) - +[Windows all-in-one executable](https://luarocks.github.io/luarocks/releases/luarocks-3.1.2-windows-32.zip) -**Version 3.1.1** - 06/May/2019 - [All Unix](http://luarocks.org/releases/luarocks-3.1.1.tar.gz) - -[Windows all-in-one executable](http://luarocks.org/releases/luarocks-3.1.1-windows-32.zip) +**Version 3.1.1** - 06/May/2019 - [All Unix](https://luarocks.github.io/luarocks/releases/luarocks-3.1.1.tar.gz) - +[Windows all-in-one executable](https://luarocks.github.io/luarocks/releases/luarocks-3.1.1-windows-32.zip) -**Version 3.1.0** - 30/Apr/2019 - [All Unix](http://luarocks.org/releases/luarocks-3.1.0.tar.gz) - -[Windows all-in-one executable](http://luarocks.org/releases/luarocks-3.1.0-windows-32.zip) +**Version 3.1.0** - 30/Apr/2019 - [All Unix](https://luarocks.github.io/luarocks/releases/luarocks-3.1.0.tar.gz) - +[Windows all-in-one executable](https://luarocks.github.io/luarocks/releases/luarocks-3.1.0-windows-32.zip) * config: add git-like modes for setting and inspecting configuration * make: run rockspec patches on first `luarocks make` run and use a lockfile to avoid double patching @@ -160,20 +160,20 @@ * Improve Lua paths auto-detection * Various bugfixes -**Version 3.0.4** - 30/Oct/2018 - [All Unix](http://luarocks.org/releases/luarocks-3.0.4.tar.gz) - -[Windows all-in-one executable](http://luarocks.org/releases/luarocks-3.0.4-windows-32.zip) +**Version 3.0.4** - 30/Oct/2018 - [All Unix](https://luarocks.github.io/luarocks/releases/luarocks-3.0.4.tar.gz) - +[Windows all-in-one executable](https://luarocks.github.io/luarocks/releases/luarocks-3.0.4-windows-32.zip) * Fork-free platform detection at startup * Improved detection of the default rockspec in commands such as `luarocks test` * Various minor bugfixes -**Version 3.0.3** - 15/Sep/2018 - [All Unix](http://luarocks.org/releases/luarocks-3.0.3.tar.gz) - -[Windows all-in-one executable](http://luarocks.org/releases/luarocks-3.0.3-windows-32.zip) +**Version 3.0.3** - 15/Sep/2018 - [All Unix](https://luarocks.github.io/luarocks/releases/luarocks-3.0.3.tar.gz) - +[Windows all-in-one executable](https://luarocks.github.io/luarocks/releases/luarocks-3.0.3-windows-32.zip) * Minor bugfixes -**Version 3.0.2** - 07/Sep/2018 - [All Unix](http://luarocks.org/releases/luarocks-3.0.2.tar.gz) - -[Windows all-in-one executable](http://luarocks.org/releases/luarocks-3.0.2-windows-32.zip) +**Version 3.0.2** - 07/Sep/2018 - [All Unix](https://luarocks.github.io/luarocks/releases/luarocks-3.0.2.tar.gz) - +[Windows all-in-one executable](https://luarocks.github.io/luarocks/releases/luarocks-3.0.2-windows-32.zip) * Improvements in luarocks init, new --reset flag * write_rockspec: --lua-version renamed to --lua-versions @@ -182,16 +182,16 @@ * Fix upgrade/downgrade when a single rock has clashing module filenames * Fix for autodetected external dependencies with non-alphabetic characters -**Version 3.0.1** - 14/Aug/2018 - [All Unix](http://luarocks.org/releases/luarocks-3.0.1.tar.gz) - -[Windows all-in-one executable](http://luarocks.org/releases/luarocks-3.0.1-windows-32.zip) +**Version 3.0.1** - 14/Aug/2018 - [All Unix](https://luarocks.github.io/luarocks/releases/luarocks-3.0.1.tar.gz) - +[Windows all-in-one executable](https://luarocks.github.io/luarocks/releases/luarocks-3.0.1-windows-32.zip) * Numerous bugfixes * Store Lua location in config file, so that a user can run `luarocks init --lua-dir=/my/lua/location` and have that location remain active for that project * Various improvements to the Unix makefile, including $(DESTDIR) support and an uninstall rule * Autodetect FreeBSD-style include paths (/usr/include/lua5x/) -**Version 3.0.0** - 25/Jul/2018 - [All Unix](http://luarocks.org/releases/luarocks-3.0.0.tar.gz) - -[Windows batch installer](http://luarocks.org/releases/luarocks-3.0.0-win32.zip) +**Version 3.0.0** - 25/Jul/2018 - [All Unix](https://luarocks.github.io/luarocks/releases/luarocks-3.0.0.tar.gz) - +[Windows batch installer](https://luarocks.github.io/luarocks/releases/luarocks-3.0.0-win32.zip) * New rockspec format * New commands, including `luarocks init` for per-project workflows @@ -201,8 +201,8 @@ * User-visible changes, including some breaking changes * Internal changes -**Version 2.4.4** - 12/Mar/2018 - [All Unix](http://luarocks.org/releases/luarocks-2.4.4.tar.gz) - -[Windows](http://luarocks.org/releases/luarocks-2.4.4-win32.zip) +**Version 2.4.4** - 12/Mar/2018 - [All Unix](https://luarocks.github.io/luarocks/releases/luarocks-2.4.4.tar.gz) - +[Windows](https://luarocks.github.io/luarocks/releases/luarocks-2.4.4-win32.zip) * Do not halt a package deletion process when a file from the package is missing * Updated bundled binaries in Windows package: Lua 5.1.5, Wget 1.19.4, 7zip 18.01 @@ -210,14 +210,14 @@ * Fix detection of directories on Windows * Fixes .def generation on Windows -**Version 2.4.3** - 12/Sep/2017 - [All Unix](http://luarocks.org/releases/luarocks-2.4.3.tar.gz) - -[Windows](http://luarocks.org/releases/luarocks-2.4.3-win32.zip) +**Version 2.4.3** - 12/Sep/2017 - [All Unix](https://luarocks.github.io/luarocks/releases/luarocks-2.4.3.tar.gz) - +[Windows](https://luarocks.github.io/luarocks/releases/luarocks-2.4.3-win32.zip) * Fixed display of pathnames in `luarocks show` * Improved check for write permissions when installing * Plus assorted bugfixes and improvements -**Version 2.4.2** - 30/Nov/2016 - [All Unix](http://luarocks.org/releases/luarocks-2.4.2.tar.gz) - [Windows](http://luarocks.org/releases/luarocks-2.4.2-win32.zip) +**Version 2.4.2** - 30/Nov/2016 - [All Unix](https://luarocks.github.io/luarocks/releases/luarocks-2.4.2.tar.gz) - [Windows](https://luarocks.github.io/luarocks/releases/luarocks-2.4.2-win32.zip) * Fixed conflict resolution on deploy/delete * Improved dependency check messages @@ -227,12 +227,12 @@ * Relaxed Lua version detection to improve support for alternative implementations (e.g. Ravi) * Plus assorted bugfixes and improvements -**Version 2.4.1** - 06/Oct/2016 - [All Unix](http://luarocks.org/releases/luarocks-2.4.1.tar.gz) - [Windows](http://luarocks.org/releases/luarocks-2.4.1-win32.zip) +**Version 2.4.1** - 06/Oct/2016 - [All Unix](https://luarocks.github.io/luarocks/releases/luarocks-2.4.1.tar.gz) - [Windows](https://luarocks.github.io/luarocks/releases/luarocks-2.4.1-win32.zip) * Avoid coroutine use in luarocks.loader * Fix upgrade issues for very old versions -**Version 2.4.0** - 08/Sep/2016 - [All Unix](http://luarocks.org/releases/luarocks-2.4.0.tar.gz) - [Windows](http://luarocks.org/releases/luarocks-2.4.0-win32.zip) +**Version 2.4.0** - 08/Sep/2016 - [All Unix](https://luarocks.github.io/luarocks/releases/luarocks-2.4.0.tar.gz) - [Windows](https://luarocks.github.io/luarocks/releases/luarocks-2.4.0-win32.zip) * New test suite based on Busted; runs on Linux, OSX and Windows * git+ssh:// fetch protocol @@ -245,7 +245,7 @@ * `remove` option --force=fast renamed to --force-fast * Plus assorted bugfixes and cleanups -**Version 2.3.0** - 09/Jan/2016 - [All Unix](http://luarocks.org/releases/luarocks-2.3.0.tar.gz) - [Windows](http://luarocks.org/releases/luarocks-2.3.0-win32.zip) +**Version 2.3.0** - 09/Jan/2016 - [All Unix](https://luarocks.github.io/luarocks/releases/luarocks-2.3.0.tar.gz) - [Windows](https://luarocks.github.io/luarocks/releases/luarocks-2.3.0-win32.zip) * Windows: major redesign of the install tree structure * Windows: Auto setup of MSVC environments @@ -259,7 +259,7 @@ * Unix: Robustness improvement in configure script * Plus tweaks and bugfixes. See the changelog for details. -**Version 2.2.2** - 24/Apr/2015 - [All Unix](http://luarocks.org/releases/luarocks-2.2.2.tar.gz) - [Windows](http://luarocks.org/releases/luarocks-2.2.2-win32.zip) +**Version 2.2.2** - 24/Apr/2015 - [All Unix](https://luarocks.github.io/luarocks/releases/luarocks-2.2.2.tar.gz) - [Windows](https://luarocks.github.io/luarocks/releases/luarocks-2.2.2-win32.zip) * `luarocks build --only-deps` and `luarocks install --only-deps` for installing dependencies only * Mercurial support @@ -269,13 +269,13 @@ * Improved Makefiles for handling simultaneous bootstrapped installations * Various bugfixes -**Version 2.2.1** - 17/Mar/2015 - [All Unix](http://luarocks.org/releases/luarocks-2.2.1.tar.gz) - [Windows](http://luarocks.org/releases/luarocks-2.2.1-win32.zip) +**Version 2.2.1** - 17/Mar/2015 - [All Unix](https://luarocks.github.io/luarocks/releases/luarocks-2.2.1.tar.gz) - [Windows](https://luarocks.github.io/luarocks/releases/luarocks-2.2.1-win32.zip) * Improved compatibility with Lua 5.3 * `luarocks list --outdated` for listing modules with available upgrades * Assorted bugfixes -**Version 2.2.0** - 15/Aug/2014 - [All Unix](http://luarocks.org/releases/luarocks-2.2.0.tar.gz) - [Windows](http://luarocks.org/releases/luarocks-2.2.0-win32.zip) +**Version 2.2.0** - 15/Aug/2014 - [All Unix](https://luarocks.github.io/luarocks/releases/luarocks-2.2.0.tar.gz) - [Windows](https://luarocks.github.io/luarocks/releases/luarocks-2.2.0-win32.zip) * MoonRocks is the new default repository: http://rocks.moonscript.org - Rocks don't need to be sent to the LuaRocks mailing list anymore, you can upload them directly at the website or using... * ...`luarocks upload` command for uploading rocks to MoonRocks via the command-line @@ -285,7 +285,7 @@ * various improvements in `luarocks doc` command * "git+http" transport for source.url -**Version 2.1.2** - 10/Jan/2014 - [All Unix](http://luarocks.org/releases/luarocks-2.1.2.tar.gz) - [Windows](http://luarocks.org/releases/luarocks-2.1.2-win32.zip) +**Version 2.1.2** - 10/Jan/2014 - [All Unix](https://luarocks.github.io/luarocks/releases/luarocks-2.1.2.tar.gz) - [Windows](https://luarocks.github.io/luarocks/releases/luarocks-2.1.2-win32.zip) * major improvements in the Windows install.bat script. Now installs by default on standard Windows locations, while the old self-contained all-under-one-dir installation is still supported through an option flag. The documentation at luarocks.org didn't catch up with it yet, so please refer to "install /?" for instructions. * a new command, "luarocks doc " that tries to find any installed documentation. Due to the lack of documentation standards for Lua, this uses a few heuristics. Feedback on the feature is appreciated. @@ -298,7 +298,7 @@ * Improved Lua detection in Unix installer * plus assorted bugfixes -**Version 2.1.1** - 29/Oct/2013 - [All Unix](http://luarocks.org/releases/luarocks-2.1.1.tar.gz) - [Windows](http://luarocks.org/releases/luarocks-2.1.1-win32.zip) +**Version 2.1.1** - 29/Oct/2013 - [All Unix](https://luarocks.github.io/luarocks/releases/luarocks-2.1.1.tar.gz) - [Windows](https://luarocks.github.io/luarocks/releases/luarocks-2.1.1-win32.zip) * Remote manifests are now compressed and locally cached, making commands faster * New command "write_rockspec" which generates rockspec file templates @@ -309,7 +309,7 @@ * Improved error checking * plus assorted bugfixes -**Version 2.1.0** - 09/Aug/2013 - [All Unix](http://luarocks.org/releases/luarocks-2.1.0.tar.gz) - [Windows](http://luarocks.org/releases/luarocks-2.1.0-win32.zip) +**Version 2.1.0** - 09/Aug/2013 - [All Unix](https://luarocks.github.io/luarocks/releases/luarocks-2.1.0.tar.gz) - [Windows](https://luarocks.github.io/luarocks/releases/luarocks-2.1.0-win32.zip) * accesses manifest-{5.1,5.2} in remote servers to provide properly filtered results for Lua 5.1 or 5.2 * Remove old versions when installing a new one and old versions are no longer needed to honor dependencies. @@ -322,7 +322,7 @@ * friendlier error messages * plus bugfixes -**Version 2.0.13** - 16/Apr/2013 - [All Unix](http://luarocks.org/releases/luarocks-2.0.13.tar.gz) - [Windows](http://luarocks.org/releases/luarocks-2.0.13-win32.zip) +**Version 2.0.13** - 16/Apr/2013 - [All Unix](https://luarocks.github.io/luarocks/releases/luarocks-2.0.13.tar.gz) - [Windows](https://luarocks.github.io/luarocks/releases/luarocks-2.0.13-win32.zip) * Support for Lua 5.2 is no longer marked as experimental * Support for installing two instances of LuaRocks, for Lua 5.1 and 5.2, in parallel @@ -332,7 +332,7 @@ * Improvements in 'luarocks new_version` command for autogenerating updated rockspecs * 'luarocks remove' command accepts rock and rockspec filenames -**Version 2.0.12** - 05/Nov/2012 - [All Unix](http://luarocks.org/releases/luarocks-2.0.12.tar.gz) - [Windows](http://luarocks.org/releases/luarocks-2.0.12-win32.zip) +**Version 2.0.12** - 05/Nov/2012 - [All Unix](https://luarocks.github.io/luarocks/releases/luarocks-2.0.12.tar.gz) - [Windows](https://luarocks.github.io/luarocks/releases/luarocks-2.0.12-win32.zip) * "Dependencies mode" selection to configure how to work with multiple local trees * New command "purge" that erases a local tree @@ -341,7 +341,7 @@ * Code cleanups, removal of dead code * Fixes regressions on Mac and Windows -**Version 2.0.11** - 21/Sep/2012 - [All Unix](http://luarocks.org/releases/luarocks-2.0.11.tar.gz) - [Windows](http://luarocks.org/releases/luarocks-2.0.11-win32.zip) +**Version 2.0.11** - 21/Sep/2012 - [All Unix](https://luarocks.github.io/luarocks/releases/luarocks-2.0.11.tar.gz) - [Windows](https://luarocks.github.io/luarocks/releases/luarocks-2.0.11-win32.zip) * Work around LuaSocket crash when given proxy URLs without the scheme part * Save manifest file in a single fs operation to make it more atomic @@ -358,7 +358,7 @@ * Fix builtin build mode on Mac OSX < 10.5 * Improve configure tests for Debian-based platforms -**Version 2.0.10** - 12/Jul/2012 - [All Unix](http://luarocks.org/releases/luarocks-2.0.10.tar.gz) - [Windows](http://luarocks.org/releases/luarocks-2.0.10-win32.zip) +**Version 2.0.10** - 12/Jul/2012 - [All Unix](https://luarocks.github.io/luarocks/releases/luarocks-2.0.10.tar.gz) - [Windows](https://luarocks.github.io/luarocks/releases/luarocks-2.0.10-win32.zip) * Fix fetching Git tags/branches * Fix strictness issue with parameter of io.open @@ -367,7 +367,7 @@ * Cleanup of .svn dir in svn-based rocks * Improvement for 'make bootstrap' -**Version 2.0.9** - 31/May/2012 - [All Unix](http://luarocks.org/releases/luarocks-2.0.9.tar.gz) - [Windows](http://luarocks.org/releases/luarocks-2.0.9-win32.zip) +**Version 2.0.9** - 31/May/2012 - [All Unix](https://luarocks.github.io/luarocks/releases/luarocks-2.0.9.tar.gz) - [Windows](https://luarocks.github.io/luarocks/releases/luarocks-2.0.9-win32.zip) * Experimental support for Lua 5.2 (auto-detection and explicit --lua-version flag in configure) * Solaris support and BSD fixes @@ -378,7 +378,7 @@ * Nicer-looking persisted tables * Assorted bugfixes -**Version 2.0.8** - 29/Feb/2012 - [All Unix](http://luarocks.org/releases/luarocks-2.0.8.tar.gz) - [Windows](http://luarocks.org/releases/luarocks-2.0.8-win32.zip) +**Version 2.0.8** - 29/Feb/2012 - [All Unix](https://luarocks.github.io/luarocks/releases/luarocks-2.0.8.tar.gz) - [Windows](https://luarocks.github.io/luarocks/releases/luarocks-2.0.8-win32.zip) * Fix in CMake build backend * Fix handling error condition of --pack-binary-rock @@ -392,13 +392,13 @@ * New binaries from GnuWin32 shipped in Win32 zip * Nicer-looking help -**Version 2.0.7.1** - 10/Jan/2012 - [All Unix](http://luarocks.org/releases/luarocks-2.0.7.1.tar.gz) - [Windows](http://luarocks.org/releases/luarocks-2.0.7.1-win32.zip) +**Version 2.0.7.1** - 10/Jan/2012 - [All Unix](https://luarocks.github.io/luarocks/releases/luarocks-2.0.7.1.tar.gz) - [Windows](https://luarocks.github.io/luarocks/releases/luarocks-2.0.7.1-win32.zip) * Fix installation of files in build operation * Deprecate --to and --from, use --server and --tree instead * Improved documentation, thanks to LDoc -**Version 2.0.7** - 10/Dec/2011 - [All Unix](http://luarocks.org/releases/luarocks-2.0.7.tar.gz) - [Windows](http://luarocks.org/releases/luarocks-2.0.7-win32.zip) +**Version 2.0.7** - 10/Dec/2011 - [All Unix](https://luarocks.github.io/luarocks/releases/luarocks-2.0.7.tar.gz) - [Windows](https://luarocks.github.io/luarocks/releases/luarocks-2.0.7-win32.zip) * Quieter git checkout * --only-sources flag to restrict download of sources from a single domain @@ -408,7 +408,7 @@ * More logical names for flags: --tree, --server * Improved documentation -**Version 2.0.6** - 04/Oct/2011 - [All Unix](http://luarocks.org/releases/luarocks-2.0.6.tar.gz) - [Windows](http://luarocks.org/releases/luarocks-2.0.6-win32.zip) +**Version 2.0.6** - 04/Oct/2011 - [All Unix](https://luarocks.github.io/luarocks/releases/luarocks-2.0.6.tar.gz) - [Windows](https://luarocks.github.io/luarocks/releases/luarocks-2.0.6-win32.zip) * Fixes for rockspecs missing 'description' or the contents of 'source.url' * Escape fixes for LuaJIT/Metalua @@ -418,7 +418,7 @@ * Flag for experimental extensions * Plus assorted bugfixes -**Version 2.0.5** - 17/Aug/2011 - [All Unix](http://luarocks.org/releases/luarocks-2.0.5.tar.gz) - [Windows](http://luarocks.org/releases/luarocks-2.0.5-win32.zip) +**Version 2.0.5** - 17/Aug/2011 - [All Unix](https://luarocks.github.io/luarocks/releases/luarocks-2.0.5.tar.gz) - [Windows](https://luarocks.github.io/luarocks/releases/luarocks-2.0.5-win32.zip) * External commands are overridable through variables or config.lua * No longer uses print() - output goes to stdout, errors to stderr @@ -426,11 +426,11 @@ * Avoid relying on the $PWD variable * Code cleanups -**Version 2.0.4.1** - 17/Jan/2011 - [All Unix](http://luarocks.org/releases/luarocks-2.0.4.1.tar.gz) - [Windows](http://luarocks.org/releases/luarocks-2.0.4.1-win32.zip) +**Version 2.0.4.1** - 17/Jan/2011 - [All Unix](https://luarocks.github.io/luarocks/releases/luarocks-2.0.4.1.tar.gz) - [Windows](https://luarocks.github.io/luarocks/releases/luarocks-2.0.4.1-win32.zip) * Minor bugfix release -**Version 2.0.4** - 23/Dec/2010 - [All Unix](http://luarocks.org/releases/luarocks-2.0.4.tar.gz) - [Windows](http://luarocks.org/releases/luarocks-2.0.4-win32.zip) +**Version 2.0.4** - 23/Dec/2010 - [All Unix](https://luarocks.github.io/luarocks/releases/luarocks-2.0.4.tar.gz) - [Windows](https://luarocks.github.io/luarocks/releases/luarocks-2.0.4-win32.zip) * Command "remove" for luarocks-admin * Check for write permissions in repository and suggest --local @@ -444,7 +444,7 @@ * Stable sort of persisted files such as manifests * Plus assorted bugfixes -**Version 2.0.3** - 14/Sep/2010 - [All Unix](http://luarocks.org/releases/luarocks-2.0.3.tar.gz) - [Windows](http://luarocks.org/releases/luarocks-2.0.3-win32.zip) +**Version 2.0.3** - 14/Sep/2010 - [All Unix](https://luarocks.github.io/luarocks/releases/luarocks-2.0.3.tar.gz) - [Windows](https://luarocks.github.io/luarocks/releases/luarocks-2.0.3-win32.zip) * Check for permissions and warn user instead of just installing in local tree * --local flag for operations on the local tree @@ -459,14 +459,14 @@ * new command: "luarocks path" to make it easy to export Lua env variables * plus assorted bugfixes -**Version 2.0.2** - 01/Apr/2010 - [All Unix](http://luarocks.org/releases/luarocks-2.0.2.tar.gz) - [Windows](http://luarocks.org/releases/luarocks-2.0.2-win32.zip) +**Version 2.0.2** - 01/Apr/2010 - [All Unix](https://luarocks.github.io/luarocks/releases/luarocks-2.0.2.tar.gz) - [Windows](https://luarocks.github.io/luarocks/releases/luarocks-2.0.2-win32.zip) * use LuaSocket if available for downloading files * use LuaZip if available for unzipping files * MinGW support in builtin build backend * updated installation files for Windows, including a LuaForWindows-compatible package -**Version 2.0.1** - 27/Oct/2009 - [All Unix](http://luarocks.org/releases/luarocks-2.0.1.tar.gz) - [Windows](http://luarocks.org/releases/luarocks-2.0.1-win32.zip) +**Version 2.0.1** - 27/Oct/2009 - [All Unix](https://luarocks.github.io/luarocks/releases/luarocks-2.0.1.tar.gz) - [Windows](https://luarocks.github.io/luarocks/releases/luarocks-2.0.1-win32.zip) * luarocks.cfg is no longer edited during installation; a separate site-local luarocks.config module is created. * robustness fixes and improvements for luarocks.add @@ -474,7 +474,7 @@ * install LuaRocks as a rock * plus assorted bugfixes -**Version 2.0** - 17/Oct/2009 - [All Unix](http://luarocks.org/releases/luarocks-2.0.tar.gz) - [Windows](http://luarocks.org/releases/luarocks-2.0-win32.zip) +**Version 2.0** - 17/Oct/2009 - [All Unix](https://luarocks.github.io/luarocks/releases/luarocks-2.0.tar.gz) - [Windows](https://luarocks.github.io/luarocks/releases/luarocks-2.0-win32.zip) * module files are now deployed to standard Lua-style paths * new package loader module luarocks.loader, superseding the require()-override module luarocks.require @@ -484,7 +484,7 @@ * new commands for luarocks-admin: "add", to upload rocks to a repository, and "refresh_cache", to refresh the cache used by the "add" command * plus a number of cleanups and bugfixes -**Version 1.0.1** - 13/Mar/2009 - [All Unix](http://luarocks.org/releases/luarocks-1.0.1.tar.gz) - [Windows](http://luarocks.org/releases/luarocks-1.0.1-win32.zip) +**Version 1.0.1** - 13/Mar/2009 - [All Unix](https://luarocks.github.io/luarocks/releases/luarocks-1.0.1.tar.gz) - [Windows](https://luarocks.github.io/luarocks/releases/luarocks-1.0.1-win32.zip) * Improve portability in usage of Unix tools * Allow use of local rocks servers in the --from flag @@ -492,7 +492,7 @@ * Fix build of the 'builtin' backend under Windows * Support for the 'md5' binary as a MD5 checker -**Version 1.0** - 01/Sep/2008 - [All Unix](http://luarocks.org/releases/luarocks-1.0.tar.gz) - [Windows](http://luarocks.org/releases/luarocks-1.0-win32.zip) +**Version 1.0** - 01/Sep/2008 - [All Unix](https://luarocks.github.io/luarocks/releases/luarocks-1.0.tar.gz) - [Windows](https://luarocks.github.io/luarocks/releases/luarocks-1.0-win32.zip) * Add support for post-install hooks * Path helper scripts for binaries on Windows systems. @@ -503,7 +503,7 @@ * Generate index.html when building a manifest for a repository. * Plus assorted bugfixes. -**Version 0.6** - 30/Jun/2008 - [All Unix](http://luarocks.org/releases/luarocks-0.6.tar.gz) - [Windows](http://luarocks.org/releases/luarocks-0.6-win32.zip) +**Version 0.6** - 30/Jun/2008 - [All Unix](https://luarocks.github.io/luarocks/releases/luarocks-0.6.tar.gz) - [Windows](https://luarocks.github.io/luarocks/releases/luarocks-0.6-win32.zip) * Check external deps on binary installs. Allow rockspecs to specify supported platforms. Support platform-agnostic specification of external deps files. Allow overriding external deps subdirs. * Structured build systems in subdirectories. @@ -515,21 +515,21 @@ * "module" build type renamed to "builtin"; "cvs_tag" and "cvs_module" renamed to "tag" and "module". Old names still supported for compatibility for now, to be cleaned up by 1.0. * Plus many bugfixes. -**Version 0.5.2** - 13/May/2008 - [All Unix](http://luarocks.org/releases/luarocks-0.5.2.tar.gz) - [Windows](http://luarocks.org/releases/luarocks-0.5.2-win32.zip) +**Version 0.5.2** - 13/May/2008 - [All Unix](https://luarocks.github.io/luarocks/releases/luarocks-0.5.2.tar.gz) - [Windows](https://luarocks.github.io/luarocks/releases/luarocks-0.5.2-win32.zip) * Fixes problems with removal of read-only files on Windows * Fixes issues with external libraries on the 'module' build type on Windows * Fixes the --only-from flag * Renames the luarocks.config module to luarocks.cfg avoiding conflict's with the user configuration file config.lua -**Version 0.5.1** - 25/Apr/2008 - [All Unix](http://luarocks.org/releases/luarocks-0.5.1.tar.gz) - [Windows](http://luarocks.org/releases/luarocks-0.5.1-win32.zip) +**Version 0.5.1** - 25/Apr/2008 - [All Unix](https://luarocks.github.io/luarocks/releases/luarocks-0.5.1.tar.gz) - [Windows](https://luarocks.github.io/luarocks/releases/luarocks-0.5.1-win32.zip) * Added function get_rock_from_module in luarocks.require, allowing apps to inspect which rock they're getting modules from. * Added variables LUA, LIB_EXTENSION and OBJ_EXTENSION, now available for rockspec authors. * Assorted bugfixes, especially for the Windows package. * Build system improvements: add DESTDIR variable to makefile to make things easier for distros packaging LuaRocks. -**Version 0.5** - 03/Apr/2008 - [All Unix](http://luarocks.org/releases/luarocks-0.5.tar.gz) - [Windows](http://luarocks.org/releases/luarocks-0.5-win32.zip) +**Version 0.5** - 03/Apr/2008 - [All Unix](https://luarocks.github.io/luarocks/releases/luarocks-0.5.tar.gz) - [Windows](https://luarocks.github.io/luarocks/releases/luarocks-0.5-win32.zip) * New flags in the ./configure on Unix (see configure --help) and install.bat on Windows (see install.bat /?) * Support for multiple local repositories. By extension, LuaRocks features more intuitive configuration defaults (it installs rocks to $PREFIX/lib/luarocks if you have the permission, and to $HOME/.luarocks if you don't). @@ -538,27 +538,27 @@ * 'unpack' command allows unpacking binary and pure-Lua rocks, for inspecting. * Plus assorted bugfixes. -**Version 0.4.3** - 03/Mar/2008 - [All Unix](http://luarocks.org/releases/luarocks-0.4.3.tar.gz) - [Windows](http://luarocks.org/releases/luarocks-0.4.3-win32.zip) +**Version 0.4.3** - 03/Mar/2008 - [All Unix](https://luarocks.github.io/luarocks/releases/luarocks-0.4.3.tar.gz) - [Windows](https://luarocks.github.io/luarocks/releases/luarocks-0.4.3-win32.zip) * The MD5 check feature added in 0.4.2 can now use openssl instead of md5sum (making LuaRocks friendlier to OSX). * Added a license file in the tarball (making LuaRocks friendlier to Debian). * Plus assorted bugfixes. -**Version 0.4.2** - 09/Feb/2008 - [All Unix](http://luarocks.org/releases/luarocks-0.4.2.tar.gz) - [Windows](http://luarocks.org/releases/luarocks-0.4.2-win32.zip) +**Version 0.4.2** - 09/Feb/2008 - [All Unix](https://luarocks.github.io/luarocks/releases/luarocks-0.4.2.tar.gz) - [Windows](https://luarocks.github.io/luarocks/releases/luarocks-0.4.2-win32.zip) * Support .lua files directly in the URL field. * Perform check of MD5 checksum in sources. * Accept plain strings in all fields of the source table of the "module" build type. * Bugfixes. -**Version 0.4.1** - 25/Jan/2008 - [All Unix](http://luarocks.org/releases/luarocks-0.4.1.tar.gz) - [Windows](http://luarocks.org/releases/luarocks-0.4.1-win32.zip) +**Version 0.4.1** - 25/Jan/2008 - [All Unix](https://luarocks.github.io/luarocks/releases/luarocks-0.4.1.tar.gz) - [Windows](https://luarocks.github.io/luarocks/releases/luarocks-0.4.1-win32.zip) * New configure/install.bat flags for setting scripts dir and local repository dir. * "unpack" command now supports rockspec files as well. * Complete code documentation. * Many assorted bugfixes. -**Version 0.4** - 18/Jan/2008 - [All Unix](http://luarocks.org/releases/luarocks-0.4.tar.gz) - [Windows](http://luarocks.org/releases/luarocks-0.4-win32.zip) +**Version 0.4** - 18/Jan/2008 - [All Unix](https://luarocks.github.io/luarocks/releases/luarocks-0.4.tar.gz) - [Windows](https://luarocks.github.io/luarocks/releases/luarocks-0.4-win32.zip) * Adds the "unpack" command for debugging rocks (.src.rock only at this point). * Support curl as an alternative downloader for OSX, removing the dependency on wget. @@ -569,29 +569,29 @@ * Performance improvements. * Many assorted bugfixes. -**Version 0.3.2** - 21/Dec/2007 - [All Unix](http://luarocks.org/releases/luarocks-0.3.2.tar.gz) - [Windows](http://luarocks.org/releases/luarocks-0.3.2-win32.zip) +**Version 0.3.2** - 21/Dec/2007 - [All Unix](https://luarocks.github.io/luarocks/releases/luarocks-0.3.2.tar.gz) - [Windows](https://luarocks.github.io/luarocks/releases/luarocks-0.3.2-win32.zip) * Support for patching and inclusion of extra files (such as Makefiles) through a rockspec. * Support "platforms" overrides table for dependencies, external dependencies and source URLs. * Many assorted bugfixes. -**Version 0.3.1** - 18/Dec/2007 - [All Unix](http://luarocks.org/releases/luarocks-0.3.1.tar.gz) - [Windows](http://luarocks.org/releases/luarocks-0.3.1-win32.zip) +**Version 0.3.1** - 18/Dec/2007 - [All Unix](https://luarocks.github.io/luarocks/releases/luarocks-0.3.1.tar.gz) - [Windows](https://luarocks.github.io/luarocks/releases/luarocks-0.3.1-win32.zip) * Improved search: results now feature separate lists for source and binary rocks. * Windows support for the "module" build type (using Visual Studio). * Many assorted bugfixes. -**Version 0.3** - 04/Dec/2007 - [All Unix](http://luarocks.org/releases/luarocks-0.3.tar.gz) - [Windows](http://luarocks.org/releases/luarocks-0.3-win32.zip) +**Version 0.3** - 04/Dec/2007 - [All Unix](https://luarocks.github.io/luarocks/releases/luarocks-0.3.tar.gz) - [Windows](https://luarocks.github.io/luarocks/releases/luarocks-0.3-win32.zip) * Includes Windows package. * Adds the "module" build type. * Performance improvements. -**Version 0.2** - 23/Oct/2007 - [All Unix](http://luarocks.org/releases/luarocks-0.2.tar.gz) +**Version 0.2** - 23/Oct/2007 - [All Unix](https://luarocks.github.io/luarocks/releases/luarocks-0.2.tar.gz) * Bugfixes and improvements to build infrastructure. * Adds the LuaRocks "remove" command. -**Version 0.1** - 09/Aug/2007 - [All Unix](http://luarocks.org/releases/luarocks-0.1.tar.gz) +**Version 0.1** - 09/Aug/2007 - [All Unix](https://luarocks.github.io/luarocks/releases/luarocks-0.1.tar.gz) * Initial release. diff --git a/docs/rock_file_format.md b/docs/rock_file_format.md index 10748bde..e3fcf3b7 100644 --- a/docs/rock_file_format.md +++ b/docs/rock_file_format.md @@ -34,8 +34,8 @@ Additionally, it must contain the sources: A binary rock must contain at its root two files. For a rock called `myrock-1.0-1.linux-x86.rock` they would be called: -* `myrock-1.0-1.rockspec` - the [rockspec file](Rockspec-format) in the archive root -* `rock_manifest` - a [rock manifest file](Rock-manifest-file-format) +* `myrock-1.0-1.rockspec` - the [rockspec file](rockspec_format.md) in the archive root +* `rock_manifest` - a [rock manifest file](rock_manifest_file_format.md) These standard directories are handled specially: diff --git a/docs/rockspec_format.md b/docs/rockspec_format.md index edb35632..9c663dbf 100644 --- a/docs/rockspec_format.md +++ b/docs/rockspec_format.md @@ -11,25 +11,25 @@ For number fields, strings are accepted and converted using tonumber(). * **description.summary** (string) - A one-line description of the package. Example: "Network support for the Lua language" * **description.detailed** (string) - A longer description of the package. Example: "LuaSocket is a Lua extension library that is composed by two parts: a C core that provides support for the TCP and UDP transport layers, and a set of Lua modules that add support for functionality commonly needed by applications that deal with the Internet." * **description.license** (string) - The license used by the package. A short name, such as "MIT" and "GPL-2" is preferred. Software using the same license as Lua 5.x should use "MIT". - * **description.homepage** (string) - An URL for the project. This is not the URL for the tarball, but the address of a website. Example: "http://github.com/keplerproject/rings" - * **description.issues_url** (string) (since 3.0) - An URL for the project's issue tracker. Example: "http://github.com/keplerproject/rings/issues" + * **description.homepage** (string) - An URL for the project. This is not the URL for the tarball, but the address of a website. Example: "https://github.com/keplerproject/rings" + * **description.issues_url** (string) (since 3.0) - An URL for the project's issue tracker. Example: "https://github.com/keplerproject/rings/issues" * **description.maintainer** (string) - Contact information for the _rockspec_ maintainer (which may or may not be the package maintainer -- contact for the package maintainer can usually be obtained through the address in the homepage field). Example: "John Doe <john@doe.gov>" - * **description.labels** (array of strings) (since 3.0) - A list of short strings that specify labels for categorization of this rock. See the list of labels at [http://luarocks.org] for inspiration. Example: { "crypto", "network", "tls", "https" } + * **description.labels** (array of strings) (since 3.0) - A list of short strings that specify labels for categorization of this rock. See the list of labels at [https://luarocks.org] for inspiration. Example: { "crypto", "network", "tls", "https" } ## Dependency information Dependencies are represented in LuaRocks through strings with a package name followed by a comma-separated list of constraints. Each constraint consists of an operator and a version number. In this string format, version numbers are represented as naturally as possible, like they are used by upstream projects (e.g. "2.0beta3"). Internally, LuaRocks converts them to a purely numeric representation, allowing comparison following some common sense heuristics. The precise specification of the comparison criteria is the source code of the luarocks.deps module, but the test/test_deps.lua file included with LuaRocks provides some insights on what these criteria are. * **supported_platforms** (array of strings) - If this array is not present, the rock is assumed to be portable to any platform. If present, this should contain strings containing LuaRocks platform identifiers, optionally preceded by a "!" to indicate a negative match. If only negative entries are listed, the rock is assumed to be portable to any platform except those listed. If any positive entry exists, then at least one entry must match positively to the currently running platform. Currently supported LuaRocks platform identifiers are: "unix", "windows", "win32", "cygwin", "macosx", "linux", "freebsd". Platforms may have more than one valid identifier; e.g. Linux defines both "unix" and "linux". Note that, as of 0.6, Cygwin under Windows defines {"unix", "cygwin"} but *not* "windows". -* **dependencies** (array of strings) - Each string represents a package this rock depends on, containing a package name followed by a comma-separated list of constraints. Example: `{"lfs >= 1.0, < 2.0"}`. Accepted operators are the relational operators of Lua: `==` `~=` `<` `>` `<=` `>=` , as well as a special operator, `~>`, inspired by the "pessimistic operator" of RubyGems (`"~> 2"` means `">= 2, < 3"`; `"~> 2.4"` means `">= 2.4, < 2.5"`). The absence of an operator means an implicit `==` (i.e., `"lfs 1.0"` is the same as `"lfs == 1.0"`). "lua" is an special dependency name; it matches not a rock, but the version of Lua in use. Supports [per-platform overrides](platform-overrides). -* **build_dependencies** (array of strings) (since 3.0) - Dependencies that apply at build-time only, but not when installing binary (`..rock`) or pure-Lua (`.all.rock`) rocks. Each string represents a package this rock depends on at build time, containing a package name followed by a comma-separated list of constraints. The syntax in the same as the `dependencies` field. Supports [per-platform overrides](platform-overrides). -* **external_dependencies** (table) - For each key in the external_dependencies table in the rockspec file, four variables available to the build rules are created: key_DIR, key_BINDIR, key_INCDIR and key_LIBDIR. These are not overwritten if already set (e.g. by the LuaRocks config file or through the command-line). The base prefix for these can be given explicitly setting key_DIR in the config file or through the command-line, or implicitly, defaulting to the value of default_external_deps_dir, set in the config file. Values in the external_dependencies table are tables that may contain a "header" or a "library" field, with filenames to be tested for existence. Example: `{ EXPAT = { header = "expat.h" } }` -- on Unix, this will check that EXPAT_DIR/include/expat.h exists and will create variables accordingly. You can also use platform overrides or specify files of external dependencies in a [platform-agnostic manner](platform-agnostic-external-dependencies). Supports [per-platform overrides](platform-overrides). -* **test_dependencies** (array of strings) (since 3.0) - Dependencies that apply at test-time only, that is, only needed when running `luarocks test`. Each string represents a package this rock depends on at test time, containing a package name followed by a comma-separated list of constraints. The syntax in the same as the `dependencies` field. Supports [per-platform overrides](platform-overrides). +* **dependencies** (array of strings) - Each string represents a package this rock depends on, containing a package name followed by a comma-separated list of constraints. Example: `{"lfs >= 1.0, < 2.0"}`. Accepted operators are the relational operators of Lua: `==` `~=` `<` `>` `<=` `>=` , as well as a special operator, `~>`, inspired by the "pessimistic operator" of RubyGems (`"~> 2"` means `">= 2, < 3"`; `"~> 2.4"` means `">= 2.4, < 2.5"`). The absence of an operator means an implicit `==` (i.e., `"lfs 1.0"` is the same as `"lfs == 1.0"`). "lua" is an special dependency name; it matches not a rock, but the version of Lua in use. Supports [per-platform overrides](platform_overrides.md). +* **build_dependencies** (array of strings) (since 3.0) - Dependencies that apply at build-time only, but not when installing binary (`..rock`) or pure-Lua (`.all.rock`) rocks. Each string represents a package this rock depends on at build time, containing a package name followed by a comma-separated list of constraints. The syntax in the same as the `dependencies` field. Supports [per-platform overrides](platform_overrides.md). +* **external_dependencies** (table) - For each key in the external_dependencies table in the rockspec file, four variables available to the build rules are created: key_DIR, key_BINDIR, key_INCDIR and key_LIBDIR. These are not overwritten if already set (e.g. by the LuaRocks config file or through the command-line). The base prefix for these can be given explicitly setting key_DIR in the config file or through the command-line, or implicitly, defaulting to the value of default_external_deps_dir, set in the config file. Values in the external_dependencies table are tables that may contain a "header" or a "library" field, with filenames to be tested for existence. Example: `{ EXPAT = { header = "expat.h" } }` -- on Unix, this will check that EXPAT_DIR/include/expat.h exists and will create variables accordingly. You can also use platform overrides or specify files of external dependencies in a [platform-agnostic manner](platform_agnostic_external_dependencies.md). Supports [per-platform overrides](platform_overrides.md). +* **test_dependencies** (array of strings) (since 3.0) - Dependencies that apply at test-time only, that is, only needed when running `luarocks test`. Each string represents a package this rock depends on at test time, containing a package name followed by a comma-separated list of constraints. The syntax in the same as the `dependencies` field. Supports [per-platform overrides](platform_overrides.md). ## Build rules -* **source** (table, mandatory field) - Contains information on how to fetch sources to build this rock. Supports [per-platform overrides](platform-overrides). - * **source.url** (string, mandatory field) - the URL of the package source archive. Examples: "http://github.com/downloads/keplerproject/wsapi/wsapi-1.3.4.tar.gz", "git://github.com/keplerproject/wsapi.git". Note that this field is ignored when running [luarocks make](luarocks_make.md), which uses the sources from your current directory instead. Different protocols are supported: +* **source** (table, mandatory field) - Contains information on how to fetch sources to build this rock. Supports [per-platform overrides](platform_overrides.md). + * **source.url** (string, mandatory field) - the URL of the package source archive. Examples: "https://github.com/downloads/keplerproject/wsapi/wsapi-1.3.4.tar.gz", "git://github.com/keplerproject/wsapi.git". Note that this field is ignored when running [luarocks make](luarocks_make.md), which uses the sources from your current directory instead. Different protocols are supported: * `cvs://` - for the CVS source control manager * `file://` - for URLs in the local filesystem (note that for Unix paths, the root slash is the third slash, resulting in paths like `"file:///full/path/filename"` * `ftp://` - for FTP URLs @@ -53,7 +53,7 @@ Dependencies are represented in LuaRocks through strings with a package name fol * **source.tag** (string) - for SCM-based URL protocols such as "cvs://" and "git://", this field can be used to specify a tag for checking out sources. Example: "HEAD" (For compatibility reasons, `source.cvs_tag` is also accepted.) * **source.branch** (string) - for SCM-based URL protocols such as "git://", this field can be used to specify a branch for checking out sources. Example: "v1.0" * **source.module** (string) - for SCM-based URL protocols such as "cvs://" and "git://", this field can be used to specify the module to be checked out. Can be omitted if it is the same as the basename of the `source.url` field. Example: "cgilua" (For compatibility reasons, `source.cvs_module` is also accepted.) -* **build** (table) - Contains all information pertaining _how_ to build a rock. Supports [per-platform overrides](platform-overrides). +* **build** (table) - Contains all information pertaining _how_ to build a rock. Supports [per-platform overrides](platform_overrides.md). * **build.type** (string) - The LuaRocks build back-end to use. Example: "make" * **build.install** (table) - For packages which don't provide means to install modules and expect the user to copy the .lua or library files by hand to the proper locations. This table contains categories of files. Each category is itself a table, where the array part is a list of filenames to be copied. For module directories only, in the hash part, other keys are identifiers in Lua module format, to indicate which subdirectory the file should be copied to. For example, `build.install.lua = {["foo.bar"] = "src/bar.lua"}` will copy src/bar.lua to the foo directory under the rock's Lua files directory. The available categories are: * **build.install.lua** (table) - Lua modules written in Lua. @@ -110,7 +110,7 @@ Variables expected by this back-end to be provided by the configuration file are * **LIBFLAG** - Flag to be passed to the C compiler to instruct it to build a shared library. These are usually detected by the default configuration, but can be overridden -by the [configuration file](config-file-format). See also the "Variables" +by the [configuration file](config_file_format.md). See also the "Variables" section of the [Config file format](config_file_format.md) specification for other path variables that are defined automatically, and the documentation on the `external_dependencies` entry above for variables that are automatically @@ -142,7 +142,7 @@ A null build back-end. Indicates that there is no build to perform. ## Test rules -* **test** (table) - Contains all information pertaining how to test a rock. Supports [per-platform overrides](platform-overrides). +* **test** (table) - Contains all information pertaining how to test a rock. Supports [per-platform overrides](platform_overrides.md). ### Test back-ends diff --git a/docs/welcome.md b/docs/welcome.md index 300f740e..9ac3ebe5 100644 --- a/docs/welcome.md +++ b/docs/welcome.md @@ -1,4 +1,4 @@ -

+

This is **LuaRocks**, the package manager for the Lua programming language. -- cgit v1.2.3-55-g6feb