RE: [Jsdoc-user] some questions regarding jsdoc
Status: Inactive
Brought to you by:
mmathews
From: <tob...@or...> - 2005-11-18 09:42:12
|
hi gabriel > a long story short: hopefully I'll release in the next day or two (or > maybe even in the next hour or two). =20 good news! looking forward to the release, but no hurries. > I suppose the main thing I'm not sure about is if this should just > become default behaviour or not. If it does just become default > behaviour, there's definitely a lot of potential for it to be a real > annoyance to existing users, so it might be introduced as a > command-line option, or global variables that are to be documented > could have to be marked with a @global tag or something like that. > Any other suggestions? =20 i consider a command-line option the best solution but i would be fine = with the @global tag as well. you know your established user community = best; thus, you will make the right decision to avoid breaking something = for them anyway. =20 > Yes, this is another one of those things that is really difficult (or > impossible) to get right to satisfy everyone. The far-away plan for > JSDoc is to rewrite it in Java using Rhino, and then just let Rhino > decide what's what instead of me trying to fish it out with regular > expressions :) =20 well, we are working with java *and* rhino and as i already said we = really need a good and meaningful javascript documentation feature. = (certainly, a java version of jsdoc would be much more valuable for us = than the perl one -- no matter how excellent it already is.) do you = think we could join our forces here? btw. i found some more issues; do you want me to report them as bugs = immediately or is it ok if i post them here again? ciao, tobi |