Re: [Jsdoc-user] A few questions

[Gabriel R. <gab...@gm...>]

 
> 1. There appears to be a minor bug if you include a single quote 
> (apostrophe) in inline comments using a double slash.
> E.g. a line such as;
>    myFunction();  //This is today's test code.
> 
> When I look at the "File" page the source code highlighting breaks at 
> the single quote. (I think it starts again if you hit another single 
> quote in another inline comment.)
> 

I've just noticed a bug that seems to occur when inline comments are
included on the same line as code. Could you either send me (or the
list) a complete (but preferably small) JavaScript source file that
demonstraes this? I'll plan to release a fixed version this weekend.

> 
> 2. Are the * characters optional at the start of lines within the 
> special comment blocks?

Yes, they are. 

> 
> 3. I seem to be having problems with Mozilla style getters and setters 
> not being documented.
> 
> E.g.
> 
> Element.prototype.__defineGetter__(
>    "getSomething",
>    function()
>    {
>        var temp = this.aproperty;
>        return temp;
>    }
> );
> 

This is *supposed* to work, but having just checked it as well, I've
seen that it doesn't work anymore. I'll have this fixed as well in the
release this weekend.

Thanks for pointing these bugs out!

Regards,

    Gabriel