- Tags with `@lends` are now filtered out early on, so they never
generate documentation. Lends tags are structural hints only.
- Uses built-in type checks instead of babel-types where appropriate.
- More internal documentation
- Now reuses code for parsing lends between different forms
Previously broken syntax, now working:
```js
/** parent */
export default function() {
/** child */
this.a = 1;
}
```
* feat(core): Switch to Promises everywhere. Adopt Node v4 ES6
Big changes:
* Uses template strings where appropriate
* Config and argument parsing is unified and there is no such thing
as formatterOptions anymore. All user-passed options go through
mergeConfig.
* The node API surface changed (again): `buildSync` is removed,
building operations return Promises.
* Now using Flow for internal type annotations.
More changes:
* Remove buildSync command
* feat(inference): Partially implement object shorthand support
* Refs #649
* Use Flow annotations to enforce types
* Keep flow but switch to comment syntax
* Clarify types
* More flow improvements
* Turn server into class
* LinkerStack becomes class too
* Fix comment description type
* Run flow on lint
* Many more flow fixes
* More intense flow refactoring
* Simplify inference steps
* Update inference tests, flow errors down to 1
* Continue refining types
* Fix more flow issues
* Use 'use strict' everywhere
* Make 'ast' property configurable
* Fix many tests
* Fix more tests
* Fix more tests
* Fix augments
* Test Markdown meta support
* Improve test coverage
* Switch back from for of to for for speed
For `--document-exported` we now use Node.js's `require.resolve`
method to resolve the path for modules referenced by other modules.
This fixes issues where we failed to load imported modules which lead to
a null comment being attached which caused an exception.
* Change document-exported to traverse the code
Instead of traversing over all input files this changes
documentExported to traverse from the exports in the input files,
loading, parsing and traversing the module specifier as needed.
Fixes#515
* Move parseToAst to its own module
* Skip non export declarations for speed
* Add a flag to document all exported bindings
This adds a boolean flag called `document-exported` (defaults to false)
that effectively adds an empty comment to all exported bindings that do
not already have a JSDoc comment. It also does the same for the
members of exported classes and objects.
```js
export class C {
method() {}
}
```
Both `C` and `C#method` are now part of the generated documentation.
Related to #424
* Fix lint error
* Rebase and use options pragma in test file
* Create extractor type as a generalized comment/export getter
* Document exported extractor
* Source-sorting by default
Many changes
* Uses a new version of module-deps that exposes a sort key
we use to sort documentation.
* Adds inference for methods in objects
* Groups events into a separate comment property
* Add jsdoc property. Refs https://github.com/documentationjs/documentation/pull/388#issuecomment-215791547
* Namespaces and paths
* More powerful paths: paths now include name, kind, and scope
* comments now include a 'namespace' property with a formatted namespace
* Fix tests
* Re-ignore fonts
* Nix sourceKey from output
* Pin dependency versions
* Fix module-deps-sortable ref
* Update tests for right deps