Comments (3)
There are some fundamental technical problems with this feature. Java enforces
the
rule that any subclass can only have a single superclass, but in JavaScript
there is
no such enforcement. In fact there is no such thing as a superclass at all,
because
inheritance is based prototypes. It is possible that a constructor's prototype
could
be a combination of several other objects. This would be documented like so:
/**
* @name Ant
* @extends Insect
* @extends Hexapod
* @extends Pest
*/
So to create a tree such as you are requesting I must devise a rule for how to
deal
with arbitrarily many superclasses. I don't see how that is possible.
Insect Hexapod Pest
| | |
| | +-+
| +---------+
+----------------+- Ant
Now consider if every one of those superclasses has many superclasses (and so
on).
The alternative is to invent an arbitrary rule that you can only ever have one
@extends tag, or that secondary @extends tags will be ignored, but that seems
worse
than having no tree diagram at all.
I'm willing to listen to suggested solutions, but until then I think this
feature is
more problematic than helpful.
Original comment by micmath
on 8 Sep 2007 at 9:22
- Changed state: MoreInfoRequired
- Added labels: Priority-Low, Type-Enhancement
- Removed labels: Priority-Medium, Type-Defect
from jsdoc-toolkit.
Cleaning up: This issue will be deleted without more information.
Original comment by micmath
on 9 Oct 2007 at 6:23
from jsdoc-toolkit.
Original comment by micmath
on 15 Oct 2007 at 9:40
- Changed state: WontFix
from jsdoc-toolkit.
Related Issues (20)
- @exports does not export to another symbol's prototype properly HOT 3
- Assignment of a function to a prior declared variable incorrectly considered global HOT 2
- Aliased items are replaced with the first matching exported variable, even if it is not a full match. HOT 1
- Missing semi-colons in TokenReader prevent use of rhino 1.7R3 HOT 1
- Missing semicolon in TokenReader.js, line 17 HOT 1
- Private variables in anonymous function declared as constructor not exported
- Special characters in type expressions are not escaped properly in HTML output
- publishSrcHilite
- Better app/frame/Link.js
- Multiline comment may break the generated doc if it starts with a slash HOT 1
- Notice on front page makes it look like this project is dead. HOT 1
- support: best way to document input objects HOT 1
- removed extra pasted text
- Spelling correction
- Patch for /wiki/TagThrows.wiki
- Getting Started/Introduction missing
- File Index and _global_
- page https://code.google.com/p/jsdoc-toolkit/wiki/TagType does not contain type's descriptions
- can't find way to document code with closure
- uninitialized field documnetation not shown in output
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from jsdoc-toolkit.