PDA

View Full Version : JsDoc Toolkit with JSBuilder



arthurakay
17 Apr 2009, 2:29 PM
I apologize if this has already been asked... I tried searching and didn't see an answer.

At the conference, Jamie gave a presentation on "Application Deployment" which talked about JSBuilder. I thought it was awesome, and decided to give it a try.

I've been using the JSDoc-Toolkit to generate my docs locally. I see that JSBuilder uses JSDoc (the original Perl scripts) and I'm curious if there are any plans to implement the newer JSDoc Toolkit into the build process.

In the meantime, am I going to run into any problems with my documentation by installing the original JSDoc?

Condor
18 Apr 2009, 2:24 AM
I use SVN builder, so I can't help you with this, but is there any reason you are not using ext-doc (http://code.google.com/p/ext-doc/)?

mjlecomte
18 Apr 2009, 5:13 AM
I use SVN builder, so I can't help you with this, but is there any reason you are not using ext-doc (http://code.google.com/p/ext-doc/)?

Wasn't at the conference so disadvantaged for context, but the Ext 3 docs were built using the above link.

arthurakay
20 Apr 2009, 5:36 AM
Condor - honestly, the only reason I chose not to use JSDoc was that it was written with Perl. I have knee-jerk reactions to anything built in Perl (I've had several bad experiences...), so I went with the Java-based JSDoc Toolkit.

My understanding was that JSDoc Toolkit was basically the same thing, just written in Java and updated more often through their Google Code group. I think the documentation syntax is the same.

I have no problems giving JSDoc a chance, particularly since JSBuilder makes use of it. I was just curious.

arthurakay
20 Apr 2009, 5:37 AM
And no, I have no reason why I'm not using Ext-doc. I'm planning on looking into that :D