Hi Yvan,
> I am new to JSDoc and I have tried to generate documentation using JSDoc,
> unfortunately I didn't succeed. JSDoc said that there is nothing to
> document.
>
> Did I made some syntax error in JSDoc, I am using prototypejs to generate my
> classes, is it incompatible with JSDoc ? Is there somewhere where I can get
> a correct sample to start with ?
Thanks for your excellent description of the problem. The issue here
is that JSDoc doesn't support the code as it's written (using
prototype.js). JSDoc was originally written to deal more with the "old
school" assignment of functions to other function prototypes.
The good news is that I believe that the newer incarnation of JSDoc
(JsDoc Toolkit, at http://jsdoc.info), does support more dynamic
constructs like the ones in your code. I suggest you check it out, as
it will most likely solve the problems you're encountering with JSDoc.
Regards,
Gabriel
|
