THE HAIKU BOOK HOWTOThe end user documentation for Haiku is automatically generated from thesource code using the Doxygen tool. We are talking BeBook-style documentationhere, not development related docs (those belong in trunk/docs/develop).This HOWTO only explains how to include your kit into the "Haiku Book", itis not a Doxygen tutorial. For information about using Doxygen, see the Doxygenmanual, www.doxygen.org, and OpenBeOS newletters 31 and 29.There are two ways to document your kit:1) Put the Doxygen comments in your headers and/or source files.2) Put the Doxygen comments in separate files.Either way is fine. The documentation for the Midi Kit, for example, uses thelatter option. The files with the Doxygen comments all live in the midi2 subdirof trunk/docs/user. Of course, if you embed the Doxygen comments directly inyour source code, you don't need to make a subdir in trunk/docs/user.There is one Doxygen config file (Doxyfile) for the entire book, so you don'thave to make your own Doxyfile. You just have to add the directories with yourcommented files to the INPUT directive, so doxygen will know where to find them.You probably also want to add a link to your kit on the main page (book.dox).To generate the docs, simply type "doxygen" in the Terminal. The script putsthe resulting HTML docs in "trunk/generated/doxygen/html".Note: theoretically, Doxygen allows us to treat each kit as a separate "module",using the \defgroup and \ingroup tags. In practice, the results of this are alittle disappointing. That's why, at least for the time being, we simply lumpeverything together, and give each kit one or more \page's. Feel free to take apeek at the Midi Kit docs to figure out what the hell that means ;-)