How about Natural Docs? http://naturaldocs.org/
MooTools seems to use it and their documentation looks great. It would require rewriting the existing tags but I'd be happy to volunteer for that if you'd like. Regards, Glen Stampoultzis On 17/06/07, Christopher Schmidt <[EMAIL PROTECTED]> wrote:
I finally got fed up with JSDoc today. It's now segfaulting even with the lower recursion depth on the regexes, which means that the only way to get anything out of it is to set it up so we get practically nothing out of it. So, I sat down and wrote out something that replaces a significant chunk of the jsdoc functionality we were using. The code right now is super-crappy, but it seems like our code is well structured enough that this isn't going to be a horribly hard task. You can see the current output at: http://crschmidt.net/~crschmidt/out/ Some examples: http://crschmidt.net/~crschmidt/out/OpenLayers/Map.html#theme http://crschmidt.net/~crschmidt/out/OpenLayers/Layer.html#getViewPortPxFromLonLat etc. Note that changing to this solution is no longer an option of 'if', but 'when'. Despite lots of time and effort put into babying jsdoc, we have simply grown past a point where it is viable, and huge chunks of our documentation simply aren't covered by the jsdoc parser. If someone wants to hack on jsdoc to try to fix these issues, they can feel free, but I'm not hopeful that we'll get a resolution of this that way, which is why I'm pursuing the new solution, which I at least understand the *reasons* it breaks, when it does. Regards, -- Christopher Schmidt MetaCarta _______________________________________________ Dev mailing list [email protected] http://openlayers.org/mailman/listinfo/dev
_______________________________________________ Dev mailing list [email protected] http://openlayers.org/mailman/listinfo/dev
