The HTML output for enum's and struct's is very poor. Yes, you're right.
Source files can contain a lot of extraneous goop that makes things harder to parse.
More seriously, I'd think the comments for the functions would do a better job at describing what's in the file anyways. Yes, this would be very nice too. It brings up a whole host of issues though, so things like this are a bit farther off. I'm not sure. This message is from the Autodoc discussion list.