Codebase list lua-ldoc / d8042a7f-5b58-4534-8e96-54b5b7978733/main changes.md
d8042a7f-5b58-4534-8e96-54b5b7978733/main

Tree @d8042a7f-5b58-4534-8e96-54b5b7978733/main (Download .tar.gz)

changes.md @d8042a7f-5b58-4534-8e96-54b5b7978733/mainraw · history · blame

## Version 1.4.4

### Features
  * better Lua 5.3 support
  * handles tables with integer_keys as well as string keys
  * `--testing` - version and date does not change
  * `--no_args_infer` to completely switch off argument inference and parsing
  * `custom_csv` option to specify extra CSS file
  * explicit warnings if we cannot deduce item from following code
  * modules may return a single _function_ (see tests/funmod.lua)
  * honours the `SOURCE_DATE_EPOCH` environment variable
  * Moonscript fat arrow and auto-assign ctor support
  * Better Discount support. All varieties including Debian lua-discount package (binding to libmarkdown2)
  * prettier output for `ldoc -m` on Unix
  * updated global builtin documentation


### Fixes
  * consistently using Unix line-endings
  * `--fatalwarnings` now also works with parser errors (#255)
  * user-specific temporary directory for expanding templates
  * blank line after comment of code block suppressed (#240)
  * comments at end of code blocks were not highlighting
  * strip left spaces from usage code (#191)
  * don't parse `module` if it's a field name (e.g `foo.module()`)
  * temporary files on Windows fix

## Version 1.4.3

### Features

  * @include tag for including Markdown documentation file directly into module docstring
  * `prettify_files` makes per-item links to prettified source.
  * link targets rendered in bright yellow to make referenced functions more obvious
  * add update time to footer of page
  * better C support: `global_lookup=true` - invoked when `parse_extra={C=true}`
  * `kind_names` can override names used in sidebar
  
### Fixes

  * `all=true` in `config.ld` did not work.
  * `dont_escape_underscore` logic fixed: do not use in prettified code blocks
  * check that `ldoc` config exists before checking field values
  * annotation rendering fixed
  * summary not dropped when using `type` sections
  * directory as argument case was broken
  * parameter names which were List methods causing mayhem
  * files are processed in fixed order across platforms

## Version 1.4.2

### Features

  * Can define fields/properties of objects; `readonly` modifier supported (#93)
  * Can switch off auto-linking to Lua manual with `no_lua_ref`
  * Module sorting is off by default, use `sort_modules=true`
  * References to 'classes' now work properly
  * Option to use first Markdown title instead of file names with `use_markdown_titles`
  * Automatic `Metamethods` and `Methods` sections generated for `classmod` classes
  * `unqualified=true` to strip package names on sidebar (#110)
  * Custom tags (which may be hidden)
  * Custom Display Name handlers

### Fixes

  * stricter about doc comments, now excludes common '----- XXXXX ----' pattern
  * no longer expects space after `##` in Markdown (#96)
  * Section lookup was broken
  * With `export` tag, decide whether method is static or not
  * `classmod` classes now respect custom sections (#113)
  * Minor issues with prettification
  * Command-line flags set explicitly take precendence over configuration file values.
  * Boilerplate Lua block comment ignored properly (#137)
  * Inline links with underscores sorted (#22)
  * Info section ordering is now consistent (#150)

## Version 1.4.0

### Features

  * `sort=true` to sort items within sections alphabetically
  * `@set` tag in module comments; e.g, can say `@set sort=true`
  * `@classmod` tag for defining modules that export one class
  * can generate Markdown output
  * Can prettify C as well as Lua code with built-in prettifier
  * lfs and lpeg references understood
  * 'pale' template available
  * multiple return groups
  * experimental `@error` tag
  * Moonscript and plain C support


### Fixes

  * works with non-compatibily Lua 5.2, including `markdown.lua`
  * module names can not be types
  * all `builtin` Lua files are requirable without `module`
  * backticks expand in copyright and other 'info' tabs
  * `-m` tries harder to resolve methods
  * auto-scroll in navigation area to avoid breaking identifiers
  * better error message for non-luadoc-compatible behaviour
  * custom see references fixed