Thread: [Jsdoc-user] RECURSION in JSDoc.pm
Status: Inactive
Brought to you by:
mmathews
From: Marcel R. <mr...@ma...> - 2007-10-27 11:46:38
|
Hi, again the recursion issue ... 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? Thanks a lot, Marcel -- http://watchee.net |
From: Gabriel R. <gab...@gm...> - 2007-10-28 07:30:27
|
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 |
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 |
From: Michael M. <mi...@gm...> - 2007-10-28 15:40:36
|
Hello Marcel, On 28 Oct 2007, at 1:06, Marcel Ruff wrote: > Hi Gabriel, > > the JSDoc-Toolkit - Cool work! > Muchos thanksos. > 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? Not sure this is on the todo list yet, you may be the first to request it. If you want you can add it here: http://code.google.com/p/jsdoc-toolkit/issues/list > o @link is planned for v1.4 - when is this scheduled? There is no time/date set to that, as this is an all-volunteer operation, and unless someone volunteers a patch it depends on my availability to donate the work. I would guess it will happen within the next month though. > > o Has somebody a javadoc look and feel template available? > Use the "sunny" template. See http://www.jsdoctoolkit.org/docs/sunny/ for an example. > Thanks for the nice tool, Please note that JsDoc Toolkit is *not* a straight port of the perl based JSDoc.pm tool, and there hasn't even been much effort to keep it backwards compatible -- I'm not opposed to backwards compatibility of course, I just don't have the time to devote to that work while my first priority is a tool that does what the JsDoc Toolkit user group asks. You're welcome to join in the discussion though and any requests, suggestions, or patches will certainly be welcomed. Stop by http://groups.google.com/group/jsdoc-2 Regards, Michael Mathews |