[openbeos] Re: The Haiku Book
- From: Stephan Assmus <superstippi@xxxxxx>
- To: openbeos@xxxxxxxxxxxxx
- Date: Mon, 11 Sep 2006 00:38:37 +0200
Hello Niels,
> So the point of this mail is probably to get a sort of 'blessing' on
> trying to get that XSL to work, and to try to structure the Doxygen
> documentation. I'll probably start writing a "HOWTO write Haiku API
> documentation" (don't worry, I'll do that in docbook :-) ). Can we reach
> a consensus on this subject?
I came to Haiku after the discussion about docbook versus doxygen, at least
I don't remember it... :-) In many places in the code, I came across
doxygen documentation, and I thought it was pretty nice. Whenever it made
sense, I updated documentation, or tried to include documentation when I
added new functions. I guess this is exactly the point of doxygen. I have
no idea what the reason was to make docbook the official tool for
documentation. (I should probably try to look it up in the mail archives,
but don't feel like that right now.) So if you manage to bridge between
docbook and doxygen somehow, so that we can even continue to document our
stuff with doxygen and official blessing, I'm all for it! I would
appreciate your work very much.
Best regards,
-Stephan
Other related posts:
