I’ve posted a patch to bugzilla to get doxygen working with the comments in
SDL-1.2’s include files.
You can find it listed under Bug 706
http://bugzilla.libsdl.org/show_bug.cgi?id=706.
reStructuredText http://docutils.sourceforge.net/rst.html would be nicer of
course, but need the tools first.
Synopsis http://synopsis.fresco.org/index.html might work.