docs: update changelog for LuaRocks 3.12.0

4 files changed, 631 insertions, 610 deletions

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 4af612e9..a8c46ec3 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,43 @@
+## LuaRocks 3.12.0
+
+> Released 05/Jun/2025
+
+LuaRocks 3.12.0 marks the transition of the implementation of the tool from
+Lua to Teal! This was implemented by Victor Ilchev as his Google Summer of
+Code project.
+
+### What's new
+
+* Transition entire implementation from Lua to Teal!
+* `luarocks upload`: include .src.rock file when given.
+* Various Windows fixes:
+  * Prioritize `bin` over `lib` for `LUA_LIBDIR` on Windows.
+  * `luarocks upload`: Accept Windows-style paths when sending
+    multipart data. (#1687)
+  * Update pe-parser to 0.6.
+  * Fix `LUA_LIBDIR` for MSVC installations. (#1744)
+  * Fixed make check for msys2 mingw system. (#1745)
+  * Override default C compiler to `cc.exe` on MSYS2 (#1754)
+  * Allow Lua C modules to be uninstalled on MSYS2. (#1756)
+  * Cygwin fixes for `external_deps_patterns` and
+    `runtime_external_deps_patterns`. (#1782)
+* Only create binary wrapper for Lua scripts. (#1738)
+* Project dir initialized via `luarocks init` has higher
+  precedence than `local_by_default` configuration. (#1682)
+* add `LUA_VERSION` build variable for rockspecs.
+* Rockspec format addition, feature-gated with
+  `rockspec_format = "3.1`:
+  * add build variables for rockspecs with the directories
+    of its dependencies: `<DEPENDENCY_NAME>_ROCKDIR`.
+* Avoid overwriting CMake variables from rockspec.
+* Allow loading JSON-formatted manifest, to circumvent
+  a LuaJIT bug when loading Lua files.
+* Various other minor fixes.
+
 ## What's new in LuaRocks 3.11.1
 
+> Released 31/May/2024
+
 * Fixes:
   * normalize namespace names to lowercase when performing
     dependency resolution, to match CLI behavior
@@ -10,8 +48,11 @@
   * Fix behavior of luarocks.lock file when dealing
     with dependencies
 
+
 ## What's new in LuaRocks 3.11.0
 
+> Released 13/Mar/2024
+
 * Features:
   * `luarocks build` and `luarocks install` no longer rebuild
     or reinstall if the version is already installed
@@ -45,8 +86,11 @@
     * install.bat sets LUALIB.
     * Improved help for `luarocks path`.
 
+
 ## What's new in LuaRocks 3.10.0
 
+> Released 27/Feb/2024
+
 * Features:
   * Introduce file-based locking for concurrent access
     control. Previously, LuaRocks would produce undefined behavior
@@ -117,8 +161,11 @@
   * Don't use floats to parse Lua version number.
   * Various fixes related to path normalization.
 
+
 ## What's new in LuaRocks 3.9.2
 
+> Released 08/Dec/2022
+
 * Configuration now honors typical compiler environment variables
   for all build backends:
   * `MAKE`, `CC`, `AR`, `RANLIB` on Unix
@@ -137,8 +184,11 @@
   * `persist.save_from_table`: ensure directory exists when
     saving a file
 
+
 ## What's new in LuaRocks 3.9.1
 
+> Released 01/Jul/2022
+
 * Fixed error message when Lua library is not found
 * Fixed build of Windows binary
 * A couple of minor feature additions:
@@ -153,6 +203,8 @@
 
 ## What's new in LuaRocks 3.9.0
 
+> Released 17/Apr/2022
+
 * `builtin` build mode now always respects CC, CFLAGS and LDFLAGS
 * Check that lua.h version matches the desired Lua version
 * Check that the version of the Lua C library matches the desired Lua version
@@ -170,8 +222,11 @@
 * LuaRocks test suite now runs on Lua 5.4 and LuaJIT
 * Internal dependencies of standalone LuaRocks executable were bumped
 
+
 ## What's new in LuaRocks 3.8.0
 
+> Released 08/Nov/2021
+
 * Support GitHub's protocol security changes transparently.
   * The raw git:// protocol will stop working on GitHub. LuaRocks already
     supports git+https:// as an alternative, but to avoid having to update
@@ -192,8 +247,11 @@
   * Revert the use of `Everyone` back to `*S-1-1-0`
   * Quote the use of the `%USERNAME%` variable to support names with spaces
 
+
 ## What's new in LuaRocks 3.7.0
 
+> Released 13/Apr/2021
+
 * Improved connectivity resiliency
   * LuaRocks can now use mirrors for downloading rocks even if downloading
     the manifest from the main server succeeds.
@@ -219,8 +277,11 @@
 * Fixes an issue on Windows where it would incorrectly revoke permissions
   from the current user when installing
 
+
 ## What's new in LuaRocks 3.6.0
 
+> Released 30/Mar/2021
+
 * Adds a double-check step to verify that all files from a rock are installed
 * Improve resilience of the manifest reader to deal with manifests
   written with older versions of LuaRocks lower than 3.0
@@ -245,8 +306,11 @@
 * Luacheck now runs on the LuaRocks CI
 * Distributed binaries are built using Lua 5.3
 
+
 ## What's new in LuaRocks 3.5.0
 
+> Released 10/Dec/2020
+
 This is a small release:
 
 * Added support for MSYS2 and Mingw-w64
@@ -254,9 +318,10 @@ This is a small release:
 * Fixes a bug where `--verbose` raised an exception with a nil argument
 * Added proper error messages when lua.h is invalid
 
-
 ## What's new in LuaRocks 3.4.0
 
+> Released 25/Sep/2020
+
 ### Features
 
 * `luarocks make` now supports `--only-deps`
@@ -301,6 +366,8 @@ This is a small release:
 
 ## What's new in LuaRocks 3.3.1
 
+> Released 07/Feb/2020
+
 This is a bugfix release:
 
 * Fix downgrades of rocks containing directories: stop it
@@ -310,6 +377,8 @@ This is a bugfix release:
 
 ## What's new in LuaRocks 3.3.0
 
+> Released 28/Jan/2020
+
 ### Features
 
 * **Dependency pinning**
@@ -362,8 +431,11 @@ This is a bugfix release:
 * Windows: fix generation of temporary filenames (#1058)
 * Windows: force `.lib` over `.dll` extension when resolving `LUALIB`
 
+
 ## What's new in LuaRocks 3.2.1
 
+> Released 05/Sep/2019
+
 * fix installation of LuaRocks via rockspec (`make bootstrap` and
 `luarocks install`): correct a problem in the initialization of the
 luarocks.fs module and its interaction with the cfg module.
@@ -374,8 +446,11 @@ luarocks.fs module and its interaction with the cfg module.
 luarocks.cmd.external modules
 * correct override of config values via CLI flags
 
+
 ## What's new in LuaRocks 3.2.0
 
+> Released 28/Aug/2019
+
 LuaRocks 3.2.0 now uses argument parsing based on argparse
 instead of a homegrown parser. This was implemented by Paul
 Ouellette as his Google Summer of Code project, mentored by
@@ -399,23 +474,35 @@ package.cpath as well
 * install.bat: Improved detection for Visual Studio 2017 and higher
 * Bundled LuaSec in all-in-one binary bumped to version 0.8.1
 
+
 ## What's new in LuaRocks 3.1.3
 
+> Released 06/Jun/2019
+
 This is another bugfix release, that incldes a couple of fixes,
 including better Lua detection, and fixes specific to MacOS and
 FreeBSD.
 
+
 ## What's new in LuaRocks 3.1.2
 
+> Released 07/May/2019
+
 This is again a small fix release.
 
+
 ## What's new in LuaRocks 3.1.1
 
+> Released 06/May/2019
+
 This is a hotfix release fixing an issue that affected initialization
 in some scenarios.
 
+
 ## What's new in LuaRocks 3.1.0
 
+> Released 30/Apr/2019
+
 ### More powerful `luarocks config`
 
 The `luarocks config` command used to only list the current
@@ -473,19 +560,28 @@ longer complains with a warning message if the home cache cannot be
 created (it just uses a temporary dir instead). And of course, the
 release includes multiple bugfixes.
 
+
 ## What's new in LuaRocks 3.0.4
 
+> Released 30/Oct/2018
+
 * Fork-free platform detection at startup
 * Improved detection of the default rockspec in commands such as `luarocks test`
 * Various minor bugfixes
 
+
 ## What's new in LuaRocks 3.0.3
 
+> Released 15/Sep/2018
+
 LuaRocks 3.0.3 is a minor bugfix release, fixing a regression in
 luarocks.loader introduced in 3.0.2.
 
+
 ## What's new in LuaRocks 3.0.2
 
+> Released 07/Sep/2018
+
 * Improvements in luarocks init, new --reset flag
 * write_rockspec: --lua-version renamed to --lua-versions
 * Improved behavior in module autodetection
@@ -498,6 +594,8 @@ characters (should fix the libstdc++ issue when installing xml)
 
 ## What's new in LuaRocks 3.0.1
 
+> Released 14/Aug/2018
+
 * Numerous bugfixes including:
    * Handle missing global `arg`
    * Fix umask behavior
@@ -519,8 +617,11 @@ for that project
 support and an uninstall rule
 * Autodetect FreeBSD-style include paths (/usr/include/lua5x/)
 
+
 ## What's new in LuaRocks 3.0.0
 
+> Released 25/Jul/2018
+
 - [New rockspec format](#new-rockspec-format)
 - [New commands](#new-commands), including [luarocks init](https://github.com/luarocks/luarocks/wiki/Project:-LuaRocks-per-project-workflow) for per-project workflows
 - [New flags](#new-flags), including `--lua-dir` and `--lua-version` for using multiple Lua installs with a single LuaRocks
@@ -704,3 +805,526 @@ overhauled, making use of LuaRocks 3 features to greatly simplify them:
 * New internal objects for representing interaction with the repostories:
   `luarocks.queries` and `luarocks.results`
 * Type checking rules of file formats were moved into the `luarocks.type` namespace.
+
+
+
+## LuaRocks 2.4.4
+
+> Released 12/Mar/2018
+
+* 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
+* Updated Windows installer to better handle gcc toolchains
+* Fix detection of directories on Windows
+* Fixes .def generation on Windows
+
+
+## LuaRocks 2.4.3
+
+> Released 12/Sep/2017
+
+* Fixed display of pathnames in `luarocks show`
+* Improved check for write permissions when installing
+* Plus assorted bugfixes and improvements
+
+
+## LuaRocks 2.4.2
+
+> Released 30/Nov/2016
+
+* Fixed conflict resolution on deploy/delete
+* Improved dependency check messages
+* Performance improvements when removing packages
+* Support user-defined `platforms` array in config file
+* Improvements in Lua interpreter version detection in Unix configure script
+* Relaxed Lua version detection to improve support for alternative implementations (e.g. Ravi)
+* Plus assorted bugfixes and improvements
+
+
+## LuaRocks 2.4.1
+
+> Released 06/Oct/2016
+
+* Avoid coroutine use in luarocks.loader
+* Fix upgrade issues for very old versions
+
+
+## LuaRocks 2.4.0
+
+> Released 08/Sep/2016
+
+* New test suite based on Busted; runs on Linux, OSX and Windows
+* git+ssh:// fetch protocol
+* Improved behavior preserving permissions
+* Improved listing of dependencies on installation
+* Improved behavior of argument handling in `pack`
+* MSYS and Haiku platform detection
+* Feature-based detection of internal bit32 and utf8 modules
+* Internal reorganization of luarocks.fs code
+* `remove` option --force=fast renamed to --force-fast
+* Plus assorted bugfixes and cleanups
+
+
+## LuaRocks 2.3.0
+
+> Released 09/Jan/2016
+
+* Windows: major redesign of the install tree structure
+* Windows: Auto setup of MSVC environments
+* Improve error messages when tools are not installed
+* CMake: generate 64-bit builds when appropriate
+* Improve check of location of config files
+* MacOSX: set MACOSX_DEPLOYMENT_TARGET using env
+* Remove --extensions flag; use rockspec_format instead
+* New `luarocks config` command to query configuration
+* Improved UI for messages when external deps are missing
+* Unix: Robustness improvement in configure script
+* Plus tweaks and bugfixes. See the changelog for details.
+
+
+## LuaRocks 2.2.2
+
+> Released 24/Apr/2015
+
+* `luarocks build --only-deps` and `luarocks install --only-deps` for installing dependencies only
+* Mercurial support
+* Improved command-line argument parser, now validates arguments (it previously ignored unrecognized arguments) and accepts both `--flag=option` and `--flag option` in flags that take arguments.
+* For consistency with `luarocks show`, `luarocks doc --homepage` is now `luarocks doc --home`
+* Improvements to CMake build backend
+* Improved Makefiles for handling simultaneous bootstrapped installations
+* Various bugfixes
+
+
+## LuaRocks 2.2.1
+
+> Released 17/Mar/2015
+
+* Improved compatibility with Lua 5.3
+* `luarocks list --outdated` for listing modules with available upgrades
+* Assorted bugfixes
+
+
+## LuaRocks 2.2.0
+
+> Released 15/Aug/2014
+
+* 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
+* Preliminary support for Lua 5.3
+* No longer uses the module() function, for Lua 5.2 installations built without Lua 5.1 compatibility
+* --branch flag for `luarocks build` and `luarocks make`
+* various improvements in `luarocks doc` command
+* "git+http" transport for source.url
+
+
+## LuaRocks 2.1.2
+
+> Released 10/Jan/2014
+
+* 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 <module>" 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.
+* a rocks_provided configuration entry in which you can preload dependencies that are already fulfulled in your system; a few defaults are included (bit32 is auto-provided in Lua 5.2; luabitop is auto-provided in LuaJIT)
+* generated script wrappers are now more robust
+* Graceful handling of permission errors on Windows
+* Minor performance improvements
+* Support for "named trees", so you can label your rocks trees and use flags such as --tree=system  or --tree=user instead of the full path
+* "luarocks" with no arguments presents more useful diagnostics
+* Improved Lua detection in Unix installer
+* plus assorted bugfixes
+
+
+## LuaRocks 2.1.1
+
+> Released 29/Oct/2013
+
+* Remote manifests are now compressed and locally cached, making commands faster
+* New command "write_rockspec" which generates rockspec file templates
+* detection of multiarch directories on Linux
+* environment and performance improvements on Windows
+* New --force=fast option for `luarocks remove`
+* New --local-tree flag for `luarocks-admin make-manifest`
+* Improved error checking
+* plus assorted bugfixes
+
+
+## LuaRocks 2.1.0
+
+> Released 09/Aug/2013
+
+* 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.
+* `make bootstrap` is now an advertised option for installing LuaRocks itself as a rock on Unix systems
+* `luarocks purge --old-versions` for cleaning up a local tree
+* --keep flag to produce the old behavior of keeping old versions around (can be made permanent setting keep_old_versions=true in the config file)
+* security config options `accepted_build_types` and `hooks_enabled`
+* `lua_version` is now available as a global for your config.lua
+* new flags --lr-path, --lr-cpath, --lr-bin for `luarocks path` for use in scripts
+* friendlier error messages
+* plus bugfixes
+
+
+## LuaRocks 2.0.13
+
+> Released 16/Apr/2013
+
+* 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
+* Improvements for the `builtin` build mode on Windows
+* rclauncher on Windows does not rely on a precompiled object anymore
+* Improvements for the Windows installer, including optional registry entries for context-menu operations
+* Improvements in `luarocks new_version` command for autogenerating updated rockspecs
+* `luarocks remove` command accepts rock and rockspec filenames
+
+
+## LuaRocks 2.0.12
+
+> Released 05/Nov/2012
+
+* "Dependencies mode" selection to configure how to work with multiple local trees
+* New command "purge" that erases a local tree
+* --porcelain flag for "list" and "search"
+* More consistent user-agent reporting
+* Code cleanups, removal of dead code
+* Fixes regressions on Mac and Windows
+
+
+## LuaRocks 2.0.11
+
+> Released 21/Sep/2012
+
+* 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
+* Fix tree loading order on luarocks.loader with multiple trees
+* Fix detection of write permissions
+* Improve dependency detection using configurable patterns, now a file like "libfoo.so.1" satisfies "libfoo.so"
+* --bin flag for "luarocks path" command, exports $PATH
+* Support for mirrors in the rocks_servers list, default list of mirrors included
+* Avoid using Lua modules internally on Windows, to avoid file system locking
+* Add NetBSD support
+* Rename luarocks.rep to luarocks.repos
+* Fail gracefully on the absence of cmake, on cmake build mode
+* New command "lint", to check the syntax of a rockspec
+* Fix builtin build mode on Mac OSX < 10.5
+* Improve configure tests for Debian-based platforms
+
+
+## LuaRocks 2.0.10
+
+> Released 12/Jul/2012
+
+* Fix fetching Git tags/branches
+* Fix strictness issue with parameter of io.open
+* Builtin mode sets rpath when compiling on Unix
+* Use full path in $(LUA) when configured with --with-lua
+* Cleanup of .svn dir in svn-based rocks
+* Improvement for `make bootstrap`
+
+
+## LuaRocks 2.0.9
+
+> Released 31/May/2012
+
+* Experimental support for Lua 5.2 (auto-detection and explicit --lua-version flag in configure)
+* Solaris support and BSD fixes
+* --nodeps flag for forced installation without dependencies
+* "new_version" command to streamline writing of updated rockspecs
+* Improved handling of LUAROCKS_SYSCONFIG variable
+* Clickable URLs in descriptions in rocks repo index.html
+* Nicer-looking persisted tables
+* Assorted bugfixes
+
+
+## LuaRocks 2.0.8
+
+> Released 29/Feb/2012
+
+* Fix in CMake build backend
+* Fix handling error condition of --pack-binary-rock
+* Fixes for Windows .bat installer
+* Improved arch detection when packing binary rocks
+* Workaround LuaPosix 5.1.15 problem with chmod()
+* Proper error messages when config files are invalid
+* Avoid checking permissions when it's not necessary
+* Fix behavior of `builtin` rocks which install init.lua scripts
+* git+file:// pseudoprotocol for local Git repos
+* New binaries from GnuWin32 shipped in Win32 zip
+* Nicer-looking help
+
+
+## LuaRocks 2.0.7.1
+
+> Released 10/Jan/2012
+
+* Fix installation of files in build operation
+* Deprecate --to and --from, use --server and --tree instead
+* Improved documentation, thanks to LDoc
+
+
+## LuaRocks 2.0.7
+
+> Released 10/Dec/2011
+
+* Quieter git checkout
+* --only-sources flag to restrict download of sources from a single domain
+* Copy entries to bin/ with proper permissions
+* Fix --pack-binary-rock and add support for it in "luarocks make" as well
+* Isolate references to "5.1" to luarocks.cfg module
+* More logical names for flags: --tree, --server
+* Improved documentation
+
+
+## LuaRocks 2.0.6
+
+> Released 04/Oct/2011
+
+* Fixes for rockspecs missing `description` or the contents of `source.url`
+* Escape fixes for LuaJIT/Metalua
+* Support for building a rock without installing it
+* Site-local configuration is now at luarocks.site_config
+* Support for Mercurial
+* Flag for experimental extensions
+* Plus assorted bugfixes
+
+
+## LuaRocks 2.0.5
+
+> Released 17/Aug/2011
+
+* External commands are overridable through variables or config.lua
+* No longer uses print() - output goes to stdout, errors to stderr
+* Handle redirects between http (LuaSocket) and https (LuaSec)
+* Avoid relying on the $PWD variable
+* Code cleanups
+
+
+## LuaRocks 2.0.4.1
+
+> Released 17/Jan/2011
+
+* Minor bugfix release
+
+
+## LuaRocks 2.0.4
+
+> Released 23/Dec/2010
+
+* Command "remove" for luarocks-admin
+* Check for write permissions in repository and suggest --local
+* Remove .git from source tree when downloading from Git
+* Display of external dependencies in index.html
+* OpenBSD support
+* More thorough search for external libraries
+* Normalize paths to fix behavior when LFS is used under Windows
+* Add HTTPS support using LuaSec when using LuaSocket, for consistency
+* Better propagation of error messages
+* Stable sort of persisted files such as manifests
+* Plus assorted bugfixes
+
+
+## LuaRocks 2.0.3
+
+> Released 14/Sep/2010
+
+* Check for permissions and warn user instead of just installing in local tree
+* --local flag for operations on the local tree
+* -fPIC is always set in CFLAGS exported to makefiles
+* respect permissions when copying files in Unix systems
+* display license after build/installation
+* svn:// protocol for scm rockspecs
+* "luarocks list" and "luarocks search" are now case-insensitive
+* "luarocks-admin add" supports adding multiple files at once
+* "luarocks-admin add" supports rsync for download and upload and scp for upload
+* new command: "luarocks show" displays information about an installed rock
+* new command: "luarocks path" to make it easy to export Lua env variables
+* plus assorted bugfixes
+
+
+## LuaRocks 2.0.2
+
+> Released 01/Apr/2010
+
+* 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
+
+
+## LuaRocks 2.0.1
+
+> Released 27/Oct/2009
+
+* luarocks.cfg is no longer edited during installation; a separate site-local luarocks.config module is created.
+* robustness fixes and improvements for luarocks.add
+* cleanup of configure options and references to the old LuaForge URLs
+* install LuaRocks as a rock
+* plus assorted bugfixes
+
+
+## LuaRocks 2.0
+
+> Released 17/Oct/2009
+
+* module files are now deployed to standard Lua-style paths
+* new package loader module luarocks.loader, superseding the require()-override module luarocks.require
+* new abstraction system for file system operations: the OS-specific back-ends for luarocks.fs were split between native-Lua and tool-based implementations
+* new format for local manifest
+* new command for luarocks: "download", to fetch .rock and .rockspec files
+* 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
+
+
+## LuaRocks 1.0.1
+
+> Released 13/Mar/2009
+
+* Improve portability in usage of Unix tools
+* Allow use of local rocks servers in the --from flag
+* Improve detection of external libraries on Mac OSX
+* Fix build of the `builtin` backend under Windows
+* Support for the `md5` binary as a MD5 checker
+
+
+## LuaRocks 1.0
+
+> Released 01/Sep/2008
+
+* Add support for post-install hooks
+* Path helper scripts for binaries on Windows systems.
+* Git support, contributed by Thomas Harning.
+* Improve shell compatibility for different Unix systems.
+* Add the @ operator for no-upgrade dependencies.
+* Add check for rockspec version format.
+* Generate index.html when building a manifest for a repository.
+* Plus assorted bugfixes.
+
+
+## LuaRocks 0.6
+
+> Released 30/Jun/2008
+
+* 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.
+* Smarter check to decide if a rock is pure Lua or not, also checking bin/
+* Restructuring of fs code.
+* Modularized fetch code to support multiple SCMs.
+* Added specific support for `doc` directory in rockspecs. Auto-install files in `lua` in builtin builds.
+* Support for Surround SCM, contributed by Ignacio Burgueño.
+* "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.
+
+
+## LuaRocks 0.5.2
+
+> Released 13/May/2008
+
+* 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
+
+
+## LuaRocks 0.5.1
+
+> Released 25/Apr/2008
+
+* 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.
+
+
+## LuaRocks 0.5
+
+> Released 03/Apr/2008
+
+* 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).
+* Flags --from=_server_, --only-from=_server_ and --to=_tree_, to allow specifying exactly where to get rocks from and where to install them to.
+* The manifest file now stores dependency info -- luarocks.require no longer scans rockspec files.
+* `unpack` command allows unpacking binary and pure-Lua rocks, for inspecting.
+* Plus assorted bugfixes.
+
+
+## LuaRocks 0.4.3
+
+> Released 03/Mar/2008
+
+* 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.
+
+
+## LuaRocks 0.4.2
+
+> Released 09/Feb/2008
+
+* 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.
+
+
+## LuaRocks 0.4.1
+
+> Released 25/Jan/2008
+
+* 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.
+
+
+## LuaRocks 0.4
+
+> Released 18/Jan/2008
+
+* 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.
+* Support for installing non-Lua entries in bin/ dirs.
+* Support for specifying libdirs, incdirs, libraries and defines in "module"-type builds.
+* x86_64 support, by Brian Hetro.
+* FreeBSD support, by Matthew M. Burke.
+* Performance improvements.
+* Many assorted bugfixes.
+
+
+## LuaRocks 0.3.2
+
+> Released 21/Dec/2007
+
+* 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.
+
+
+## LuaRocks 0.3.1
+
+> Released 18/Dec/2007
+
+* 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.
+
+
+## LuaRocks 0.3
+
+> Released 04/Dec/2007
+
+* Includes Windows package.
+* Adds the "module" build type.
+* Performance improvements.
+
+
+## LuaRocks 0.2
+
+> Released 23/Oct/2007
+
+* Bugfixes and improvements to build infrastructure.
+* Adds the LuaRocks "remove" command.
+
+
+## LuaRocks 0.1
+
+> Released 09/Aug/2007
+
+* Initial release.
diff --git a/docs/download.md b/docs/download.md
index 9413ed10..b580ff8a 100644
--- a/docs/download.md
+++ b/docs/download.md
@@ -1,17 +1,11 @@
 # Download
 
-# Downloading 
+# Downloading
 
-Latest release: **LuaRocks 3.11.1** - '31/May/2024'
+* [Releases](https://luarocks.github.io/luarocks/releases/)
+* [Changelog](../CHANGELOG.md)
 
-* [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/)
-
-For release notes and older versions, see the [release history](release_history.md).
-
-# Installing 
+# Installing
 
 * [Installation instructions for Unix](installation_instructions_for_unix.md) (Linux, BSDs, etc.)
 * [Installation instructions for macOS](installation_instructions_for_macos.md)
@@ -25,7 +19,7 @@ package already includes them and a binary of Lua, as a convenience.
 Once LuaRocks is installed, make sure to read the
 [Documentation](index.md) for more information!
 
-# The bleeding edge 
+# The bleeding edge
 
 Development is done using Git. To get the latest development sources, run:
 
diff --git a/docs/index.md b/docs/index.md
index 075593e7..f4d60b49 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -76,7 +76,7 @@
       * [luarocks-admin refresh cache](luarocks_admin_refresh_cache.md)
       * [luarocks-admin remove](luarocks_admin_remove.md)
 
-  * [Release history](release_history.md)
+  * [Release history](../CHANGELOG.md)
 
 * [Credits](credits.md)
 * [License](license.md)
diff --git a/docs/release_history.md b/docs/release_history.md
deleted file mode 100644
index 52c61893..00000000
--- a/docs/release_history.md
+++ /dev/null
@@ -1,597 +0,0 @@
-# Release history
-
-**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
-* Check that the version of the Lua C library matches the desired Lua version
-* Fixed deployment of non-wrapped binaries
-* Fixed crash when `--lua-version` option is malformed
-* Fixed help message for `--pin` option
-* Unix: use native methods and don't always rely on $USER to determine user
-* Windows: use native CLI tooling more
-* macOS: support .tbd extension when checking for libraries
-* macOS: add XCode SDK path to search paths
-* macOS: add best-effort heuristic for library search using Homebrew paths
-* macOS: avoid quoting issues with LIBFLAG
-* macOS: deployment target is now 11.0 on macOS 11+
-* added DragonFly BSD support
-* 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](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
-* `--deps-only` is now an alias for `--only-deps` (useful in case you always kept getting it wrong, like me!)
-* `luarocks build` and `luarocks make` now support using `--pin` and `--only-deps` at the same time, to produce a lock file of dependencies in use without installing the main package.
-* `luarocks show` can now accept a substring of the rock's name, like `list`.
-* `luarocks config`: when running without system-wide permissions, try storing the config locally by default. Also, if setting both lua_dir and --lua-version explicitly, auto-switch the default Lua version.
-* `luarocks` with no arguments now prints more info about the location of the Lua interpreter which is being used
-* `luarocks new_version` now keeps the old URL if the MD5 doesn't change.
-* `DEPS_DIR` is now accepted as a generic variable for dependency directories (e.g. `luarocks install foo DEPS_DIR=/usr/local`)
-* Handle quoting of arguments at the application level, for improved Windows support
-* All-in-one binary bundles `dkjson`, so it runs `luarocks upload` without requiring any additional dependencies.
-* Tweaks for Terra compatibility
-* win32: generate proper temp filename
-* No longer assume that Lua 5.3 is built with compat libraries and bundles `bit32`
-* `luarocks show`: do not crash when rockspec description is empty
-* When detecting the location of `lua.h`, check that its version matches the version of Lua being used
-* Fail gracefully when a third-party tool (wget, etc.) is missing
-* Fix logic for disabling mirrors that return network errors
-* 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](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](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](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](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
-* When building with --force-config, LuaRocks now never uses the "project" directory, but only the forced configuration
-* Lua libdir is now only checked for commands/platforms that really need to link Lua explicitly
-* LuaJIT is now detected dynamically
-* RaptorJIT is now detected as a LuaJIT variant
-* Improvements in Lua autodetection at runtime
-* luarocks new_version: new option --dir
-* luarocks which: report modules found via package.path and package.cpath as well
-* 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](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](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](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](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
-* persist selected Lua version when setting `luarocks config lua_version 5.x`
-* new flag --global for overriding local_by_default = true
-* do not complain if home cache cannot be created (use temp dir instead)
-* caching improvements for increased performance
-* project-based workflow: if ./.luarocks/config-5.x.lua exists, assume Lua 5.x
-* install, pack, build, make: new flags --sign and --verify (using GPG)
-* install: new flag --no-doc
-* Improve Lua paths auto-detection
-* Various bugfixes
-
-**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](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](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
-* Improved behavior in module autodetection
-* Bugfixes in luarocks show
-* 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](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](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
-* New flags, including `--lua-dir` and `--lua-version` for using multiple Lua installs with a single LuaRocks
-* New build system, gearing towards a new distribution model
-* General improvements, including namespaces
-* User-visible changes, including some breaking changes
-* Internal changes
-
-**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
-* Updated Windows installer to better handle gcc toolchains
-* Fix detection of directories on Windows
-* Fixes .def generation on Windows
-
-**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](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
-* Performance improvements when removing packages
-* Support user-defined `platforms` array in config file
-* Improvements in Lua interpreter version detection in Unix configure script
-* 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](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](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
-* Improved behavior preserving permissions
-* Improved listing of dependencies on installation
-* Improved behavior of argument handling in `pack`
-* MSYS and Haiku platform detection
-* Feature-based detection of internal bit32 and utf8 modules
-* Internal reorganization of luarocks.fs code
-* `remove` option --force=fast renamed to --force-fast
-* Plus assorted bugfixes and cleanups
-
-**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
-* Improve error messages when tools are not installed
-* CMake: generate 64-bit builds when appropriate
-* Improve check of location of config files
-* MacOSX: set MACOSX_DEPLOYMENT_TARGET using env
-* Remove --extensions flag; use rockspec_format instead
-* New `luarocks config` command to query configuration
-* Improved UI for messages when external deps are missing
-* Unix: Robustness improvement in configure script
-* Plus tweaks and bugfixes. See the changelog for details.
-
-**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
-* Improved command-line argument parser, now validates arguments (it previously ignored unrecognized arguments) and accepts both `--flag=option` and `--flag option` in flags that take arguments.
-* For consistency with `luarocks show`, `luarocks doc --homepage` is now `luarocks doc --home`
-* Improvements to CMake build backend
-* Improved Makefiles for handling simultaneous bootstrapped installations
-* Various bugfixes
-
-**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](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
-* Preliminary support for Lua 5.3
-* No longer uses the module() function, for Lua 5.2 installations built without Lua 5.1 compatibility
-* --branch flag for `luarocks build` and `luarocks make`
-* various improvements in `luarocks doc` command
-* "git+http" transport for source.url
-
-**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 <module>" 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.
-* a rocks_provided configuration entry in which you can preload dependencies that are already fulfulled in your system; a few defaults are included (bit32 is auto-provided in Lua 5.2; luabitop is auto-provided in LuaJIT)
-* generated script wrappers are now more robust
-* Graceful handling of permission errors on Windows
-* Minor performance improvements
-* Support for "named trees", so you can label your rocks trees and use flags such as --tree=system  or --tree=user instead of the full path
-* "luarocks" with no arguments presents more useful diagnostics
-* Improved Lua detection in Unix installer
-* plus assorted bugfixes
-
-**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
-* detection of multiarch directories on Linux
-* environment and performance improvements on Windows
-* New --force=fast option for 'luarocks remove'
-* New --local-tree flag for 'luarocks-admin make-manifest'
-* Improved error checking
-* plus assorted bugfixes
-
-**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.
-* 'make bootstrap' is now an advertised option for installing LuaRocks itself as a rock on Unix systems
-* 'luarocks purge --old-versions' for cleaning up a local tree
-* --keep flag to produce the old behavior of keeping old versions around (can be made permanent setting keep_old_versions=true in the config file)
-* security config options 'accepted_build_types' and 'hooks_enabled'
-* 'lua_version' is now available as a global for your config.lua
-* new flags --lr-path, --lr-cpath, --lr-bin for 'luarocks path' for use in scripts
-* friendlier error messages
-* plus bugfixes
-
-**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
-* Improvements for the 'builtin' build mode on Windows
-* rclauncher on Windows does not rely on a precompiled object anymore
-* Improvements for the Windows installer, including optional registry entries for context-menu operations
-* 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](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
-* --porcelain flag for "list" and "search"
-* More consistent user-agent reporting
-* Code cleanups, removal of dead code
-* Fixes regressions on Mac and Windows
-
-**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
-* Fix tree loading order on luarocks.loader with multiple trees
-* Fix detection of write permissions
-* Improve dependency detection using configurable patterns, now a file like "libfoo.so.1" satisfies "libfoo.so"
-* --bin flag for "luarocks path" command, exports $PATH
-* Support for mirrors in the rocks_servers list, default list of mirrors included
-* Avoid using Lua modules internally on Windows, to avoid file system locking
-* Add NetBSD support
-* Rename luarocks.rep to luarocks.repos
-* Fail gracefully on the absence of cmake, on cmake build mode
-* New command "lint", to check the syntax of a rockspec
-* 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](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
-* Builtin mode sets rpath when compiling on Unix
-* Use full path in $(LUA) when configured with --with-lua
-* Cleanup of .svn dir in svn-based rocks
-* Improvement for 'make bootstrap'
-
-**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
-* --nodeps flag for forced installation without dependencies
-* "new_version" command to streamline writing of updated rockspecs
-* Improved handling of LUAROCKS_SYSCONFIG variable
-* Clickable URLs in descriptions in rocks repo index.html
-* Nicer-looking persisted tables
-* Assorted bugfixes
-
-**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
-* Fixes for Windows .bat installer
-* Improved arch detection when packing binary rocks
-* Workaround LuaPosix 5.1.15 problem with chmod()
-* Proper error messages when config files are invalid
-* Avoid checking permissions when it's not necessary
-* Fix behavior of 'builtin' rocks which install init.lua scripts
-* git+file:// pseudoprotocol for local Git repos
-* New binaries from GnuWin32 shipped in Win32 zip
-* Nicer-looking help
-
-**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](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
-* Copy entries to bin/ with proper permissions
-* Fix --pack-binary-rock and add support for it in "luarocks make" as well
-* Isolate references to "5.1" to luarocks.cfg module
-* More logical names for flags: --tree, --server
-* Improved documentation
-
-**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
-* Support for building a rock without installing it
-* Site-local configuration is now at luarocks.site_config
-* Support for Mercurial
-* Flag for experimental extensions
-* Plus assorted bugfixes
-
-**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
-* Handle redirects between http (LuaSocket) and https (LuaSec)
-* Avoid relying on the $PWD variable
-* Code cleanups
-
-**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](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
-* Remove .git from source tree when downloading from Git
-* Display of external dependencies in index.html
-* OpenBSD support
-* More thorough search for external libraries
-* Normalize paths to fix behavior when LFS is used under Windows
-* Add HTTPS support using LuaSec when using LuaSocket, for consistency
-* Better propagation of error messages
-* Stable sort of persisted files such as manifests
-* Plus assorted bugfixes
-
-**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
-* -fPIC is always set in CFLAGS exported to makefiles
-* respect permissions when copying files in Unix systems
-* display license after build/installation
-* svn:// protocol for scm rockspecs
-* "luarocks list" and "luarocks search" are now case-insensitive
-* "luarocks-admin add" supports adding multiple files at once
-* "luarocks-admin add" supports rsync for download and upload and scp for upload
-* new command: "luarocks show" displays information about an installed rock
-* 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](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](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
-* cleanup of configure options and references to the old LuaForge URLs
-* install LuaRocks as a rock
-* plus assorted bugfixes
-
-**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
-* new abstraction system for file system operations: the OS-specific back-ends for luarocks.fs were split between native-Lua and tool-based implementations
-* new format for local manifest
-* new command for luarocks: "download", to fetch .rock and .rockspec files
-* 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](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
-* Improve detection of external libraries on Mac OSX
-* 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](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.
-* Git support, contributed by Thomas Harning.
-* Improve shell compatibility for different Unix systems.
-* Add the @ operator for no-upgrade dependencies.
-* Add check for rockspec version format.
-* Generate index.html when building a manifest for a repository.
-* Plus assorted bugfixes.
-
-**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.
-* Smarter check to decide if a rock is pure Lua or not, also checking bin/
-* Restructuring of fs code.
-* Modularized fetch code to support multiple SCMs.
-* Added specific support for 'doc' directory in rockspecs. Auto-install files in 'lua' in builtin builds.
-* Support for Surround SCM, contributed by Ignacio Burgueño.
-* "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](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](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](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).
-* Flags --from=_server_, --only-from=_server_ and --to=_tree_, to allow specifying exactly where to get rocks from and where to install them to.
-* The manifest file now stores dependency info -- luarocks.require no longer scans rockspec files.
-* 'unpack' command allows unpacking binary and pure-Lua rocks, for inspecting.
-* Plus assorted bugfixes.
-
-**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](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](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](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.
-* Support for installing non-Lua entries in bin/ dirs.
-* Support for specifying libdirs, incdirs, libraries and defines in "module"-type builds.
-* x86_64 support, by Brian Hetro.
-* FreeBSD support, by Matthew M. Burke.
-* Performance improvements.
-* Many assorted bugfixes.
-
-**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](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](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](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](https://luarocks.github.io/luarocks/releases/luarocks-0.1.tar.gz)
-
-* Initial release.