Re: [Jsdoc-user] RECURSION in JSDoc.pm
Status: Inactive
Brought to you by:
mmathews
From: Marcel R. <mr...@ma...> - 2007-10-28 13:07:33
|
Gabriel Reid wrote: > 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. > Hi Gabriel, the JSDoc-Toolkit - Cool work! It runs fine here but i have some questions about the links (cross-referencing): o Used parameter classes are no links which can be followed by a click, e.g. MySomething getSomething(Something2 something2); In the perl variant i can click on MySomething or Something2 to go to this Class. Is this a TODO feature or is it my configuration failure? o @link is planned for v1.4 - when is this scheduled? o Has somebody a javadoc look and feel template available? Thanks for the nice tool, regards, Marcel > Regards, > > Gabriel > > -- Marcel Ruff http://www.xmlBlaster.org |