[debug] Add few comments. Reogranize debug.h a bit.