Re: [Jsdoc-user] JSDoc 1.9.7 Constants

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

On Wed, Dec 21, 2005 at 06:09:27PM +0000, Max d'Ayala wrote:
> Hello Gabriel.
> 
> Looking at the latest 1.9.7 version I noticed the following minor error 
> with stylesheet.css:
> ...
> the font-size should be "pt" rather than "pts".

Just fixed it in my CVS repository, and it'll be in the next release.
Thanks for pointing that out!

> 
> Looking at Constant value I have a couple of questions.
> 
> 1. It would be nice if there was a link in the bottom left window 
> showing "All Classes" to the "Constant Field Values" page.
> At the moment the only way I can find of getting there is to find a 
> constant value and then click on the link to the page.
> 
> 
> 2. When prototype properties are flagged as "@final" they don't show up 
> on the Constant Field Values page.
> 
> Here is an example.
> 
> function MyObject() {
>  // Constructor function.
> }
> 
> /**
> Constant prototype number, value = 10.
> This doesn't get documented on the Constants page,
> although the Field Details do have a link to the Constant Field Values 
> page.
> 
> @final
> */
> MyObject.prototype.constant_prototype_number = 10;
> 
> /**
> Constant number, value = 20.
> This gets documented in the Constant Field Values page.
> 
> @final
> */
> MyObject.constant_number = 20;
> 

Both of these points are the result of JSDoc trying to follow the
example of javadoc. However, they both seem reasonable, so if nobody has
any objections to them, it shouldn't be a problem to add them. Could you
please add them to the request tracker on sourceforge? That way I can be
sure I won't forget about it. You may notice that there are already
quite a few requests waiting to be dealt with there, but I'm hoping to
make some decent progress over Christmas.

Regards,
    Gabriel