539 Commits

Author SHA1 Message Date
Dasa Paddock
36717281ac Add support for a markdown.hardwrap config property 2015-03-25 16:54:34 -07:00
Jeff Williams
da14fedb69 replace all occurrences of an inline tag, not just some (#936, #957) 2015-03-18 17:52:31 -07:00
Jeff Williams
4b8504cac9 support ES 2015 classes (#555, #769)
Incorporates work by @eventualbuddha.
2015-03-18 17:14:04 -07:00
Jeff Williams
0b41c89f83 don't try to parse HTML tags as type expressions (hegemonic/jsdoc-baseline#149) 2015-03-15 17:12:14 -07:00
Jeff Williams
67244c06eb quote unsafe property names (#950)
Fixes a regression introduced by the parser overhaul in 44d9ec6831e498bd082de98a5bc60abfdba2bb7f.
2015-03-13 16:56:32 -07:00
Jeff Williams
7ca432d587 allow symbol names that contain whitespace to be borrowed (#818) 2015-03-10 17:37:48 -07:00
Jeff Williams
be77aa4344 handle enums with numeric keys (#946) 2015-03-09 17:28:12 -07:00
Larry Davis
5ed70331fc handle numeric object keys correctly (#945) 2015-03-09 16:18:44 -07:00
Jeff Williams
3f1ecac83a never make AST nodes enumerable 2015-03-06 08:35:09 -08:00
Jeff Williams
4713925d78 correctly infer when the class tag contains a class description (#935)
Fixes a regression caused by f1354563965792b8dd183f5a5331f8fcc67ea319.
2015-03-05 15:08:22 -08:00
Jeff Williams
878115e1c1 autodetect string, boolean, and numeric default values of parameters (#555)
We ignore other types based on these assumptions:

1) It doesn't make sense to show variable identifiers, which may refer to (for example) module-private values that should not be documented.
2) If we tried to capture objects and arrays, we would have to iterate over them to see if they contain any variable identifiers, which would be a pain (and potentially confusing: "Why do some objects appear in the docs but not others?")
3) Most developers will not define complex default values in a function definition.
4) In many cases, object and array default values will be `{}` and `[]`, respectively, and usually those don't merit documentation.
2015-03-03 17:22:30 -08:00
Jeff Williams
1c754e98f2 fix build breakage on Rhino parser 2015-02-27 16:08:55 -08:00
Jeff Williams
96c8f6994d handle ES 2015 rest parameters (#555)
As part of this commit, we automatically flag rest parameters as repeatable, even if the JSDoc comment doesn't identify the parameter as repeatable. As a result, it's difficult to document a rest parameter as though it were a normal parameter (should you want to do that for some reason). I may revert this piece if it generates complaints.
2015-02-27 14:39:20 -08:00
Jeff Williams
a243719fb2 cleanup 2015-02-26 16:05:22 -08:00
Jeff Williams
cc4ffc762e update Espree and LICENSE file 2015-02-26 14:59:05 -08:00
Jeff Williams
65f307322a resolve this correctly in chained class declarations within modules (#894) 2015-02-23 16:58:33 -08:00
Jeff Williams
fe04fa18f9 change ID for pure JS parser to 'js'; remove half-baked ability to use arbitrary parsers; test coverage 2015-02-23 09:14:42 -08:00
Jeff Williams
8ea7078d39 modify dumper.dump() to support multiple arguments; only define the dump() global in debug mode (#812) 2015-02-18 17:24:02 -08:00
Jeff Williams
f9073e6361 turn app global into a module, and use the module instead of the global (#812)
The `app` global remains available, since templates and plugins may rely upon it, but it's deprecated as of JSDoc 3.4.0.
2015-02-18 09:27:40 -08:00
Jeff Williams
ae94af0cd8 turn env global into a module, and use the module instead of the global (#812)
The `env` global remains available, since templates and plugins may rely upon it, but it's deprecated as of JSDoc 3.4.0.
2015-02-17 19:07:10 -08:00
Jeff Williams
ea773af2ed allow Visitor instances to be created before Parser instances (#923) 2015-02-17 16:00:26 -08:00
Jeff Williams
ea1932e4fc prevent crash on non-string default values (#914) 2015-02-08 12:54:49 -08:00
Jeff Williams
f92245794b correctly handle classes that implement interfaces that extend other interfaces (#909)
The fix for this issue also introduces a regression; see jsdoc3/jsdoc#911.
2015-02-06 08:49:04 -08:00
Jeff Williams
8d896db809 process implements tags before augments tags (#906) 2015-02-05 08:25:24 -08:00
Jeff Williams
028c65c037 in param/property names, cast default values that appear to be boolean/numeric (#900) 2015-02-02 16:24:17 -08:00
Jeff Williams
fdd7b31f94 don't convert boolean/number default values to strings (#900) 2015-02-01 13:35:37 -08:00
Jeff Williams
62f563d730 automatically treat const declarations as constants (#555) 2015-01-30 07:58:36 -08:00
Jeff Williams
80bce1db42 allow interfaces to augment other interfaces (#897) 2015-01-29 16:10:47 -08:00
Jeff Williams
930cc2c473 remove incorrect spec 2015-01-29 16:04:09 -08:00
Jeff Williams
04559dbe7d switch from Esprima to Espree (#555) 2015-01-27 08:53:11 -08:00
Jeff Williams
e0ec38047b correctly augment the inheritors of virtual doclets (#893) 2015-01-26 16:25:47 -08:00
Jeff Williams
8ad4b49b3f correctly handle symbols named prototype (#891) 2015-01-24 09:09:31 -08:00
Jeff Williams
17c58d76e5 clean up fixtures; add some missing tests 2015-01-24 08:50:09 -08:00
Jeff Williams
e89ecd615f resolve this for computed properties (#890) 2015-01-24 08:40:55 -08:00
Jeff Williams
c61b9307b4 set the correct longname on prototype members whose names are quoted (#888) 2015-01-24 07:40:47 -08:00
Jeff Williams
d231bc36d8 add normalize as a synonym for normalise (#884) 2015-01-21 08:43:59 -08:00
Jeff Williams
3663224f2b make implementations inherit the docs from interfaces where appropriate (#864) 2015-01-20 08:10:33 -08:00
Jeff Williams
c6528bb090 treat memberof info like alias info when tracking variables (#880)
This change allows you to say, for example, that a symbol is a `memberof` a module, and the children of that symbol will automatically inherit the `memberof` info. (Previously this only worked if the symbol and its properties were defined in the module file.)
2015-01-19 09:39:53 -08:00
Jeff Williams
db9a570e2d add fast path to hasAncestor 2015-01-16 09:02:13 -08:00
Jeff Williams
5b4e2c51f7 add hasAncestor helper function 2015-01-16 08:49:54 -08:00
Jeff Williams
fb2c36781f update ESLint; delint 2015-01-11 19:17:44 -08:00
Jeff Williams
dad0544e93 show tutorials in the TOC nav (#875) 2015-01-11 18:30:08 -08:00
Jeff Williams
322afeb86e support --access all flag to display symbols at all access levels (#861) 2015-01-04 14:10:28 -08:00
Jeff Williams
d43990f6e4 Merge pull request #860 from Raptor399/accessparam-squashed
Adding access parameter
2015-01-02 09:57:35 -08:00
Patrick Atoon
ba510377da Adding access parameter 2015-01-02 13:01:29 +01:00
Jeff Williams
e471a1f55e add stripNamespace and stripVariation methods (#858) 2014-12-30 16:57:11 -08:00
Jeff Williams
60b239fd33 keep the link text for longnames with variations (#857) 2014-12-30 16:40:03 -08:00
Jeff Williams
7e23a68c59 multiple fixes for overridden symbols (#855)
- Don't add an "overrides" property to members that are merely inherited.
- In the template, don't show both "overrides" and "inherited from" for the same member.
2014-12-29 15:48:05 -08:00
Jeff Williams
6faad35eb5 strip enclosing parens from the variation tag's value (#850) 2014-12-25 17:16:59 -08:00
Jeff Williams
39e5008cfc implement inheritdoc and override tags (#53) 2014-12-22 10:35:52 -08:00