> > This patch just removes/restructures some of the doxygen markup to > > avoid warnings when generating the documentation. Most of the > > libstdc++ headers are pretty doxygen clean now. > > By the way, I recently made this feature request for Doxygen: > > https://bugzilla.gnome.org/show_bug.cgi?id=665506 > > That would allow us to refer to "pos" not "__pos" in the doxygen > comments, and for the generated docs to be much nicer to read, without > uglified names.
Awesome. That would be useful. At this point, most of the libstdc++ headers have pretty much warning-free docs, at least with current doxygen binaries. The macro trickery in PB_DS kind of makes doxygen go crazy. And some of the new C++11 features like variadic and mutable/default/deleted etc. result in weird/humorous messages. That said, the latest doxygen (1.7.6?) fails miserably, on cxxabi.h no less. And the PDF_HYPERLINKS issue is still present. Some of the time I think I can at least pinpoint the file with the markup that is making this crazy/bad by editing out docs/doxygen/user.cfg.in to only be all the files in bits or all the files in ext, etc. Alas, I've not been able to get anything reproducible. But this argument thing would really be nice to have. I went ahead and uglified the markup in <algorithm> since that was triggering so many warnings elsewere. -benjamin
