237 Commits

Author SHA1 Message Date
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
a3d3384293 resolve paths relative to the user's working directory 2013-11-04 07:12:23 -08:00
Jeff Williams
99ab99298d add partial test infrastructure to support testing multiple parsers in one runtime
not fully implemented.
2013-11-04 06:46:47 -08:00
Jeff Williams
4e93dcbd6c whitespace 2013-11-02 12:38:45 -07:00
Jeff Williams
84188d6e62 don't escape inline HTML in Markdown-tagged text; remove markdown-js parser, and default to marked (#510) 2013-11-02 12:37:34 -07: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
e02afd570e create parser, THEN attach plugins
fixes broken test
2013-10-21 09:11:23 -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
Jeff Williams
5fb3839389 don't rename a function param called "prototype" (#505); minor cleanup 2013-10-14 23:16:40 -07:00
Jeff Williams
77546a9d52 more fixes to ensure that we always generate valid filenames (#440) 2013-10-02 22:37:28 -07:00
Jeff Williams
463dd0a05b generate valid filenames for incorrectly tagged modules (#458) 2013-10-01 09:29:08 -07:00
Jeff Williams
3ce43c2f32 remove hashbang before parsing JS file (#499) 2013-09-30 22:24:50 -07:00
Jeff Williams
b31db5bab9 require name/description separators to start on the same line as the name (#459)
ensures we won't interpret a Markdown bullet on the following line as a
name/description separator
2013-09-20 08:37:44 -07:00
Jeff Williams
7863eb3eb9 test for #439 (and fix existing parseComplete test) 2013-09-14 09:02:06 -07:00
Jeff Williams
700e5d9ea9 fix type tag for type expressions that span multiple lines (#427) 2013-09-14 08:33:54 -07:00
Jeff Williams
da524aa558 allow requires tag text to be an inline link tag (#486) 2013-09-09 22:24:44 -07:00
Jeff Williams
abeb539a33 unit tests for let keyword (#477) 2013-08-17 00:24:36 -07:00
Jeff Williams
770f5ebb43 generate links correctly when text has extra [bracketed] strings (#470) 2013-08-05 21:26:43 -07:00
Jeff Williams
47fe83de3d prevent crashes in lenient mode when a param tag has an invalid type expression (#451) 2013-08-04 23:21:01 -07:00
Jeff Williams
01ce3042d1 prevent crashes in lenient mode when a returns tag has no value (#451) 2013-08-04 18:07:27 -07:00
Jeff Williams
c058a60ed1 hook up node visitors; gratuitous refactor of 'runtime' module (formerly 'vm'); move runtime-specific code
includes updated Rhino jar:
https://github.com/hegemonic/rhino/commit/b63c00d5
2013-07-05 09:11:27 -07:00
Jeff Williams
1f627daee2 temporarily disable the changes for #419 2013-06-30 11:11:16 -07:00
Louis-Dominique Dubeau
8ca34b69ad Typo fix. 2013-06-28 09:37:01 -04:00
Louis-Dominique Dubeau
39bf9adb2b Allow the presence of inline tags for a @returns tag that does not have a type spec. 2013-06-28 09:33:05 -04:00
Jeff Williams
da22d723b7 Merge branch 'master' into parsimony
Conflicts:
	lib/jsdoc/src/parser.js
	test/specs/tags/defaulttag.js
2013-06-23 21:40:21 -07:00
Jeff Williams
c16f6dc0ef fix failing tests on windows (#420) 2013-06-23 15:13:36 -07:00
Jeff Williams
44d9ec6831 new parser infrastructure
consumes ASTs that follow the Mozilla Parser API spec:
https://developer.mozilla.org/en-US/docs/SpiderMonkey/Parser_API

passes all tests on OS X; performance is comparable to previous
version. also includes some miscellaneous cleanup.

remaining issues:
- only Rhino AST builder is supported
- node visitors (old and new) may not be hooked up yet
- circular-reference issues in doclets
- docs are (mostly) missing
- various other TODO comments
2013-06-23 10:18:13 -07:00
Louis-Dominique Dubeau
32d00c20ca Changes to allow target and text in {@link target text} to be separated by newlines and for text to contain newlines. 2013-06-21 10:03:26 -04:00
Jeff Williams
2090b8d2fe Merge pull request #422 from ErnstHaagsman/true-augments
@augments tag: Inherited members correctly identify their origin
2013-06-02 16:51:33 -07:00
Jeff Williams
11be32b325 fireProcessingComplete cleanup 2013-06-02 16:49:49 -07:00
Jeff Williams
0f79895be2 Merge pull request #421 from ErnstHaagsman/processingcomplete-event
Plugins: Created processingComplete event
2013-06-02 16:45:01 -07:00
Ernst Haagsman
93859fe94c processingComplete event: covered by unit tests
The processingComplete event now contains an object with the docs array under the 'doclets' key. The event is now covered by a unit test.
2013-05-15 11:18:03 +02:00
Ernst Haagsman
70109a2956 @default tag with object literals
Changed boolean 'doclet.defaultobject' to 'doclet.defaultvaluetype' field. Improved unit testing and fixed template.
2013-05-15 10:54:55 +02:00
Ernst Haagsman
8fb1e5318d @augments tag: Inherited members correctly identify their origin
'inherits' tag is only written if it is empty. Before this change
all members inherited from the direct parent, even if it actually
came from a grandparent.
2013-05-10 14:28:55 +02:00
Ernst Haagsman
9af5ea424e @default tag: added support for object literal defaults
Default object literals are now stored as a string. In the default
template they are shown with syntax highlighting.
2013-05-09 14:38:14 +02:00
Jeff Williams
8a6fe881e8 resolve relative paths before scanning/filtering (#405) 2013-05-02 22:00:21 -07:00
Jeff Williams
dbfdf946c1 remove stray log message 2013-04-29 09:15:50 -07:00
mathematicalcoffee
791181b65d fix #363 (I think) where tutorial tests fail on the second round of execution 2013-04-29 09:14:32 -07:00
Jeff Williams
992827ce58 don't parse inline tags as type expressions (#372) 2013-04-29 08:42:55 -07:00
Jeff Williams
398595d796 use inline tag module in templateHelper; allow inline tag replacers to operate on the entire string
the latter change undoes part of
9de918ab942c3d9a5c2883130d5b9b1a965b2bb2
2013-04-29 07:47:44 -07:00
Jeff Williams
9de918ab94 rework type extraction and inline tag parsing
- brace-counting logic now lives in the type code, which is where it's
needed
- we now replace (and return) ALL instances of an inline tag, not just
the first one
2013-04-28 22:03:48 -07:00
Jeff Williams
e887dadc82 refactor some tag-related code 2013-04-23 08:41:57 -07:00
Jeff Williams
070903fb88 link to individual line numbers in source files (#316) 2013-04-20 09:19:10 -07:00
Jeff Williams
655dfa0f5f fix test failures 2013-04-19 17:28:46 -07:00
Jeff Williams
8c65d81e23 match Node.js' console.log/error/info/warn/trace; speed up -X option (#298) 2013-04-18 23:16:47 -07:00
Jeff Williams
5b219ababb fix the name/scope of properties whose names include single quotes (#386) 2013-04-17 18:08:27 -07:00