[osg-users] Can't build documentation

[Gareth Francis]

I had a similar problem a while back.

Try adding EXTENSION_MAPPING=no_extension=C++ into the doxygen config.
https://www.stack.nl/~dimitri/doxygen/manual/config.html#cfg_extension_mapping

It looks like the doxygen config was created for a rather old version, that
defaults files with no extension to c++. This is no longer the case, and
doxygen is only run over the headers (which have no extension).


On 9 December 2015 at 18:37, Eric Gregory <ericg at seriforge.com> wrote:

> 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
>
> _______________________________________________
> osg-users mailing list
> osg-users at lists.openscenegraph.org
> http://lists.openscenegraph.org/listinfo.cgi/osg-users-openscenegraph.org
>
>


-- 
--------------------
Gareth Francis
www.gfrancisdev.co.uk
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openscenegraph.org/pipermail/osg-users-openscenegraph.org/attachments/20151209/394b2cb6/attachment-0001.htm>