[haiku-doc] Problems with docs

Hi all,

I want to work on the driver documentation, but ran into problems.

According to the HOWTO in trunk/docs/user, I should only need to run doxygen 
from this directory. This works in principle, but throws a mess of errors about 
missing links. This is not too good, as I can't see my own errors then. :) This 
happens on Haiku-GCC2, Linux and Windows/Cygwin, so it's not machine-specific.
I also noted that the online version of the Haiku Book at http://factory.haiku-os.org/documentation/Haiku_Book_doxygen/html/ seems to be severely outdated - it's supposed to be a nightly build, but the generation date is 2008-02-14, which is a slight bit old. Any chance of fixing this? 
Oh, and the HOWTO in trunk/docs/user states that the docs can be contained 
either in separate files or in the source files themselves, while the 
appropriate section in the Haiku Book 
(http://factory.haiku-os.org/documentation/Haiku_Book_doxygen/html/apidoc.html) 
explicitely states that documentation should be in its seperate tree. It would 
be nice if this could be unified either way - such guidelines should be 
consistent.

Christian

Other related posts: