Hi JCL & Mathieu,

Thanks for explanation.

I think what we need is to make the search and tag options for
building, controlled by Cmake variables rather than having them on by
default.  Generating docs for the website is something only done at
most for each stable release, while end users will build local docs
much more often.

JCL, Could you have a bash at making these features optional?

Robert.

On Jan 23, 2008 1:38 PM, Jean-Christophe Lombardo <[EMAIL PROTECTED]> wrote:
> Oups, sorry. I did not noticed your answer before.
>
> 1) searching: it requires that your web server as php 4.1.0 or above
> enabled. Mainly, it means that the search engine won't work if you
> test it through the file::// protocol.
>
> 2) tag files. They keep in a way that doxygen understand a link
> between the code and the documentation. It is useful to establish
> links between documentations.
> Typically we have setup a local server which hold doxygen extracted
> documentation for the various API we are using. Every night, we
> regenerate our own application documentation with something like this
>   cd $PROJECTROOT
>   svn update
>   cd doc
>   wget -N http://my.local.doc.server/osg/osg.tag
>   doxygen
> In the Doxyfile the link between tags and URL is defined by:
> TAGFILES = osg.tag=http://my.local.doc.server/osg/
> This defines html links for osg entities used in our application.
>
> If you generate a tag file with osg official documentation, I (and
> every osg user) could establish link directly with
> http://www.openscenegraph.org/documentation/OpenSceneGraphReferenceDocs/
> instead of keeping a local copy.
>
>
> jcl
>
> PS: I'm not sure that I made myself clear... Today seems to be a hard
> day for English speaking...
>
> _______________________________________________
> osg-submissions mailing list
> [email protected]
> http://lists.openscenegraph.org/listinfo.cgi/osg-submissions-openscenegraph.org
>
_______________________________________________
osg-submissions mailing list
[email protected]
http://lists.openscenegraph.org/listinfo.cgi/osg-submissions-openscenegraph.org

Reply via email to