[Insight-developers] itkMath doxygen missing?

[Matt McCormick]

Results: it took 5 hours to build.

There results look OK, except the inheritance diagram and
collaboration diagram tabs don't work.  I looked at the source, and it
appears the generated html tries to use JQuery without including
jquery.js.  So, I will turn off HTML_DYNAMIC_SECTIONS and see how it
looks.

Also, I am going to turn off COLLABORATION_GRAPH, but it will eat up
screen space, I don't think it is that useful, and we can reduce build
times.

Matt

On Sat, Jun 16, 2012 at 5:34 PM, Matt McCormick
<matt.mccormick at kitware.com> wrote:
> Hi Arnaud,
>
> Thanks for the tip.  I have installed gnuplot and verified that dot is
> present.  I ran doxygen -u on Utilities/Doxygen/doxygen.config.in and
> I am currently running an Experimental build.
>
> Thanks,
> Matt
>
> On Fri, Jun 15, 2012 at 9:58 AM, Arnaud Gelas <arnaudgelas at gmail.com> wrote:
>> Matt,
>>
>> In your submission, I found this:
>>
>>        -- Could NOT find Gnuplot (missing:  GNUPLOT_EXECUTABLE)
>>
>> Could you please install gnuplot (although it is not used when generating
>> the documentation), can you also make sure dot is installed on your machine?
>>
>> Thanks
>> Arnaud
>>
>>
>> On 06/15/2012 03:49 PM, Matt McCormick wrote:
>>>
>>> On Fri, Jun 15, 2012 at 8:24 AM, Bradley Lowekamp
>>> <blowekamp at mail.nih.gov>  wrote:
>>>>
>>>> Matt!
>>>>
>>>> Your system is reporting a build time of only 2 hours and 24 minuets!
>>>> That
>>>> must be some improvement to doxygen!
>>>>
>>>> http://open.cdash.org/buildSummary.php?buildid=2362979
>>>
>>> Fantastic!  It looks OK, but there is a problem with the inheritance
>>> diagrams.  Perhaps dot is not being executed correctly.  I will follow
>>> Arnaud's 'doxygen -u' suggestion...
>>>
>>> Thanks,
>>> Matt
>>>
>>>
>>>> I guess it should be checked to see if it actually produced the doxyen
>>>> html
>>>> before we celebrate a break through is doxyen performance...
>>>>
>>>> Brad
>>>>
>>>> On Jun 15, 2012, at 2:34 AM, Arnaud Gelas wrote:
>>>>
>>>> Brad,
>>>>
>>>> AFAIK doxygen is a single threaded process; however the generation of
>>>> graphs is multithreaded (dot instances are created in parallel). With
>>>> the current doxygen configuration file, all threads are meant to be used
>>>> in this process (which occurs towards the end of the html generation).
>>>>
>>>> Note that having more CPUs significantly reduced the documentation
>>>> generation. Also, I am not sure if there any speed improvement in the
>>>> latest doxygen version (?)
>>>>
>>>> ---
>>>>
>>>> Matt,
>>>>
>>>> After upgrading doxygen, you should also upgrade the configuration file
>>>> to take full benefit from new features (and potential enhancement); else
>>>> default values are used.
>>>>
>>>> You only to run
>>>>
>>>>     doxygen -u<config_file>
>>>>
>>>>     see http://www.stack.nl/~dimitri/doxygen/doxygen_usage.html
>>>>
>>>> Each parameters are well documented in the configuration file, but you
>>>> can also have a look at the following page:
>>>>
>>>>     http://www.stack.nl/~dimitri/doxygen/config.html
>>>>
>>>> Finally, once you upgrade the configuration file, feel free to add me as
>>>> reviewer when you submit the patch on gerrit.
>>>>
>>>> Cheers,
>>>> Arnaud
>>>>
>>>>
>>>> ========================================================
>>>>
>>>> Bradley Lowekamp
>>>>
>>>> Medical Science and Computing for
>>>>
>>>> Office of High Performance Computing and Communications
>>>>
>>>> National Library of Medicine
>>>>
>>>> blowekamp at mail.nih.gov
>>>>
>>>>
>>>>
>>>>
>>