fixing docs for angular.scope

2 files changed, 11 insertions, 2 deletions

diff --git a/src/Angular.js b/src/Angular.js
index cc85f927..3637479c 100644
--- a/src/Angular.js
+++ b/src/Angular.js
@@ -1040,7 +1040,7 @@ function merge(src, dst) {
    </pre>
  *
  * @param {string|DOMElement} element Element to compile.
- * @param {Object} parentScope Scope to become the parent scope of the newly compiled scope.
+ * @param {Object=} parentScope Scope to become the parent scope of the newly compiled scope.
  * @returns {Object} Compiled scope object.
  */
 function compile(element, parentScope) {
diff --git a/src/Scope.js b/src/Scope.js
index 673e6e84..09779453 100644
--- a/src/Scope.js
+++ b/src/Scope.js
@@ -191,7 +191,16 @@ function errorHandlerFor(element, error) {
  * Note: A widget that creates scopes (i.e. {@link angular.widget.@ng:repeat ng:repeat}) is
  * responsible for forwarding `$eval()` calls from the parent to those child scopes. That way,
  * calling $eval() on the root scope will update the whole page.
-
+ *
+ *
+ * @TODO THESE PARAMS AND RETURNS ARE NOT RENDERED IN THE TEMPLATE!! FIX THAT!
+ * @param {Object} parent The scope that should become the parent for the newly created scope.
+ * @param {Object.<string, function()>=} providers Map of service factory which need to be provided
+ *     for the current scope. Usually {@link angular.service}.
+ * @param {Object.<string, *>=} instanceCache Provides pre-instantiated services which should
+ *     append/override services provided by `providers`.
+ * @returns {Object} Newly created scope.
+ *
  *
  * @exampleDescription
  * This example demonstrates scope inheritance and property overriding.