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