docs(*): ensure jsdoc type expressions are valid

petebacondarwin · petebacondarwin · commit e89139dc9dd4 · 2014-03-02T15:02:29.000Z
diff --git a/src/ng/directive/script.js b/src/ng/directive/script.js
@@ -12,7 +12,7 @@
  * `<script>` element must be specified as `text/ng-template`, and a cache name for the template must be
  * assigned through the element's `id`, which can then be used as a directive's `templateUrl`.
  *
- * @param {'text/ng-template'} type Must be set to `'text/ng-template'`.
+ * @param {string} type Must be set to `'text/ng-template'`.
  * @param {string} id Cache name of the template.
  *
  * @example
diff --git a/src/ng/http.js b/src/ng/http.js
@@ -573,7 +573,7 @@ function $HttpProvider() {
      *   - **headers** – `{function([headerName])}` – Header getter function.
      *   - **config** – `{Object}` – The configuration object that was used to generate the request.
      *
-     * @property {Array.&ltObject&gt;} pendingRequests Array of config objects for currently pending
+     * @property {Array.<Object>} pendingRequests Array of config objects for currently pending
      *   requests. This is primarily meant to be used for debugging purposes.
      *
      *
@@ -875,7 +875,6 @@ function $HttpProvider() {
         /**
          * @ngdoc property
          * @name $http#defaults
-         * @propertyOf ng.$http
          *
          * @description
          * Runtime equivalent of the `$httpProvider.defaults` property. Allows configuration of
diff --git a/src/ng/rootScope.js b/src/ng/rootScope.js
@@ -870,7 +870,7 @@ function $RootScopeProvider(){
        *   - `defaultPrevented` - `{boolean}`: true if `preventDefault` was called.
        *
        * @param {string} name Event name to listen on.
-       * @param {function(event, args...)} listener Function to call when the event is emitted.
+       * @param {function(event, ...args)} listener Function to call when the event is emitted.
        * @returns {function()} Returns a deregistration function for this listener.
        */
       $on: function(name, listener) {
diff --git a/src/ngResource/resource.js b/src/ngResource/resource.js
@@ -97,7 +97,7 @@ function shallowClearAndCopy(src, dst) {
  *   If the parameter value is prefixed with `@` then the value of that parameter is extracted from
  *   the data object (useful for non-GET operations).
  *
- * @param {Object.&lt;Object&gt;=} actions Hash with declaration of custom action that should extend
+ * @param {Object.<Object>=} actions Hash with declaration of custom action that should extend
  *   the default set of resource actions. The declaration should be created in the format of {@link
  *   ng.$http#usage_parameters $http.config}:
  *
diff --git a/src/ngRoute/route.js b/src/ngRoute/route.js
@@ -247,7 +247,7 @@ function $RouteProvider(){
      *     - `$scope` - The current route scope.
      *     - `$template` - The current route template HTML.
      *
-     * @property {Array.&lt;Object&gt;} routes Array of all configured routes.
+     * @property {Array.<Object>} routes Array of all configured routes.
      *
      * @description
      * `$route` is used for deep-linking URLs to controllers and views (HTML partials).

Original file line number	Diff line number	Diff line change
`@@ -12,7 +12,7 @@`
`12`	`12`	* `<script>` element must be specified as `text/ng-template`, and a cache name for the template must be
`13`	`13`	* assigned through the element's `id`, which can then be used as a directive's `templateUrl`.
`14`	`14`	`*`
`15`		- * @param {'text/ng-template'} type Must be set to `'text/ng-template'`.
	`15`	+ * @param {string} type Must be set to `'text/ng-template'`.
`16`	`16`	`* @param {string} id Cache name of the template.`
`17`	`17`	`*`
`18`	`18`	`* @example`
Original file line number	Diff line number	Diff line change
`@@ -573,7 +573,7 @@ function $HttpProvider() {`
`573`	`573`	* - headers – `{function([headerName])}` – Header getter function.
`574`	`574`	* - config – `{Object}` – The configuration object that was used to generate the request.
`575`	`575`	`*`
`576`		`- * @property {Array.&ltObject>} pendingRequests Array of config objects for currently pending`
	`576`	`+ * @property {Array.<Object>} pendingRequests Array of config objects for currently pending`
`577`	`577`	`* requests. This is primarily meant to be used for debugging purposes.`
`578`	`578`	`*`
`579`	`579`	`*`
`@@ -875,7 +875,6 @@ function $HttpProvider() {`
`875`	`875`	`/**`
`876`	`876`	`* @ngdoc property`
`877`	`877`	`* @name $http#defaults`
`878`		`- * @propertyOf ng.$http`
`879`	`878`	`*`
`880`	`879`	`* @description`
`881`	`880`	* Runtime equivalent of the `$httpProvider.defaults` property. Allows configuration of
Original file line number	Diff line number	Diff line change
`@@ -870,7 +870,7 @@ function $RootScopeProvider(){`
`870`	`870`	* - `defaultPrevented` - `{boolean}`: true if `preventDefault` was called.
`871`	`871`	`*`
`872`	`872`	`* @param {string} name Event name to listen on.`
`873`		`- * @param {function(event, args...)} listener Function to call when the event is emitted.`
	`873`	`+ * @param {function(event, ...args)} listener Function to call when the event is emitted.`
`874`	`874`	`* @returns {function()} Returns a deregistration function for this listener.`
`875`	`875`	`*/`
`876`	`876`	`$on: function(name, listener) {`
Original file line number	Diff line number	Diff line change
`@@ -97,7 +97,7 @@ function shallowClearAndCopy(src, dst) {`
`97`	`97`	* If the parameter value is prefixed with `@` then the value of that parameter is extracted from
`98`	`98`	`* the data object (useful for non-GET operations).`
`99`	`99`	`*`
`100`		`- * @param {Object.<Object>=} actions Hash with declaration of custom action that should extend`
	`100`	`+ * @param {Object.<Object>=} actions Hash with declaration of custom action that should extend`
`101`	`101`	`* the default set of resource actions. The declaration should be created in the format of {@link`
`102`	`102`	`* ng.$http#usage_parameters $http.config}:`
`103`	`103`	`*`
Original file line number	Diff line number	Diff line change
`@@ -247,7 +247,7 @@ function $RouteProvider(){`
`247`	`247`	* - `$scope` - The current route scope.
`248`	`248`	* - `$template` - The current route template HTML.
`249`	`249`	`*`
`250`		`- * @property {Array.<Object>} routes Array of all configured routes.`
	`250`	`+ * @property {Array.<Object>} routes Array of all configured routes.`
`251`	`251`	`*`
`252`	`252`	`* @description`
`253`	`253`	* `$route` is used for deep-linking URLs to controllers and views (HTML partials).