I was wondering if it was possible to generate a documentation that looks like Jack's documentation center -with or without JSBuilder-.

Thanks,

Dams

21 Dec 2006, 7:56 AM

tryanDLS

If you mean documentation for JSBuilder, that would be no. It looks like the code was ported from something into C# and there are virtually no comments.

If the code was commented in the standard .Net/C# format, it could be used to generate nice HTML doc via something like NsDoc. However, since there's talk about migrating this to something else (Swing, maybe??), it's probably not going to happen short-term. Even if it's not migrated, I don't know that anybody is going to go thru and document the current codebase.

22 Dec 2006, 12:19 AM

Dams

Ok, thank you for replying,

JSDoc will do.

Dams

22 Dec 2006, 8:50 PM

brian.moeskau

Re: Documentation center.

Quote:

Originally Posted by Dams

I was wondering if it was possible to generate a documentation that looks like Jack's documentation center -with or without JSBuilder-.

I think the question was regarding generating doco with the same styles/formatting as Jack's new doc center. The answer currently is no. Jack wrote a custom PHP-based parser to output his docs that is separate from JSB and currently not public. However, we have discussed possibly rolling that into JSB in a future release. Nothing has been decided for sure yet though.

Quote:

Originally Posted by tryanDLS

It looks like the code was ported from something into C# and there are virtually no comments.
If the code was commented in the standard .Net/C# format, it could be used to generate nice HTML doc via something like NsDoc.

Just to clarify, it was not ported -- it was originally written by Jack. But... it started out as a "quick and dirty" solution to a problem that Jack had that slowly grew into a larger project. Initially, I don't think Jack even thought about sharing the source until people started asking for it, hence no thought about internal documentation. If the tool continues to move forward and become more popular, then reworking it / porting it / documenting it will probably happen at some point.

24 Jun 2008, 5:15 AM

durlabh

Hi! Is it possible to get the doc parser? I have a few growing classes for which I would like to follow the documentation style of Ext!

25 Jun 2008, 5:20 PM

Zakaroonikov

Quote:

Originally Posted by durlabh

Hi! Is it possible to get the doc parser? I have a few growing classes for which I would like to follow the documentation style of Ext!