UNPKG

dox

Version:

Markdown / JSdoc documentation generator

225 lines (157 loc) 6.61 kB
1.0.0 / 2022-09-06 ================== * jsdoctypeparser finally updated to latest version 0.9.1 / 2022-04-26 ================== * Dependency bumps for commander and markdown-it to address security vulnerabilities 0.9.0 / 2016-08-13 ================== * Markdown is now generated using the `markdown-it` package, which conforms to Commonmark standards. * Fix: Dox now recognizes ES6 template strings as strings and does not attempt to parse their contents. * Deps: added markdown-it@7.0.0 * Deps: removed marked * DevDeps: mocha@3.0.2 * DevDeps: should@11.0.0 0.8.1 / 2016-03-29 ================== * Fix: Dox will no longer falsely enter or exit string blocks when encountering an escaped quote or double-quote * Deps: commander@2.9.0 * Deps: marked@0.3.5 0.8.0 / 2015-05-27 ================== * Fix: Tags with whitespace between the tag start and the previous line ending are now parsed correctly. * Deps: commander@2.8.1 * Deps: jsdoctypeparser@1.2.0 - Better compatibility for type declarations, but may result in changes to output with invalid types. 0.7.1 / 2015-04-03 ================== Context parsing has been re-factored into an array of functions that are iterated over until a match is found. This array is exposed as `dox.contextPatternMatchers`, allowing for extension with new contexts without needing to edit the dox source. * Fix: ES6 classes extended from sub-properties (such as Backbone.View) are now properly matched 0.7.0 / 2015-03-24 ================== * Add context parsing for some ES6 syntax: - classes - class constructors - class methods - assignments via `let` or `const` * Add support for @description tag * Add context match for returned closure * Add: Tags without descriptions now have an `html` property containing a markdown parse of the tag's contents * Fix: more agnostic to code style when parsing contexts (eg, no longer ignores functions without spaces between function name and parenthesis) * Fix: No longer incorrectly tries to parse strings inside comments, causing large chunks of a file to be ignored. * Fix: No longer parses double slash in a string literal as being a comment start. * Deps: commander@2.7.1 0.6.1 / 2014-11-27 ================== * Tag descriptions now contain markdown and obey raw option 0.6.0 / 2014-11-27 ================== * Add complex jsdoc annotations * Add support for more tags * Add typesDescription field * Fix "skipPrefixes incorrectly assumes option.raw=false" * Fix "White spaces in the tag type string break the parsing of tags" 0.5.3 / 2014-10-06 ================== * Add `--skipSingleStar` option to ignore `/* ... */` comments * Merge #106: make the other context regex like the general method one 0.5.2 / 2014-10-05 ================== * Support event tags, add `isEvent` parameter to comment object * Removed obsolete make rules 0.5.1 / 2014-09-07 ================== * Fixed: `*/*` breaks parsing 0.5.0 / 2014-09-04 ================== * Marked options can be set via `dox.setMarkedOptions` * Comment blocks include `line` and `codeStart` to mark the first line of the comment block and the first line of the code context. * Ignores jshint, jslint and eslint directives. This can be overridden or added to via the `skipPrefixes` option and the `--skipPrefixes` command line flag, which takes a comma separated list of prefixes. * The code field trims extra indentation based on the indentation of the first line of code. * Set the `isConstructor` property when a `@constructor` tag is present and change `ctx.type` to constructor. * Recognizes the following code contexts: - `Foo.prototype.bar;` (property) - `Foo.prototype = {` (prototype) - `foo: function () {` (method) - `foo: bar` (property) - `get foo () {` (property) - `set foo () {` (property) * When a comment is present to identify the definition of an object literal, comments for the object's members will include a `ctx.constructor` property identifying the parent object. * Fixed: Multi-line comments with no space following the star are parsed correctly. - Example: `/*comment*/` * Fixed: A code context of `Foo.prototype.bar = null;` is parsed correctly. * `@param` tags include an `optional` attribute * `@returns` is recognized as an alias for `@return` * Support comments without descriptions (ex: `/** @name Foo **/`) * Fixed: Crash with the `--api` flag when no headers are generated. * Fixed: `--api` output includes aliases. 0.4.6 / 2014-07-09 ================== * do not wrap @example contents with markdown 0.4.5 / 2014-07-09 ================== * use marked for markdown rendering * multiline tags support (@example) * support for @template, @property, @define, @public, @private, @protected, @lends, @extends, @implements, @enum, @typedef 0.4.4 / 2013-07-28 ================== * add support for variable names containing "$". fix #102 0.4.3 / 2013-03-18 ================== * fix dox(1) --version. Closes #91 * fix ctx.string on properties of a prototype * add support tab-indented comments 0.4.2 / 2013-01-18 ================== * Prevent error when using --api & comments have no example code. 0.4.1 / 2012-11-11 ================== * change # to . in --api 0.4.0 / 2012-11-09 ================== * add TOC to --api. Closes #72 * add gfm code blocks. Closes #71 * remove implicit titles. Closes #70 0.3.3 / 2012-10-16 ================== * fix --api .receiver 0.3.2 / 2012-10-01 ================== * add dox --api 0.3.1 / 2012-04-25 ================== * Fixed annoying title bug 0.3.0 / 2012-03-27 ================== * Added __@memberOf__ [olivernn] * Added __@arguments__ [olivernn] * Added __@borrows__ [olivernn] 0.2.0 / 2012-02-23 ================== * Added `-r, --raw` support. Closes #48 0.1.3 / 2011-12-08 ================== * Added: allow arbitrary tags [logicalparadox] * Fixed function whitespace [TooTallNate] 0.1.2 / 2011-10-22 ================== * remove html escaping for now 0.1.1 / 2011-10-10 ================== * Fixed: colons in comment lines not intended as headers [Evan Owen] 0.0.5 / 2011-03-02 ================== * Adding "main" to package descriptor since "directories" are no longer supported. 0.0.4 / 2011-01-20 ================== * Added `--intro` support for including an intro file written in markdown [Alex Young] 0.0.3 / 2010-07-15 ================== * Linked h2s 0.0.2 / 2010-07-15 ================== * Collapsing files, click to open. Closes #19 * Fixed ribbon position instead of absolute * Removed menu * Removed node-discount dependency, using markdown-js