Re: [Jsdoc-user] RECURSION in JSDoc.pm

[Gabriel R. <gab...@gm...>]

Hi Marcel,

> I'm using the current JSDoc-1.10.2 and
> the current perl v5.8.8 built for i586-linux-thread-multi.
>
> If i use RECURSION=2 JSDoc works fine
> but for any value > 2 it fails.
>
> Is there any work around / patch ... i can try to get
> JSDoc running with my Javascript?
> Does it really help if i build the perl 5.8.8 from source
> myself as stated in the FAQ?

The only workaround that I've encountered that works (sometimes) is a
new build of perl. There are of course no guarantees that a new build
will help, but having a more "basic" build seems to generally improve
the situation. In the end, this is a bug in perl itself (perl should
*never* segfault on something that is written in pure perl), so the
options are pretty limited.

Something else you may want to check out is the JsDoc Toolkit
(www.jsdoc.info), which is a newer JavaScript documenting framework
with much better support for dynamic JavaScript and no problems like
this segfault one.

Regards,

Gabriel