[PATCH] Tweaks to the API documentation

[waddlesplash]

The commit message aptly describes what this patch does:

  * Update the Doxyfile for 1.7.6.1. Doxywizard reformatted the comments; that's why this change is so big
  * Disable graph inheritance trees; use "Inherits/Inherited by" lists instead (Doxygen has this on by default; I don't think it was intentional)
  * Shorten two subgroup names; helps with formatting in Doxygen 1.8 and looks cleaner
  * Moves the page footer ("The Haiku Book pre-R1...") be in a <footer> tag, and add a CSS rule for this tag
  * Disable XML output, no one is using it
  * Disable Microsoft IDL parsing, speeds up Doxygen a bit

[waddlesplash]

The patch file

[jscipione]

Like I said on the haiku-doc mailing list, I prefer the inheritance graphs as they are now. The rest of the changes seem fine. It's a little annoying that trailing spaces were added to the Doxyfile by the updated but oh well. We still don't have a way to make code blocks indent correctly in Doxygen 1.8 unfortunately.

[waddlesplash]

Replying to jscipione:

We still don't have a way to make code blocks indent correctly in Doxygen 1.8 unfortunately.

Probably because 1. markdown support is on by default in 1.8; this can be fixed in the Doxyfile and 2. the CSS tags got a makeover, our "book.css" file will have to be updated.

[pulkomandy]

+1 on removing the graphs from me. They are going to grow as we add classes to the book, making them less useable than they are now (look at BArchivable to see how annoying this can get).

Instead, we could have a single graph with all classes, or maybe one per kit or something. At least make them hidden by default so you can more easily get to the useful part of the page.

[jscipione]

"The options DOT_GRAPH_MAX_NODES and MAX_DOT_GRAPH_DEPTH can be used to limit the size of the various graphs."

[jscipione]

I've committed this patch will all changes except for setting CLASS_DIAGRAMS = NO in hrev46948.

[waddlesplash]

I think this ticket can be closed now. The issue of graphs can be resolved elsewhere.