I'm not sure what the jQuery developers use this format for, but it is not javadoc, per se.
If you are looking for something to create documentation , I personally have used jsdoc-toolkit (http://code.google.com/p/jsdoc- toolkit/) which is a javadoc type api for JavaScript. There are a number of other similar type api's out there. On Mar 26, 5:53 am, alexanmtz <[EMAIL PROTECTED]> wrote: > Good point stephen, I note this too... > > Im develop a plugin and use javadoc and I create some fields that dont > fit in documentation, but was necessary to describe it... > > I think that the jQuery developers can answer this... > > On Mar 25, 5:34 pm, Stephen <[EMAIL PROTECTED]> wrote: > > > Hi, > > In many jQuery plug-ins and JS code using jQuery, I find comments at > > the top of the source code like this: > > > /** > > * SomeFunction - Some comments. > > * @requires jQuery v1.2 or above > > * @example > > * > > */ > > > This looks like Javadocs to me, but there are certain fields that > > don't seem to be in the Javadoc > > documentation:http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#tag > > > Fields like @example and @option are not in the Javadoc > > specifications, however. > > > Is there a URL that discusses how to write jQuery comments like these > > plug-in authors are doing? I attempted to find something on > > jquery.com, but I have not found anything or have been searching the > > wrong way. > > > Thank you for reading this. > > > --Stephen