[Insight-developers] Has anyone generate Doxygen documentation on Mac OS X?

[Luis Ibanez]

Cory,

Yes, our two flags:

BUILD_DOXYGEN
BUILD_DOCUMENTATION


are indeed redundant.


Thanks for working on a patch to consolidate them.


     Luis


---------------------------------
On Tue, Mar 29, 2011 at 12:04 PM, Cory Quammen <cquammen at cs.unc.edu> wrote:
> Luis,
>
> Thanks for your response. It set me on the path to figure out what was
> really going on.
>
> It turns out I had BUILD_DOXYGEN set to ON but failed to enable
> BUILD_DOCUMENTATION.
>
> If BUILD_DOCUMENTATION is not ON, then FIND_PACKAGE(Perl) is never
> called and thus PERL_EXECUTABLE is not set. Hence, my problem.
>
> The need to set both BUILD_DOXYGEN and BUILD_DOCUMENTATION seems
> redundant to me. VTK has only the BUILD_DOCUMENTATION option, and if
> that is enabled, the Doxygen settings are included. This seems much
> nicer to me and would be good to have in ITK.
>
> I'll work on a patch to submit to gerrit that brings ITK's
> documentation generation CMake options more in line with that of VTK.
>
> Thanks,
> Cory
>
> On Tue, Mar 29, 2011 at 10:19 AM, Luis Ibanez <luis.ibanez at kitware.com> wrote:
>> Hi Cory,
>>
>> I haven't run Doxygen in a Mac, but recall that a similar
>> problem happens in Windows.
>>
>> The solution is to set the PERL_EXECUTABLE flag
>> in CMake when you configure ITK.
>>
>>
>> For example, in my Linux build, it gets set to:
>>
>>     PERL_EXECUTABLE:FILEPATH=/usr/bin/perl
>>
>>
>>  Hope that helps,
>>
>>
>>     Luis
>>
>>
>> ---------------------------------------------
>> On Mon, Mar 28, 2011 at 11:41 AM, Cory Quammen <cquammen at cs.unc.edu> wrote:
>>> I had some trouble getting Doxygen to generate ITK documentation on
>>> Mac OS X and wonder if any else has run into the same problem.
>>>
>>> In
>>>
>>> Utilities/Doxygen/itkdoxygen.pl
>>>
>>> I had to add
>>>
>>> #!/usr/bin/perl
>>>
>>> as the first line, otherwise my bash shell attempts to interpret the
>>> Perl script and fails.
>>>
>>> How does this work on other systems? Do some shells look at the file
>>> extension to decide which interpreter to use?
>>>
>>> I'm using the latest ITK v4 code in the repository, Doxygen 1.6.2, and
>>> Perl 5.10.0 on Mac OS X 10.6.6.
>>>
>>> Thanks,
>>> Cory
>>>
>>> --
>>> Cory Quammen
>>> Computer Integrated Systems for Microscopy and Manipulation (CISMM)
>>> Department of Computer Science
>>> University of North Carolina at Chapel Hill
>>> http://www.cs.unc.edu/~cquammen
>>> _______________________________________________
>>> Powered by www.kitware.com
>>>
>>> Visit other Kitware open-source projects at
>>> http://www.kitware.com/opensource/opensource.html
>>>
>>> Kitware offers ITK Training Courses, for more information visit:
>>> http://kitware.com/products/protraining.html
>>>
>>> Please keep messages on-topic and check the ITK FAQ at:
>>> http://www.itk.org/Wiki/ITK_FAQ
>>>
>>> Follow this link to subscribe/unsubscribe:
>>> http://www.itk.org/mailman/listinfo/insight-developers
>>>
>>
>
>
>
> --
> Cory Quammen
> Computer Integrated Systems for Microscopy and Manipulation (CISMM)
> Department of Computer Science
> University of North Carolina at Chapel Hill
> http://www.cs.unc.edu/~cquammen
>