Hi Mattias, On Mon, Dec 15, 2008 at 1:35 PM, Mattias Helsing <[email protected]> wrote: > I'm about to post a little improvement on the refdoc generation. It > includes an update of the doc/doxyfile.cmake template and an install > target for the generated documentation. The latter will enable > packaging openscenegraph-doc. I have some questions though:
I was thinking along the same lines - that an openscenegraph-doc would be appropriate. > 1 I have updated and worked with doxyfile.cmake. In the doc folder are > also all_Doxyfile, auto_Doxyfile, auto_Mainpage, core_Doxyfile but > they seem to be outdated to different degrees. Now I can update these > and add separate targets for them but only if we want them. Otherwise > they should be removed. Thoughts? I'd say update them all, but then just have one doc target. > 2 The current generated refdocs doesn't include OpenThreads. Should > there be a separate documentation for openthreads or should it be made > part of OpenScenGraphReferenceDocs? Technically we have an libopenthreads package so a openthreads-doc package would be appropriate. One could roll the openthreads docs into openscenegraph-doc, but then it breaks the consistent lines that we trying to draw in the packaging. I think we also have to bare in mind what other package maintainers such as for Debian or Redhat would require, and in this case I'd guess that they would go for an separate openthreads-doc. Robert. _______________________________________________ osg-users mailing list [email protected] http://lists.openscenegraph.org/listinfo.cgi/osg-users-openscenegraph.org
