Bug 736733: Remove documentation for unneeded Debugger.Frame.prototype.pop and .replaceCall. DONTBUILD r=shu

This commit is contained in:
Jim Blandy 2014-05-12 17:59:50 -07:00
parent 6dd06f9ea8
commit 644c5fab58

View File

@ -329,41 +329,6 @@ methods of other kinds of objects.
The <i>options</i> argument is as for
[`Debugger.Frame.prototype.eval`][fr eval], described above.
<code>pop(<i>completion</i>)</code> <i>(future plan)</i>
: Pop this frame (and any younger frames) from the stack as if this frame
had completed as specified by the completion value <i>completion</i>.
Note that this does <i>not</i> resume the debuggee's execution; it
merely adjusts the debuggee's state to what it would be if this frame's
execution had completed. The debuggee will only resume execution when
you return from the handler method that brought control to the debugger
originally.
This cannot remove any `"call"` frames for calls to host functions from
the stack. (We might be able to make this work eventually, but it will
take some cleverness.)
<code>replaceCall(<i>function</i>, <i>this</i>, <i>arguments</i>)</code> <i>(future plan)</i>
: Pop any younger frames from the stack, and then change this frame into
a frame for a call to <i>function</i>, with the given <i>this</i> value
and <i>arguments</i>. <i>This</i> should be a debuggee value, or
`{ asConstructor: true }` to invoke <i>function</i> as a constructor,
in which case SpiderMonkey provides an appropriate `this` value itself.
<i>Arguments</i> should be an array of debuggee values. This frame must
be a `"call"` frame.
This can be used as a primitive in implementing some forms of a "patch
and continue" debugger feature.
Note that this does <i>not</i> resume the debuggee's execution; it
merely adjusts the debuggee's state to what it would be if this frame
were about to make this call. The debuggee will only resume execution
when you return from the handler method that brought control to the
debugger originally.
Like `pop`, this cannot remove `"call"` frames for calls to host
functions from the stack.
## Generator Frames