OpenSceneGraph Forum Forum Index OpenSceneGraph Forum
Official forum which mirrors the existent OSG mailing lists. Messages posted here are forwarded to the mailing list and vice versa.
 
   FAQFAQ    SearchSearch    MemberlistMemberlist    RulesRules    UsergroupsUsergroups    RegisterRegister 
 Mail2Forum SettingsMail2Forum Settings  ProfileProfile   Log in to check your private messagesLog in to check your private messages   Log inLog in 
   AlbumAlbum  OpenSceneGraph IRC ChatOpenSceneGraph IRC Chat   SmartFeedSmartFeed 

Can't build documentation


 
Post new topic   Reply to topic    OpenSceneGraph Forum Forum Index -> Build system [build]
View previous topic :: View next topic  
Author Message
ericggregory (Eric Gregory)
Newbie


Joined: 29 Nov 2015
Posts: 4

PostPosted: Sun Nov 29, 2015 9:07 pm    Post subject:
Can't build documentation
Reply with quote

Hi All,

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

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

doxygen and graphvis seem to be working just fine. I get a lot of warnings, but they do run to completion and do produce html files.

The problem is the resulting pages only contain a listing of "Files" but no API content. 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
Back to top
View user's profile Send private message
ericggregory (Eric Gregory)
Newbie


Joined: 29 Nov 2015
Posts: 4

PostPosted: Wed Dec 09, 2015 6:41 pm    Post subject:
Can't build documentation
Reply with quote

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



------------------
Post generated by Mail2Forum
Back to top
View user's profile Send private message
Gareth Francis
Guest





PostPosted: Wed Dec 09, 2015 7:07 pm    Post subject:
Can't build documentation
Reply with quote

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 < (
Only registered users can see emails on this board!
Get registred or enter the forums!
)> wrote:
Quote:
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
(
Only registered users can see emails on this board!
Get registred or enter the forums!
)
http://lists.openscenegraph.org/listinfo.cgi/osg-users-openscenegraph.org





--
--------------------
Gareth Francis
www.gfrancisdev.co.uk

------------------
Post generated by Mail2Forum
Back to top
Konstantin Podsvirov
Guest





PostPosted: Thu Dec 10, 2015 3:45 am    Post subject:
Can't build documentation
Reply with quote

Turnkey solution:

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

09.12.2015, 22:03, "Gareth Francis" <>:
Quote:
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 <> wrote:
Quote:
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


------------------
Post generated by Mail2Forum
Back to top
ericggregory (Eric Gregory)
Newbie


Joined: 29 Nov 2015
Posts: 4

PostPosted: Fri Dec 11, 2015 10:28 am    Post subject:
Can't build documentation
Reply with quote

Hi All,

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

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

doxygen and graphvis seem to be working just fine. I get a lot of warnings, but they do run to completion and do produce html files.

The problem is the resulting pages only contain a listing of "Files" but no API content. 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

------------------
Read this topic online here:
http://forum.openscenegraph.org/viewtopic.php?p=65795#65795




Attachments:
http://forum.openscenegraph.org//files/capture_490.png




------------------
Post generated by Mail2Forum
Back to top
View user's profile Send private message
gjames (Goj Ames)
Newbie


Joined: 15 Apr 2016
Posts: 2

PostPosted: Fri Apr 15, 2016 8:49 pm    Post subject:
doxygen also failing in osg 3.5.2
Reply with quote

Hi,
I'm also not able to build the docs, but with different failure:
osg 3.5.2 sync'd from github a few days ago.
Doxygen version 1.8.8
The core_Doxyfile has:
EXTENSION_MAPPING = no_extension=C++
Debian

pwd
/home/gjames/OpenSceneGraph
echo $OSGHOME
/home/gjames/OpenSceneGraph
echo $OpenSceneGraph_SOURCE_DIR
/home/gjames/OpenSceneGraph
doxygen doc/Doxyfiles/core_Doxyfile
Warning: Tag `XML_SCHEMA' at line 195 of file `doc/Doxyfiles/core_Doxyfile' has become obsolete.
To avoid this warning please remove this line from your configuration file or upgrade it using "doxygen -u"
Warning: Tag `XML_DTD' at line 196 of file `doc/Doxyfiles/core_Doxyfile' has become obsolete.
To avoid this warning please remove this line from your configuration file or upgrade it using "doxygen -u"
Warning: argument `${SEARCHENGINE}' for option SEARCHENGINE is not a valid boolean value
Using the default: YES!
Error: tag HTML_FOOTER: footer file `${OpenSceneGraph_SOURCE_DIR}/doc/Doxyfiles/custom_Footer.html' does not exist

ls -l ${OpenSceneGraph_SOURCE_DIR}/doc/Doxyfiles/custom_Footer.html
-rw-r--r-- 1 gjames gjames 408 Apr 12 16:28 /home/gjames/OpenSceneGraph/doc/Doxyfiles/custom_Footer.html

Konstantin - thanks for your link to the pre-built on the web, but I'd like to generate my own local docs.

Thanks for any help,
-G
Back to top
View user's profile Send private message
Alberto Luaces
Guest





PostPosted: Mon Apr 25, 2016 6:02 pm    Post subject:
Can't build documentation
Reply with quote

"Goj Ames" writes:

Quote:
Hi,
I'm also not able to build the docs, but with different failure:
osg 3.5.2 sync'd from github a few days ago.
Doxygen version 1.8.8
The core_Doxyfile has:
EXTENSION_MAPPING = no_extension=C++
Debian

pwd
/home/gjames/OpenSceneGraph
echo $OSGHOME
/home/gjames/OpenSceneGraph
echo $OpenSceneGraph_SOURCE_DIR
/home/gjames/OpenSceneGraph
doxygen doc/Doxyfiles/core_Doxyfile
Warning: Tag `XML_SCHEMA' at line 195 of file `doc/Doxyfiles/core_Doxyfile' has become obsolete.
To avoid this warning please remove this line from your configuration file or upgrade it using "doxygen -u"
Warning: Tag `XML_DTD' at line 196 of file `doc/Doxyfiles/core_Doxyfile' has become obsolete.
To avoid this warning please remove this line from your configuration file or upgrade it using "doxygen -u"
Warning: argument `${SEARCHENGINE}' for option SEARCHENGINE is not a valid boolean value
Using the default: YES!
Error: tag HTML_FOOTER: footer file `${OpenSceneGraph_SOURCE_DIR}/doc/Doxyfiles/custom_Footer.html' does not exist

ls -l ${OpenSceneGraph_SOURCE_DIR}/doc/Doxyfiles/custom_Footer.html
-rw-r--r-- 1 gjames gjames 408 Apr 12 16:28 /home/gjames/OpenSceneGraph/doc/Doxyfiles/custom_Footer.html


Hi Goj, did you try to use "make doc_openscenegraph" instead?

--
Alberto



------------------
Post generated by Mail2Forum
Back to top
gjames (Goj Ames)
Newbie


Joined: 15 Apr 2016
Posts: 2

PostPosted: Fri Apr 29, 2016 5:56 pm    Post subject:
Reply with quote

Hi Alberto,
Thanks for chiming in.
I have no 'doc_' targets in my top level makefile, but I see the bits in CMakeLists.txt, so I tried:
cmake BUILD_DOCUMENTATION .

I get several messages about missing packages, (Freetype, JPEG, Jasper, ... ) which I will fix, but it gives no errors. After this, I still have no doc_ targets in the Makefile.

....
-- Could NOT find PNG (missing: PNG_LIBRARY PNG_PNG_INCLUDE_DIR)
-- Could NOT find TIFF (missing: TIFF_LIBRARY TIFF_INCLUDE_DIR)
-- Could NOT find PkgConfig (missing: PKG_CONFIG_EXECUTABLE)
-- Configuring done
-- Generating done
-- Build files have been written to: /home/gjames/OpenSceneGraph

make doc_openscenegraph
make: *** No rule to make target 'doc_openscenegraph'. Stop.
grep doc_ Makefile
<nothing>

I'm up to date with:
commit a83a59fffe65e28ce110f542122dbf4137b93255
Merge: f013961 89fe663
Date: Thu Mar 31 19:22:03 2016 +0100

Thanks for getting me a bit farther along, and thanks again for any other tips.
-G
Back to top
View user's profile Send private message
Alberto Luaces
Guest





PostPosted: Fri Apr 29, 2016 8:54 pm    Post subject:
Can't build documentation
Reply with quote

Hi Goj,

I think you are almost there: you don't use BUILD_DOCUMENTATION as a
make target, but you have to set it in CMake instead.

You can either activate the BUILD_DOCUMENTATION variable inside CMake
(using ccmake or cmake-gui), or just in the command line with

cmake -DBUILD_DOCUMENTATION=ON

After that, the target doc_openscenegraph should be available.

--
Alberto



------------------
Post generated by Mail2Forum
Back to top
Display posts from previous:   
Post new topic   Reply to topic    OpenSceneGraph Forum Forum Index -> Build system [build] All times are GMT
Page 1 of 1

 
Jump to:  
You cannot post new topics in this forum
You cannot reply to topics in this forum
You cannot edit your posts in this forum
You cannot delete your posts in this forum
You cannot vote in polls in this forum
You cannot attach files in this forum
You cannot download files in this forum

Similar Topics
Topic Author Forum Replies Posted
No new posts iOS build guide locked/checked out on... tomhog General 2 Fri Apr 21, 2017 10:43 pm View latest post
No new posts osg build (master) failed with VS2013... Trajce Nikolov NICK General 2 Thu Feb 09, 2017 2:26 pm View latest post
No new posts Timeout problems with OSX TravisCL build robertosfield General 0 Tue Nov 15, 2016 5:45 pm View latest post
No new posts OSG documentation Inna General 4 Mon Nov 07, 2016 11:40 am View latest post
No new posts Android build failure with Android ND... Andy Tai General 2 Thu Oct 27, 2016 8:11 am View latest post


Board Security Anti Bot Question MOD - phpBB MOD against Spam Bots
Powered by phpBB © 2001, 2005 phpBB Group
Protected by Anti-Spam ACP