[osg-users] Can't build documentation

[Eric Gregory]

Hi All,

New to this list, so forgive me if this has been addressed, but I can't
find any other posts about this issue.

We're unable to build the OSG documentation.  The SDK (bins/includes/libs)
builds and installs just fine, and we're successfully building apps with
the results.  The problem is only with the docs.

doxygen and graphvis seem to be working just fine.  They do run to
completion and do produce html files.  There are a few warnings though.
Here is the output:
---
% make doc_openscenegraph
Warning: doxygen no longer ships with the FreeSans font.
You may want to clear or change DOT_FONTNAME.
Otherwise you run the risk that the wrong font is being used for dot
generated graphs.
/src/OpenSceneGraph/OpenSceneGraph-3.4.0/include/osg/Program:474: warning:
Reached end of file while still inside a (nested) comment. Nesting level 2
(probable line reference: 179, 179)
/src/OpenSceneGraph/OpenSceneGraph-3.4.0/include/osg/Shader:363: warning:
Reached end of file while still inside a (nested) comment. Nesting level 2
(probable line reference: 52, 52)
/src/OpenSceneGraph/OpenSceneGraph-3.4.0/include/osgViewer/View:343:
warning: Reached end of file while still inside a (nested) comment.
Nesting level 2 (probable line reference: 137, 137)
Built target doc_openscenegraph
---

The problem is the resulting pages only contain a listing of "Files" but
no classes or functions.    The "Main Page" only contains a single "Files"
tab, but none of the other tabs ("Namespaces", "Classes", etc.).  See
attached screenshot.

I'm using latest versions of CMake/doxygen/grpahivs.

The results are the same under both Windows 7 w/ VisualStudio 2013 and
debian linux w/ gcc 4.9.2.

Also getting the same results whether I invoke the doc build through the
build system (devenv or make), or directly via doxygen on the command
line.

Any tips?

Alternatively, I would be just as happy with a downloadable archive of the
docs that I can install locally, but cannot find any pre-built docs.

Thank you,
Eric
-------------- next part --------------
A non-text attachment was scrubbed...
Name: Capture.PNG
Type: image/png
Size: 94637 bytes
Desc: not available
URL: <http://lists.openscenegraph.org/pipermail/osg-users-openscenegraph.org/attachments/20151209/8bff13b1/attachment-0001.png>