RELEASE

# Prepare working tree for release

1. Add an entry to the `HISTORY` file with the version name, release date, and 
   what's new in the new version.
2. Update copyright dates if needed:
    - `COPYRIGHT` file;
    - `_COPYRIGHT` exported constant in the main module.
3. Update version in `_VERSION` exported constant in the main module.
4. Make sure that all authors are listed in the `AUTHORS` file. To get the 
   authors list from the git tree, use the command:
   ```
   git log --format="%aN <%ae>" | sort | uniq
   ```
5. Regenerate tests list (performed by `./make.sh`)
6. Regenerate exports list (performed by `./make.sh`)
7. Generate the `scm-1` rockspec (performed by `./make.sh`)
8. Generate the `VERSION-1` rockspec, where VERSION is a version to be released.
   Example:
   ```
   lua etc/rockspec/generate.lua 1.1.0-1 v1.1.0 > rockspec/lua-nucleo-1.1.0-1.rockspec
   ````
9. Regenerate API docs: `./make-doc.sh`
10. Make sure that all the changes are in the working tree.
11. Last check that all tests are passed OK in latest Lua 5.1, Lua 5.2, Lua 5.3
    Lua 5.4.
12. Tag the working tree head with the version name, e.g. `v1.1.0`.
13. Push the tag to the origin.

# Publish on [LuaRocks.org](https://luarocks.org)

`luarocks upload rockspec/lua-nucleo-VERSION-1.rockspec`, where VERSION is a
version to be released.

See also:
- https://github.com/luarocks/luarocks/wiki/creating-a-rock#publishing-your-code-online
- https://luarocks.org/upload