Add CHANGELOG.md [ci skip]

Release descriptions on GitHub don't seem to be a part of the repo.
Migrate them into a file.

CHANGELOG.md

@@ -0,0 +1,364 @@
+# Change Log
+
+## 0.17.0 (unreleased)
+
+### New features and improvements
+
+* Trailing whitespace and inconsistent indentation (tabs after spaces)
+  are now detected (#79).
+
+## 0.16.3 (2016-10-27)
+
+### Fixes
+
+* Fixed version number (#75).
+
+## 0.16.2 (2016-10-25)
+
+### Fixes
+
+* Fixed error in some cases when a function declaration is unreachable (#74).
+
+## 0.16.1 (2016-09-29)
+
+### Fixes
+
+* Fixed false positive for `variable/value is mutated but never accessed`
+  warning when initial value of a variable comes from `X and Y`, `X or Y`, or
+  `(X())` expression (#72).
+
+## 0.16.0 (2016-08-30)
+
+### New features and improvements
+
+* Local tables which are mutated but not used are now detected (#61).
+* Mutations of global variables with key chains of length > 1
+  are now correctly reported as mutations, not accesses.
+* Completely unused variables named `_` are now reported (#66).
+
+### Fixes
+
+* `luacheck: ignore` now correctly filters out `5xx` and `314` warnings (#71).
+
+## 0.15.1 (2016-06-09)
+
+### Fixes
+
+* Fixed JUnit formatter not escaping XML entities (#62).
+
+## 0.15.0 (2016-04-18)
+
+### New features and improvements
+
+* New `rockspec` std set containing globals allowed in rockspecs (#55).
+
+### Fixes
+
+* Fixed error when checking a file with a hexadecimal number using
+  Lua 5.1 on Windows (#57).
+* Fixed luacheck using wrong path when checking a file in a subdirectory with
+  single character name (#59).
+
+## 0.14.0 (2016-02-25)
+
+### New features and improvements
+
+* Duplicated keys in table literals are detected (#48).
+* Unused recursive and mutually recursive functions assigned to local
+  variables are detected (#50).
+* Globs can be used to select paths when applying option overrides
+  in config (#52).
+* Inline options can contain notes in parentheses.
+* `--jobs` option (multithreading) is used by default with LuaLanes found,
+  number of threads used is set to number of available processing units.
+* Better error messages are provided on I/O and other errors
+  when reading files, loading configs and rockspecs, etc.
+* Better path handling when recursively checking directories
+  ending with slash.
+
+## 0.13.0 (2016-01-04)
+
+### New features and improvements
+
+* Empty statements (semicolons without preceding statements) are
+  reported (#44).
+* Inline option `luacheck: push` can be followed by other options on
+  the same line, e.g. `luacheck: push ignore`.
+* Better syntax error messages.
+* When recursively checking directories and `--include-files` is used,
+  files are not filtered by `.lua` extension (#43).
+
+### Fixes
+
+* Fixed crash when source ends with `.`, `"\` or `"\u{`.
+
+## 0.12.0 (2015-11-02)
+
+### New features and improvements
+
+* New `ngx_lua` globals set for Openresty ngx_lua module (#41).
+* Better CLI error messages.
+
+### Fixes
+
+* Fixed duplicate `uninitialized access` and `unreachable code` warnings in
+  nested functions.
+
+### Miscellaneous
+
+* RTD theme is no longer required when building docs.
+* HTML docs are no longer stored in the repo.
+
+## 0.11.1 (2015-08-09)
+
+### Improvements
+
+* More accurate analysis around literal conditions, e.g.
+  `while true do ... end`.
+* Extra threads are not created when number of files is less
+  than value of `--jobs` option.
+
+### Fixes
+
+* Fixed crash on unreachable repeat condition (#36).
+* Fixed crash when using `--ranges` with cache.
+* Fixed incorrect output or crashes when loading cache created
+  by a different version (#37).
+* Fixed crash when an upvalue is followed by an infinite loop.
+
+## 0.11.0 (2015-07-18)
+
+### Breaking changes
+
+* Removed `--no-unused-globals` option, use `--ignore 13` instead.
+* Removed `.vararg` field for warnings related to varargs,
+  check `.name == "..."` instead.
+* Errors now also have codes, starting with `0`, and are returned
+  together with warnings from `luacheck.*` functions (#31).
+
+### New features and improvements
+
+* During config lookup all directories starting from current one and up to
+  file system root are traversed in search of config.
+  Path-related data from config loaded from an upper directory is adjusted
+  to work as if Luacheck was started from the directory with config (#20).
+* New `--exclude-files` and `--include-files` options for
+  file filtering using globbing patterns (#21).
+* More CLI and config options can be used inline.
+* Underscores in inline option names can be replaced with spaces.
+* Inline options without arguments can be prefixed with
+  `no` to invert meaning.
+* New built-in global set `busted` containing globals of
+  Busted testing framework.
+* Stable interface for editor plugins.
+* New `luacheck.get_message` function for formatting
+  a message for a warning or error.
+* Sets of standard globals can be merged using `+`.
+* If value of `std` option starts with `+`, new set is added to
+  the old one instead of overwriting it,
+* New `--filename` option allows using real file name for picking config
+  per-path overrides while passing source through stdin or a temporary file.
+* New `--ranges` option provides column ranges for tokens related to warnings (#32).
+* New `--no-self` option for ignoring warnings related to
+  implicit `self` argument.
+* Config options can now be returned as a table.
+* Config now has access to all regular globals in its environment.
+* New sets of standard globals can be created by mutating
+  global `stds` in config.
+* `formatter` config option now accepts functions.
+* Warnings returned from `luacheck.*` functions now have =
+  `.end_column` field with last column of related token.
+* JUnit formatter now produces a testcase per each issue.
+
+### Fixes
+
+* Fixed validation error when attempting to use `formatter` option in config.
+* Fixed incorrect error location for `invalid escape sequence` syntax errors.
+* FIxed spurious quotes in typecheck error messages in `luacheck.*` functions.
+* UTF BOM is now stripped when reading files.
+
+## 0.10.0 (2015-03-13)
+
+### Breaking changes
+
+* Removed `--limit`/`-l` option, use inline options to
+  ignore warnings that are OK.
+* Removed `--no-unused-values`/`-v` option, use
+  `--no-unused-secondaries`/`-s` instead.
+* Removed `--no-unset` option, use `--ignore 221` instead.
+
+### New features and improvements
+
+* Added caching of check results (`--cache` and `--no-cache` options).
+* Added parallel checking (`--jobs`/`-j` option).
+* Added reporting of syntax error message and location in CLI (#17).
+* Added `--version` command for showing versions of Luacheck
+  and its dependencies.
+* Added more functions to `luacheck` Lua module.
+
+### Fixes
+
+* Fixed file status label not being colored when using `-qq`.
+
+### Miscellaneous
+
+* Added installer script (`install.lua`).
+
+## 0.9.0 (2015-02-15)
+
+### New features and improvements
+
+* Added inline options: a way to precisely configure luacheck using
+  inline comments of special format (#16).
+* Added an option to use custom output formatters;
+  TAP and JUnit formatters are built-in (#19).
+
+### Fixes
+
+* Fixed crash when checking stdin using a config with overrides.
+
+## 0.8.0 (2015-01-19)
+
+### New features and improvements
+
+* Added detection of unused labels.
+* Added detection of unreachable code.
+* Added detection of loops that can be executed at most once.
+* Added detection of uninitialized variables.
+* Added detection of shadowed local variables.
+* Added detection of empty blocks.
+* Added detection of unbalanced assignments.
+* New warning categorization system using warning codes.
+* Added possibility to mark globals as read-only (most standard globals
+  are so by default).
+* Added possibility to overwrite options on per-directory basis in config.
+* Some CLI-specific options can now be used in config (e.g. `color`).
+* Added standard global sets for Lua 5.3.
+
+### Miscellaneous
+
+* Removed unnecessary dependencies.
+* Simplified manual installation (#12).
+* Added executable wrapper for Windows (#14).
+
+## 0.7.3 (2015-01-05)
+
+### Fixes
+
+* Fixed false `unused variable` and `unused value` warnings when a closure
+  accessing a variable is created in a nested block (#10).
+
+## 0.7.2 (2015-01-03)
+
+### Improvements
+
+* Improved analysis quality w.r.t unused values using flow-sensitive analysis.
+
+## 0.7.1 (2014-12-16)
+
+### Improvements
+
+* When `--no-color` is used, identifiers are now quoted in
+  warning messages (#8).
+
+### Fixes
+
+* Fixed priority of options: CLI options override config per-file overrides,
+  which override general config.
+* Fixed ignoring `std` option in CLI when `compat` option is used in config.
+
+## 0.7.0 (2014-11-23)
+
+### New features and improvements
+
+* Added `--allow-defined-top` and `--module` options for more
+  flexible checking of files which are supposed to set globals (#7).
+* Added `--no-unused-secondaries` option for removing warnings
+  about unused values set together with used ones.
+* Added detection of variables that are used but never set.
+
+### Fixes
+
+* Fixed ignoring `std` config option.
+* Fixed incompatibility with Lua 5.3.
+
+## 0.6.0 (2014-11-01)
+
+### New features and improvements
+
+* Luacheck can now check programs which use syntax introduced in Lua 5.2,
+  Lua 5.3 and LuaJIT 2.0.
+* Luacheck is now faster.
+* Luacheck now exits with an error if it couldn't load a config due to an I/O,
+  syntax, runtime or validation error.
+
+### Miscellaneous
+
+* Removed dependency on MetaLua parser.
+
+## 0.5.0 (2014-09-06)
+
+### Breaking changes
+
+* Changed the interface of `luacheck` module.
+* Changed what `-qq` and `-qqq` do.
+
+### New features and improvements
+
+* Added an option to disable colourization of output (#2).
+* Added an option to allow implicit global variable definition.
+* Filter out warnings about redefined `_` (#5).
+* `--globals`, `--ignore` and `--only` can now be used several times.
+* Passing `-` as an argument now checks stdin.
+* Passing a directory as an argument checks all `.lua` files inside it.
+* Added config loading (#1).
+* Added `--std` option, adding globals via `--globals` now does not require
+  passing a dash.
+* Added `--new-globals` option.
+
+## 0.4.1 (2014-08-25)
+
+### Miscellaneous
+
+* Updated to argparse 0.3.0
+
+## 0.4.0 (2014-05-31)
+
+### New features and improvements
+
+* Unused values (e.g. `local a = expr1; ... a = expr2`) are now detected.
+* In CLI, rockspecs (arguments ending with `.rockspec`) now expand into list
+  of related `.lua` files.
+* Unused varargs are now detected.
+
+## 0.3.0 (2014-04-25)
+
+### New features and improvements
+
+* Luacheck is now _ENV-aware: "globals" inside chunks with custom
+  `_ENV` are ignored, but their presence marks the `_ENV` variable as used;
+  accessing the outermost ("default") `_ENV` is permitted, too.
+* In `--globals` option of the CLI hyphen now expands to all standard
+  global variables.
+* New `-c`/`--compat` flag defines some additional globals for Lua 5.1/5.2
+  compatibility (e.g. `setfenv`).
+* New `-l`/`--limit` option allows setting a limit of warnings.
+  If the limit is not exceeded, the CLI exits with `0`.
+* The `-q`/`--quiet` flag now can be used several times (`-q`/`-qq`/`-qqq`)
+  to make the CLI more or less quiet.
+
+## 0.2.0 (2014-04-05)
+
+### New features and improvements
+
+* Command-line interface now prints per-file reports as they are produced
+  instead of waiting for all files to be checked.
+* Luacheck now recognizes different types of variables (normal locals,
+  function arguments and loop variables) and reports them accordingly.
+* Luacheck now distinguishes accessing global variables from setting them.
+* In command-line interface `-q` switch makes luacheck only print total
+  number of warnings instead of suppressing output completely.
+
+## 0.1.0 (2014-03-25)
+
+The first release.