| Summary: | SDL source code documentation does not work with doxygen | ||
|---|---|---|---|
| Product: | SDL | Reporter: | Ken Bull <llubnek> |
| Component: | *don't know* | Assignee: | Sam Lantinga <slouken> |
| Status: | RESOLVED FIXED | QA Contact: | Sam Lantinga <slouken> |
| Severity: | enhancement | ||
| Priority: | P2 | CC: | icculus |
| Version: | HG 1.2 | Keywords: | target-1.2.14 |
| Hardware: | All | ||
| OS: | All | ||
| Attachments: |
Adds Doxygen support for all headers (except config and boilerplate headers) in the include folder for SDL-1.2 revision 4446.
Doxyfile for SDL 1.2 |
||
Created attachment 303 [details]
Doxyfile for SDL 1.2
Here's a Doxyfile to go with the patch. This may not be perfect, it was just a cut-and-paste from the SDL_sound project.
Install Doxygen, put this in SDL-1.2's base directory and run "doxygen" with no arguments ... then you'll get a "doxygen" directory with HTML, .rtf, and manpages.
--ryan.
Tossing this bug to Sam. Keeping the headers Doxygen-friendly is a _really_ good idea, even with an external documentation wiki. This will probably need to be tweaked to your liking, and eventually, someone will have to do this for the 1.3 branch (but we'll call that a separate bug, if this one works out as an experiment with 1.2). --ryan. Tagging this bug with "target-1.2.14" so we can try to resolve it for SDL 1.2.14. Please note that we may choose to resolve it as WONTFIX. This tag is largely so we have a comprehensive wishlist of bugs to examine for 1.2.14 (and so we can close bugs that we'll never fix, rather than have them live forever in Bugzilla). --ryan. Wow, this is awesome. I've tried to start adding doxygen support to SDL 1.3, but I don't have as much experience with it as you have. Would you mind going through and checking the SDL 1.3 headers to see where they can be improved? Thanks! |
Created attachment 301 [details] Adds Doxygen support for all headers (except config and boilerplate headers) in the include folder for SDL-1.2 revision 4446. While in general SDL is quite thoroughly commented, none of these comments are correctly formatted for Doxygen and are generally inconsistent in their formatting.