> I know documenting the code can be a hassle but I believe it would help users a lot if you included in the documentation which functions throw which exceptions.
Hmm. This sounds like a nice idea but I have found that the trouble with such documentation is that it cannot be trusted. What would be really nice if if a code analyser could determine this for itself. Maybe the facility could be added to doxygen. However, this is far from easy. It has been discussed many times on comp.lang.c++.moderated. Also, see my proposal for static exception checking at http://www.marlowa.plus.com/goodies/proposal.pdf