add a new 'SetCurrentDebugType' API (requested by Andrew Haley for JIT

stuff) to programmatically control the current debug flavor.  While 
I'm at it, doxygenate Debug.h and clean it up.

llvm-svn: 85395