[osg-users] Open to updates to the Doxygen configuration files?

[Orphen]

Hi Robert,

Thank you for your response. Laurens just coincidentally answered a 
similar question in the thread "[osg-users] OSG API Guides" earlier. I 
didn't realize we needed to set BUILD_DOCUMENTATION:BOOL=ON when running 
CMake, and I didn't know the make target existed, either.

With his and your answers combined, I was able to generate the 
documentation for OSG 3.7 with Doxygen 1.8.13 without a hitch.

Should we list these steps in the README? Without finding them there, I 
poked around the OSG website and found what I thought were the official 
steps 
(http://www.openscenegraph.org/index.php/documentation/user-guides/106-create-doxygen-documentation). 
This is what led me to think the Doxygen files were malformed.

Thanks,
-Orphen


On 06/28/2018 12:44 AM, Robert Osfield wrote:
> Hi Orphen,
>
> On Thu, 28 Jun 2018 at 07:52, Orphen <orphen at orphen.me> wrote:
>> I tried to build the Doxygen documentation on master today using Doxygen
>> 1.8. The Doxyfiles are a bit dated, and some parts are malformed (ex:
>> environment variable expansion). This causes Doxygen to report some
>> errors and then give up.
> Which version of the OSG are you seeing issues with?  Later versions
> should be more up to date w.r.t Doxygen.
>
> With the OpenSceneGraph-3.6 branch I just ran:
>
>     make doc_openscenegraph
>
> And it worked without warnings or errors.  My doxygen version is:
>
> $ doxygen -v
> 1.8.11
>
> Robert.
> _______________________________________________
> osg-users mailing list
> osg-users at lists.openscenegraph.org
> http://lists.openscenegraph.org/listinfo.cgi/osg-users-openscenegraph.org