[osg-users] Can't build documentation

[Konstantin Podsvirov]

Turnkey solution:

http://lists.openscenegraph.org/pipermail/osg-submissions-openscenegraph.org/2015-December/033750.html

09.12.2015, 22:03, "Gareth Francis" <gfrancis.dev at gmail.com>:
> I had a similar problem a while back.
>
> Try adding EXTENSION_MAPPING=no_extension=C++ into the doxygen config file.
> https://www.stack.nl/~dimitri/doxygen/manual/config.html#cfg_extension_mapping
>
> It looks like the doxygen config file 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 February 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 (make or devenv), 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
> --------------------
> Gareth Francis
> www.gfrancisdev.co.uk

--
Regards,
Konstantin Podsvirov