Re: NAnt delay on Mono/Linux Update (Aka: NDoc Discussion)

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
<[email protected]> 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&#174; 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
> [email protected]
> https://lists.sourceforge.net/lists/listinfo/nant-developers
>

------------------------------------------------------------------------------
Download Intel&#174; 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