Bug 1101342: Debugger-related comment fixes. DONTBUILD r=shu

 - Remove comment reference to removed JSCompartment::addDebuggee.
 - Clarify comments in js::DebugScript.
 - Add back form feeds separating sections of Debugger.cpp.