archive-gh-me/jsdoc
1
0
Fork 0
mirror of https://github.com/jsdoc/jsdoc.git synced 2025-12-08 19:46:11 +00:00
Code Issues Projects Releases Wiki Activity
1,242 Commits 10 Branches 386 Tags
Commit Graph

290 Commits

Author SHA1 Message Date
Jeff Williams
cd9d7f90a7 change 'virtual' to 'abstract' in the template helper (#618) 2014-04-18 16:46:24 -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
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
6480b96e7e log a warning if the type tag has a description (#615) 
adds a `mustNotHaveDescription` property for tag definitions
 2014-04-13 08:12:09 -07:00
Jeff Williams
3b45503625 log a warning if a tag has an extraneous value (#632) 2014-04-13 07:26:11 -07:00
Jeff Williams
b7782fc151 Merge pull request #617 from cdparks/fix-excludes 
Fix for #616, making excluded-filepaths play nicely with -r
 2014-04-09 16:52:32 -07:00
jeffwi
933db9f032 handle Esprima parse errors more gracefully (#625) 2014-04-09 16:50:47 -07:00
Christopher D. Parks
40d5a352bb Adding test for fix 
Without the fix, we get the following when running ./jsdoc -T:
    Failures:

    jsdoc/src/filter Filter isIncluded

      1) should be able to exclude descendants of excluded subdirectories
      Message:
        Expected 4 to be 2.
      Stacktrace:
        undefined

      2) should be able to exclude descendants of excluded subdirectories
      Message:
        Expected 1 to be -1.
      Stacktrace:
        undefined

      3) should be able to exclude descendants of excluded subdirectories
      Message:
        Expected 3 to be -1.
      Stacktrace:
        undefined

    Finished in 6.696 seconds
    849 tests, 2050 assertions, 3 failures

This test passes with the fix.
 2014-04-07 10:44:21 -07: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
463065d996 clean up tests 2014-03-18 22:02:58 -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
dd27185ad9 fix issues with doclet names that are filepaths (#590) 
Prior to this fix, if a file was outside of the JSDoc
directory, and your code included something like a
`@file` tag, we would set the doclet's name to the
entire filepath instead of the shortened filepath.

With this fix, we set the name to the shortened
filepath.
 2014-03-04 12:31:09 -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
ab9ca215a1 exclude subdirectories of included directories (#484) 2014-03-02 16:30:30 -08:00
Jeff Williams
e095462a57 delint 2014-03-02 16:13:59 -08:00
Jeff Williams
60c7c8a606 add debugging properties to AST nodes (#589) 2014-02-26 08:31:53 -08:00
Jeff Williams
2442df893d allow newDoclet event handlers to modify doclets (#584) 2014-02-23 20:34:38 -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
34d98ed438 add @also to tag definitions (#574) 
This tag is used internally. It previously caused
"not a known tag" errors when
tags.allowUnknownTags was set to false.
 2014-02-16 08:39:32 -08:00
Jeff Williams
3ae23b8b21 provide a setter for doclet scope (#574) 
We previously set the doclet's scope by adding a
`@scope` tag, which, in turn, was used to update
the scope. Since this tag isn't defined or used in
any other context, it could cause "not a known
tag" errors.
 2014-02-16 07:44:28 -08:00
Jeff Williams
43b6920085 document new properties on module.exports (#500) 2014-02-01 20:12:24 -08:00
Jeff Williams
6d83ffd060 the common prefix for one file is the file's dirname (#553) 2013-12-26 21:19:37 -08:00
Jeff Williams
22d4ce4eed improve tests 2013-12-26 13:43:15 -08:00
Jeff Williams
9b4bbbf71b formatting 2013-12-26 13:00:00 -08:00
Jeff Williams
db737e75ff move JSHint testing to Gruntfile 2013-12-26 05:23:38 -08:00
Jeff Williams
d426d5696b add Grunt tasks to run tests for all supported runtimes/parsers (#525) 
To run the tests:
1. npm install -g grunt-cli
2. npm install (in JSDoc directory)
3. npm test (or: grunt test)
 2013-12-25 21:47:38 -08:00
Jeff Williams
c9b0237c12 overhaul logging and error handling (#416) 2013-12-23 15:25:28 -08:00
Jeff Williams
147843eb58 fix tests on non-Windows systems 2013-12-08 14:15:43 -08:00
Jeff Williams
f00e390cf0 fix various filepath issues (including #541) 2013-12-08 13:51:44 -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
42e6822009 update JSON schema; validate doclets against schema (#327) 2013-12-03 16:45:36 -08:00
Jeff Williams
a0553bb942 replace undefined with null instead of the string "undefined" 2013-12-03 11:49:22 -08:00
Jeff Williams
6156d45582 allow template files to be specified as absolute paths (#480) 2013-12-01 10:04:47 -08:00
Jeff Williams
9a7b9efe14 search config file path for resources; use the working directory to find the common path prefix 2013-12-01 09:38:49 -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
522a377845 cleanup 2013-11-26 16:32:26 -08:00
Jeff Williams
3740c7087a cleanup 2013-11-26 16:08:52 -08:00
Evgeni Dmitriev
83b009bfbf Automatically remove per-line indent for @example tag 2013-11-27 00:59:54 +04:00
Jeff Williams
6af2352d26 start refactoring AST node-related methods into a new module (+ cleanup) 2013-11-24 09:42:50 -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
ccdee70bbe test for prototype of duplicated objects 2013-11-20 08:18:44 -08:00
Jeff Williams
6b62beb055 use correct prototype when duplicating objects; fix bad test 2013-11-20 07:15:11 -08:00
Jeff Williams
3716df0e23 update JSHint to 2.3.0, and only run it on Node.js 2013-11-10 23:20:03 -08:00
Jeff Williams
e0df71b1ae fix various path-related issues on Windows 
- add env.pwd global, and use it instead of process.env.PWD, which is
undefined in Node.js on Windows
- normalize paths where necessary
 2013-11-10 16:57:48 -08:00