Last time I checked, DOxygen beat all other documentation generators hands down. It had the documentation ready in 1/10 of the time the other programs needed (for a code base larger than NAnt). It does, however, look distinctly "doxygenic", which may be a show-stopper for some people. On the other hand, this output is fully skinable, it's just html after all.
On Wed, Mar 10, 2010 at 5:45 AM, Ryan Boggs <rmboggs.obsd.po...@gmail.com> wrote: > Hey guys, > > I've been poking around the internals of NAnt for the past few days > trying to understand why it's been taking between 1600-1700 seconds to > build on my Mono/Linux system. Which is why I sent that small patch > last week. It wasn't to fix the problem but to allow others who are > working on other aspects of NAnt a faster building time for them to > test while this gets sorted out. Anyway, during my tests, I noticed > that the hang up seems to occur during the "Generating Task > Documents.." phase of the NDoc task. I believe that this is around > line 254 of src/NDoc.Documenter.NAnt/NAntDocumenter.cs. The problem I > am having is that I can't seem to get any additional information to > print during this process. I've tried using simple Console.WriteLine > commands but that doesn't seem to work and the -v+/-debug+ command > line arguments don't print out additional information either. Can > anyone give me some additional pointers/advice of how I should proceed > next? I'm kinda stuck. > > On a side note, I think we all know that NDoc is showing its age. > I've seen a couple of discussions on what to replace it with but there > hasn't been any follow up. While I was looking into the issue above, > I started looking at the other options and noticed NDoc3. What caught > my eye with this is that not only does it continue where NDoc left off > but there is still activity on that project as recent as last month > and hopefully it continues. I know the importance of a documentation > program, which is why I am bringing this up, and between NDoc, NDoc3, > DOxygen, and Sandcastle, I would say that NAnt should shift to NDoc3 > in the near future (possibly between 1.0 and 2.0, maybe). What do > others think? > > -- > Thanks, > Ryan > > ------------------------------------------------------------------------------ > Download Intel® Parallel Studio Eval > Try the new software tools for yourself. Speed compiling, find bugs > proactively, and fine-tune applications for parallel performance. > See why Intel Parallel Studio got high marks during beta. > http://p.sf.net/sfu/intel-sw-dev > _______________________________________________ > nant-developers mailing list > nant-developers@lists.sourceforge.net > https://lists.sourceforge.net/lists/listinfo/nant-developers > ------------------------------------------------------------------------------ Download Intel® Parallel Studio Eval Try the new software tools for yourself. Speed compiling, find bugs proactively, and fine-tune applications for parallel performance. See why Intel Parallel Studio got high marks during beta. http://p.sf.net/sfu/intel-sw-dev _______________________________________________ nant-developers mailing list nant-developers@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/nant-developers
