[Insight-developers] itkMath doxygen missing?

[Matt McCormick]

Those changes made the page usable, but I have reverted them after
finding the following message in the Doxygen changelog:

Note: If you use a custom header for the HTML output (HTML_HEADER)
make sure you add the following:

<script type="text/javascript" src="$relpath$jquery.js"></script>
<script type="text/javascript" src="$relpath$dynsections.js"></script>
Otherwise the interactivity of the trees does not work.

http://www.stack.nl/~dimitri/doxygen/changelog.html

A new Experimental build is coming, but here are the changes:

  http://review.source.kitware.com/#/c/6233/

Thanks,
Matt

On Sat, Jun 16, 2012 at 11:36 PM, Matt McCormick
<matt.mccormick at kitware.com> wrote:
> 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
>>>>>
>>>>>
>>>>>
>>>>>
>>>