Andreas Hocevar
f95e23deeb
Do not hide the first word of returns
2014-05-09 10:02:13 -05:00
Frederic Junod
1b6a317bf9
Lower case the event name
2014-05-08 17:12:29 +02:00
Andreas Hocevar
564d3cda12
Fix anchor offsets for line numbers
2014-05-07 15:01:48 -05:00
Andreas Hocevar
0d4c7dc1fc
Better match the ol3 color theme
2014-05-07 08:40:02 -05:00
Andreas Hocevar
c57e9dc047
Better readable color for type links
2014-05-06 14:12:38 -05:00
Andreas Hocevar
e2c9dd279d
Switch to the Jaguar theme
...
In addition to a nicer layout, this adds a searchable sidebar
and a source code viewer.
2014-05-06 12:46:59 -05:00
Andreas Hocevar
3f2f7e3603
Fix indentation
2014-05-06 12:45:53 -05:00
Andreas Hocevar
959e14c31a
Handle observables and fires augments in plugins
...
This makes it easier to switch themes.
2014-05-06 10:14:28 -05:00
Andreas Hocevar
c2a9e95a37
Make sure anchors are not obscured by the header
2014-05-05 12:40:48 -05:00
Andreas Hocevar
5f54b45fa2
Add readme note about observable properties
2014-05-05 09:52:32 -05:00
Andreas Hocevar
61b732b8f7
Make sure that parent classes are not marked undocumented
2014-05-05 09:40:28 -05:00
Andreas Hocevar
b1126c9373
Inline events and also list method events with the class
2014-05-05 09:35:33 -05:00
Andreas Hocevar
52444b1366
Inherit events
2014-05-04 18:29:18 -05:00
Andreas Hocevar
b444714c55
No longer need to remove dead links
...
There should be no dead links any more, now that we include
doclets for the whole inheritance chain of a class.
2014-05-04 18:28:19 -05:00
Andreas Hocevar
ea5df18c72
Remove unused require
2014-05-04 14:51:06 -05:00
Andreas Hocevar
8ee9f7cb6a
Simplify the way we annotate observable properties
...
We no longer add observable annotations to the constructor.
Instead, we just mark getters (and for read/write properties
also setters) with an observable annotation.
2014-05-03 16:04:25 -04:00
Andreas Hocevar
0f072c0ec1
List subclasses for each class
...
With this change, we no longer need to link to implementations
or subclasses manually.
2014-05-03 15:32:39 -04:00
Andreas Hocevar
db5b2e284a
Do not remove classes that other classes inherit from
2014-05-03 12:41:52 +02:00
Andreas Hocevar
6cea9a9d9a
Avoid dead links
...
Because we remove doclets that are not part of the API, there
are cases where linkto will create a link to an undocumented
doclet. We now replace such links with the longname of the
doclet.
2014-05-03 12:41:52 +02:00
Andreas Hocevar
5a13488b11
Stop adding ObjectEvent links manually
...
Now that the links are removed from event annotations, we no
longer need to do this, because inheritance works.
2014-05-02 12:06:48 +02:00
Andreas Hocevar
d6722ddc6f
Mark undocumented doclets as undocumented
...
To give other plugins access to doclets that are not part of
the API, we have to mark them undocumented instead of removing
them. They will be removed by JSDoc before publishing anyway.
2014-05-02 12:06:48 +02:00
Andreas Hocevar
e7e1ef7534
Show inherited observable properties
2014-05-01 22:17:57 +02:00
Andreas Hocevar
25dd0127e9
Recursively document subparams and span table columns
2014-05-01 22:17:57 +02:00
Andreas Hocevar
7271b50d5a
Simplify fires annotations
2014-05-01 22:17:56 +02:00
Andreas Hocevar
f22aac1e22
Only use the inheritdoc plugin once
2014-05-01 22:17:56 +02:00
Andreas Hocevar
fbdbbfb7a7
Get rid of stability annotations and document stability with api
...
This change adds a stability value to the api annotation, with
'experimental' as default value.
enum, typedef and event annotations are never exportable, but
api annotations are needed there to make them appear in the
docs.
Nested typedefs are no longer inlined recursively, because the
resulting tables get too wide with the current template.
2014-04-29 09:53:07 -06:00
Andreas Hocevar
29b643c7b0
Inline object literals from olx.js
2014-04-29 09:53:07 -06:00
Andreas Hocevar
c17ac0cae3
Greatly simplify and document the usage of JSDoc
...
This commit simplifies the exports.js plugin so it only relies
on the stability notes to generate the documentation, which
completely decouples it from the exportable API.
As a rule of thumb, whenever something has an 'api' annotation,
it should also have a 'stability' annotation. A more verbose
documentation of ol3 specific annotation usage is available in
the new 'apidoc/readme.md' file.
This commit also modifies all source files to implement these
usage suggestions.
2014-04-29 09:53:06 -06:00
Andreas Hocevar
aaf6101d0f
Include symbols from oli.js using interface and implements tags
...
Instead of regex parsing, we define tags for interface and
implements.
2014-04-29 09:53:06 -06:00
Andreas Hocevar
b758d92790
Use symbols.json for determining the API
...
Also to get rid of regular expression parsing, instead of
collecting exports for observables from the source files, we use
the 'observable' annotations.
2014-04-29 09:53:06 -06:00
Tim Schaub
1273c26f7a
Use new generate-exports.js task
2014-04-29 09:53:05 -06:00
Andreas Hocevar
04a33220a8
Parse olx.js and convert types into typedef properties
2014-04-08 11:41:24 -06:00
Paul Spencer
6d3bbe61ce
Upgrade to jsdoc 3.3.
2014-04-08 07:39:57 -04:00
ahocevar
d4eb5dd2ee
Use a more visually appealing margin for descriptions
2014-03-27 13:00:08 +01:00
ahocevar
a5d8f463ff
Clean up
...
Only mark symbol as unexported when it is not in the API, and
no longer extract links from fires annotations because all links
are handled now.
2014-03-27 12:37:01 +01:00
ahocevar
15b0bc719e
Do not loop through parents
...
Now that we use the parseComplete event, we walk through all
doclets in the loop anyway.
2014-03-27 01:56:31 +01:00
ahocevar
a1d9491d62
Do not delete event and fires doclets
2014-03-27 01:18:59 +01:00
ahocevar
cc1fceab05
Do not query the array twice
2014-03-26 23:46:42 +01:00
ahocevar
e5edb5c0e3
Also consider linked symbols as documented
2014-03-26 18:33:15 +01:00
ahocevar
f129a68248
Only add symbols to the unexported array once
...
This basically fixes a typo that caused unexported symbols to
be added to the unexported array multiple times.
2014-03-26 18:32:36 +01:00
ahocevar
118d9c200a
Remove undocumented symbols at the end of the parsing process
...
This ensures that we do not mark symbols as undocumented before
all potential dependencies are parsed.
2014-03-26 18:31:31 +01:00
ahocevar
a3b5376520
Add missing event documentation and stability tags
2014-03-26 14:04:58 +01:00
ahocevar
4fad17b213
Make clearer what the 'Event' for observable properties means
2014-03-25 18:24:37 +01:00
ahocevar
7a9353cc87
Document classes and properties from externs/oli.js
2014-03-25 18:24:09 +01:00
ahocevar
d0ac615bef
Distinct unexported and undocumented symbols
2014-03-25 18:23:05 +01:00
ahocevar
026c7149c8
Fix @override documentation
2014-03-25 18:21:55 +01:00
ahocevar
7e850ca33d
Use JSDoc's stock event documentation
2014-03-25 18:21:08 +01:00
ahocevar
50f8eb65fd
Add capabilities to document events
2014-03-24 21:53:18 +01:00
Marc Jansen
32524d186a
Add explicit includes/excludes to jsdoc config.
2014-03-06 16:06:51 +01:00
Bart van den Eijnden
304e7c7df7
Add properties found in objectliterals.jsdoc to the API
2014-02-11 14:49:04 +01:00
