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

[Cory Quammen]

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