[OpenLayers-Dev] finally fed up with jsdoc

[Cameron Shorter]

Nice,
I assume you plan to feed your hacks back into the jsdoc codebase?

I'm hoping we can use the same tool to jsdoc mapbuilder, which includes 
openlayers code.

Christopher Schmidt 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,
>   


-- 
Cameron Shorter
Systems Architect, http://lisasoft.com.au
Tel: +61 (0)2 8570 5050
Mob: +61 (0)419 142 254