95 Commits

Author SHA1 Message Date
Jeff Williams
2ed4a0320b if we can't find the scope for a virtual comment, set the doclet's scope to global (#684) 2014-08-18 17:32:21 -07:00
Jeff Williams
17fb5be064 for Closure, allow the type tag to have a description (#732) 2014-08-13 21:53:11 -07:00
Jeff Williams
e8b692b334 allow the Closure version of the protected tag to specify a type (#731)
Also adds tests for the `protected` tag.
2014-08-13 17:04:47 -07:00
Jeff Williams
21e0dbad25 allow the Closure version of the private tag to specify a type (#730) 2014-08-13 15:32:51 -07:00
Jeff Williams
291e254296 add new test fixture (#727) 2014-08-12 10:47:37 -07:00
Jeff Williams
277d712f3e cleanup 2014-08-11 16:02:00 -07:00
Jeff Williams
7ef13bf40b prevent crash when a class claims to implement an interface but has no members 2014-08-11 16:01:59 -07:00
Jeff Williams
7c2a6d7438 cleanup 2014-08-11 16:01:59 -07:00
MinHyeong Kim
87c33e242b modify codes for generate describe interface's all properties. 2014-08-11 16:01:59 -07:00
MinHyeong Kim
cc9ceb700b fix codes for patch. excepts 'implements not functions' issue. 2014-08-11 16:01:59 -07:00
MinHyeong Kim
52426cd3a7 add test codes for @interface, @implements annotations. 2014-08-11 16:01:59 -07:00
Jeff Williams
1171593908 parsedType property improvements (#576)
- Make the parsedType property non-enumerable unless debug mode is enabled.
- Add a more appropriate test case.
- Remove the (incomplete) schema for parsed types.
2014-07-30 12:04:10 -07:00
Jeff Williams
2dec7bd4e0 expose parsed type in doclets (#576)
Author: Alexey Malutin (https://github.com/Alexey-Malutin)
2014-07-30 10:53:10 -07:00
Jeff Williams
abfa24578c don't log an error when a comment only contains whitespace (#698) 2014-07-02 20:11:39 -07:00
Jeff Williams
254c05fbf6 set the appropriate longname for function declarations in AMD modules (#685)
This is a hack. See #693 for details.
2014-06-29 17:11:55 -07:00
Jeff Williams
873f3dac3d regression test for #683 2014-06-28 08:23:32 -07:00
Jeff Williams
8840f30a0b autodetect parameter names in function expressions (#674) 2014-06-20 16:51:36 -07:00
Jeff Williams
941b647d5b prevent type info from overwriting existing doclet properties (#676) 2014-06-19 16:44:38 -07:00
Jeff Williams
43ebd95874 add tests for external tag 2014-05-23 13:29:52 -07:00
Jeff Williams
1566421a62 give doclets a longname even if the name is empty (#643) 2014-04-26 10:57:10 -07:00
Jeff Williams
f635b10b6f fix comment-attachment issue (#638)
The issue in brief: Within an object literal, if a standalone comment was followed by a commented symbol, the symbol's comment would not be attached correctly.

The fix essentially reverts the changes for #565, which are no longer needed thanks to 50cd99fa2fca753fcf7c9ec3ecf70afd47168e94.

The fix also corrects the order in which we walk a MemberExpression's child nodes. Without this correction, comments would not be attached correctly inside CallExpression nodes.
2014-04-25 21:53:30 -07:00
Jeff Williams
3d1c36a325 keep all type info for return and type tags (#618)
For consistency with method parameters, this change extends our unfortunate practice of adding type properties to the parent of the `type` object, rather than the object itself.
2014-04-15 09:26:19 -07:00
Jeff Williams
02f14958b1 cleanup 2014-04-15 09:06:16 -07:00
Bill Tutt
821156c01c Fix issue #631: virtual comments inside of modules aren't members of modules. 2014-04-13 20:28:20 -04:00
Jeff Williams
62406412b6 walk children of ES6 nodes (#555)
For now, the node visitor discards these and logs a warning.
2014-04-07 08:47:51 -07:00
Jeff Williams
3e4e48accd attach inline type annotations to function params (#611)
includes a new Rhino jar: jsdoc3/rhino@bb2446ad
2014-03-30 22:01:04 -07:00
Jeff Williams
8df4472a2d set the correct longname when the doclet's name starts with the namespace's name (#608)
plus some cleanup
2014-03-27 15:12:24 -07:00
Jeff Williams
65b2fd6499 fix typo; cleanup 2014-03-27 14:42:54 -07:00
Jeff Williams
a2512832a7 remove obsolete text fixtures 2014-03-27 14:39:17 -07:00
Jeff Williams
8128dc5335 handle default values that are array literals (#604)
plus some test cleanup
2014-03-18 10:16:41 -07:00
Jeff Williams
cd6c89ec10 re-enable default values that are object literals (#607) 2014-03-18 10:00:16 -07:00
Jeff Williams
3b5db81d92 fix closures with multiple lends tags (#569)
There were three separate problems here:

1. The visitor called `trackVars` at the wrong time for `AssignmentExpression` and `VariableDeclarator` nodes, which prevented JSDoc from setting the `funcscope` property correctly.
2. The `funcscope` property was being added to `VariableDeclarator` nodes. It should only be added to `AssignmentExpression` nodes.
3. We were trying to resolve the variable name `____` in `AssignmentExpression` nodes. This is a special value we add to the source code so that the `lends` tag will work, and it should never be resolved against the enclosing scope.

The previous, buggy behavior looked reasonable in most cases, but it didn't work for closures that contain multiple `lends` tags.
2014-03-16 19:58:34 -07:00
Jeff Williams
49ad746e49 trailing whitespace cleanup 2014-03-04 13:47:57 -08:00
Jeff Williams
48e6c392d5 huge whitespace cleanup
- remove all trailing whitespace
- for consistency, replace all tabs with spaces
2014-03-03 07:43:01 -08:00
Jeff Williams
4e3e4a0151 fix lends tag inside nested function calls (#565)
plus some minor test cleanup
2014-02-23 20:16:16 -08:00
Jeff Williams
ec93145550 fix the lends tag inside of closures (#573) 2014-02-23 09:36:59 -08:00
Jeff Williams
2a61c9f613 oops, forgot to commit a new test fixture (#574) 2014-02-16 09:35:27 -08:00
Jeff Williams
43b6920085 document new properties on module.exports (#500) 2014-02-01 20:12:24 -08:00
Jeff Williams
8bf9db836e Merge remote-tracking branch 'rassilon/issue-535'
Conflicts:
	lib/jsdoc/tag/dictionary/definitions.js
	test/fixtures/constanttag.js
	test/specs/tags/constanttag.js
2013-12-03 21:45:15 -08:00
Jeff Williams
44ff7255e2 correctly retrieve the name from @const tags, with or without a type (#367) 2013-12-01 08:14:19 -08:00
Jeff Williams
71cf7d7a1e rename text fixture for consistency 2013-11-26 07:51:20 -08:00
Bill Tutt
89ff00bbc7 longnames for external's no longer contain braces if the tag's text contained braces.
This fixes #351.
2013-11-26 07:48:22 -08:00
Bill Tutt
8be3a1fecc Fix jsdoc #535: @member and @constant with only type create incorrect doclet. 2013-11-21 22:51:58 -05:00
Jeff Williams
6651a85b35 Merge branch 'master' into parsimony
Conflicts:
	lib/jsdoc/src/filter.js
	lib/jsdoc/src/scanner.js
	package.json
	test/specs/jsdoc/src/filter.js
	test/specs/jsdoc/src/scanner.js
	test/specs/tags/exportstag.js
2013-11-04 08:54:46 -08:00
Jeff Williams
01882a231b test for variable-scoping issue in JSDoc 3.2.1 (#513) 2013-11-04 07:51:23 -08:00
Jeff Williams
de4297b20b refactor jsdoc.js; update Rhino
- Switched to a new Rhino fork: https://github.com/jsdoc3/rhino
  (currently reflects mozilla/rhino HEAD + enhancements for JSDoc)
- Removed jsdoc/util/global; new Rhino fork provides a `global` alias
  just like Node.js
- Moved most of jsdoc.js into cli.js, and refactored for clarity
2013-10-27 10:46:27 -07:00
Jeff Williams
751bea1b0a fixes for Node.js compatibility (see details)
- new Rhino .jar to help find module paths
(https://github.com/hegemonic/rhino/commit/31b70105)
- make __dirname and process.cwd() provide the current module path; use
only env.dirname for JSDoc's home dir; fix callers
- get rid of jsdoc/util/include (and update test framework accordingly)
- avoid running Rhino/Node.js tests on the wrong runtime
- remove support for global 'publish' function, which relied upon
jsdoc/util/include
- update jsdoc/util/dumper for consistency with Node.js'
JSON.stringify()
- fix jsdoc/util/runtime to detect Node.js correctly
- add Node.js versions of jsdoc/fs and jsdoc/path
- other minor cleanup
2013-10-25 23:30:56 -07:00
Jeff Williams
e7752cde18 Merge branch 'master' into parsimony
Conflicts:
	lib/jsdoc/name.js
	lib/jsdoc/src/handlers.js
	lib/jsdoc/src/parser.js
	lib/jsdoc/tag/dictionary/definitions.js
	lib/jsdoc/util/templateHelper.js
	package.json
	test/specs/documentation/alias.js
	test/specs/documentation/modules.js
	test/specs/tags/augmentstag.js
	test/specs/tags/overviewtag.js
2013-10-21 08:42:29 -07:00
Jeff Williams
735a9b790c esprima parser (currently disabled) 2013-10-21 08:02:03 -07:00
Jeff Williams
752e871f98 prevent undocumented overrides from replacing documented parents (#503) 2013-10-15 08:54:13 -07:00