[haiku-doc] Problems with docs
- From: Christian Packmann <Christian.Packmann@xxxxxx>
- To: haiku-doc@xxxxxxxxxxxxx
- Date: Sat, 14 Feb 2009 13:47:21 +0100
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:
