Bug 1308572 - Remove unimplemented Debugger.Source features from JS Debugger API docs. r=jorendorff
authorJim Blandy <jimb@red-bean.com>
Fri, 07 Oct 2016 12:22:16 -0700
changeset 343960 0b14f8ef67415fee0053e3d22ad633960b51e549
parent 343959 2426d3b9f4d22e1a71ab43d61ad9d026bf549e3d
child 343961 b7302a1af4fc0169dfb97ea31ffe949844894757
push id10298
push userraliiev@mozilla.com
push dateMon, 14 Nov 2016 12:33:03 +0000
treeherdermozilla-aurora@7e29173b1641 [default view] [failures only]
perfherder[talos] [build metrics] [platform microbench] (compared to previous push)
reviewersjorendorff
bugs1308572
milestone52.0a1
Bug 1308572 - Remove unimplemented Debugger.Source features from JS Debugger API docs. r=jorendorff
js/src/doc/Debugger/Debugger.Source.md
--- a/js/src/doc/Debugger/Debugger.Source.md
+++ b/js/src/doc/Debugger/Debugger.Source.md
@@ -72,27 +72,16 @@ from its prototype:
     code, as a string. The value satisfies the `Program`,
     `FunctionDeclaration`, or `FunctionExpression` productions in the
     ECMAScript standard.
 
     **If the instance refers to WebAssembly code**, the serialized text
     representation. The format is yet to be specified in the WebAssembly
     standard. Currently, the text is an s-expression based syntax.
 
-`enclosingStart` <i>(future plan)</i>
-:   The position within the enclosing document at which this source's text
-    starts. This is a zero-based character offset. (The length of this
-    script within the enclosing document is `source.length`.)
-
-`lineCount` <i>(future plan)</i>
-:   The number of lines in the source code. If there are characters after
-    the last newline in the source code, those count as a final line;
-    otherwise, `lineCount` is equal to the number of newlines in the source
-    code.
-
 `url`
 :   **If the instance refers to JavaScript source**, the URL from which this
     source was loaded, if this source was loaded from a URL. Otherwise, this
     is `undefined`. Source may be loaded from a URL in the following ways:
 
     * The URL may appear as the `src` attribute of a `<script>` element
       in markup text.
 
@@ -224,48 +213,8 @@ from its prototype:
     the [`Debugger`][debugger-object] instance that owns this source; and thus
     the creating call is never "in debuggee code". Relating a worker to its
     creator, and other multi-threaded debugging concerns, are out of scope for
     [`Debugger`][debugger-object].
 
     **If the instance refers to WebAssembly code**, `introductionScript` is
     the [`Debugger.Script`][script] instance referring to the same underlying
     WebAssembly module. `introductionOffset` is `undefined`.
-
-
-## Function Properties of the Debugger.Source Prototype Object
-
-<code>substring(<i>start</i>, [<i>end</i>])</code> <i>(future plan)</i>
-:   Return a substring of this instance's `source` property, starting at
-    <i>start</i> and extending to, but not including, <i>end</i>. If
-    <i>end</i> is `undefined`, the substring returned extends to the end of
-    the source.
-
-    Both indices are zero-based. If either is `NaN` or negative, it is
-    replaced with zero. If either is greater than the length of the source,
-    it is replaced with the length of the source. If <i>start</i> is larger
-    than <i>end</i>, they are swapped. (This is meant to be consistent with
-    the way `String.prototype.substring` interprets its arguments.)
-
-<code>lineToPosition(<i>line</i>)</code> <i>(future plan)</i>
-:   Return an object of the form
-    <code>{ line:<i>line</i>, start:<i>start</i>, length:<i>length</i> }</code>, where
-    <i>start</i> is the character index within `source` of the first
-    character of line number <i>line</i>, and <i>length</i> is the length of
-    that line in characters, including the final newline, if any. The first
-    line is numbered one. If <i>line</i> is negative or greater than the
-    number of lines in this `Debugger.Source` instance, then return `null`.
-
-<code>positionToLine(<i>start</i>)</code> <i>(future plan)</i>
-:   Return an object of the form
-    <code>{ line:<i>line</i>, start:<i>start</i>, length:<i>length</i> }</code>, where
-    <i>line</i> is the line number containing the character position
-    <i>start</i>, and <i>length</i> is the length of that line in
-    characters, including the final newline, if any. The first line is
-    numbered one. If <i>start</i> is negative or greater than the length of
-    the source code, then return `null`.
-
-<code>findScripts(<i>query</i>)</code> <i>(future plan)</i>
-:   Return an array of [`Debugger.Script`][script] instances for all debuggee scripts
-    matching <i>query</i> that are produced from this `Debugger.Source`
-    instance. Aside from the restriction to scripts produced from this
-    source, <i>query</i> is interpreted as for
-    `Debugger.prototype.findScripts`.