[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index] [List Home]
[wtp-dev] JSDoc limitations

After some advice here I tried to get object-literal type declarations to outline more specific and offer code-complete using JSdoc, but Eclipse seems to be deaf for anything except the @memberOf tag.

1st, with

var foo = {
    bar : 24
};

you get a variable outlined.

With

/** @public @static @class someclass */
var foo = {
    bar : 24
};

you still get a variable.

With

var foo = {
    /** @memberOf foo */
    bar : 24
};

THEN you get a function/type.

Is WTP's JsDoc ignoring previous tags?

2nd, more importantly, expanding externally existing objects (e.g. baz) (because frameworks like nodejs or extjs provide them and they are pretty much where all your code is, so without @memberOf nothing at all will be outlined) like so:

baz.foo = {
    bar : 24
};

only works when manually adding /** @memberOf baz.foo */ otherwise it will not be outlined at all.
(I think this should work automatically.)

and 3rd, strangely, after using @memberOf to outline the parent, the parent (baz.foo) will become available in other _javascript_ files within the same project, but the parent's childs (baz.foo.bar) do not. Can these also be externally exported through JSdoc tags?

~Redsandro