[Doxygen-develop] Is there any interest in incorporating any of these changes into doxygen?
Brought to you by:
dimitri
From: John S. <jsc...@gm...> - 2011-11-09 22:20:57
|
Hello doxygen developers, I am working on documenting the API documentation of Haiku for the Haiku Project using doxygen. I've made a few additions to doxygen in order to support some features I'd like to have. I am wondering if there is interest in incorporating any of the changes I've made before I set off to do the work of regression testing and making proper patches. The following screenshot demonstrates most of the changes: http://imagebin.org/183387 The changes are as follows: (Consider all these features to be optional, you'll have to opt-in if you want them) 0. Make a distinction between functions and methods -- methods are functions with a parent. All methods are functions but not all functions are methods. (needed for 2) 1. Add a title before each item in the detailed description. For functions the title gets an innertube () automatically attached. 2. Use CSS (for the html output) to style the above titles, class names, method names, function names, types, parameters, default values, qualifiers (like const and virtual) and punctuation. You can see in the example that I made each of these a different color. 3. If a method or function is overloaded show all the overloads together followed by a detailed description of each. Alphabetically sorted (via SORT_MEMBER_DOCS = YES) output is a pre-requisite for this. Comments and questions welcome. Thanks, John Scipione |