docs(script): add more detailed information

Gias Kay Lee · IgorMinar · commit 1c045f1b463c · 2014-01-08T00:49:29.000-08:00
Closes angular#5671 Closes angular#5676
diff --git a/src/ng/directive/script.js b/src/ng/directive/script.js
@@ -6,10 +6,14 @@
  * @restrict E
  *
  * @description
- * Load content of a script tag, with type `text/ng-template`, into `$templateCache`, so that the
- * template can be used by `ngInclude`, `ngView` or directive templates.
+ * Load the content of a `<script>` element into {@link api/ng.$templateCache `$templateCache`}, so that the
+ * template can be used by {@link api/ng.directive:ngInclude `ngInclude`},
+ * {@link api/ngRoute.directive:ngView `ngView`}, or {@link guide/directive directives}. The type of the
+ * `<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 {'text/ng-template'} type Must be set to `'text/ng-template'`.
+ * @param {string} id Cache name of the template.
  *
  * @example
   <doc:example>

Original file line number	Diff line number	Diff line change
`@@ -6,10 +6,14 @@`
`6`	`6`	`* @restrict E`
`7`	`7`	`*`
`8`	`8`	`* @description`
`9`		- * Load content of a script tag, with type `text/ng-template`, into `$templateCache`, so that the
`10`		- * template can be used by `ngInclude`, `ngView` or directive templates.
	`9`	+ * Load the content of a `<script>` element into {@link api/ng.$templateCache `$templateCache`}, so that the
	`10`	+ * template can be used by {@link api/ng.directive:ngInclude `ngInclude`},
	`11`	+ * {@link api/ngRoute.directive:ngView `ngView`}, or {@link guide/directive directives}. The type of the
	`12`	+ * `<script>` element must be specified as `text/ng-template`, and a cache name for the template must be
	`13`	+ * assigned through the element's `id`, which can then be used as a directive's `templateUrl`.
`11`	`14`	`*`
`12`		- * @param {'text/ng-template'} type must be set to `'text/ng-template'`
	`15`	+ * @param {'text/ng-template'} type Must be set to `'text/ng-template'`.
	`16`	`+ * @param {string} id Cache name of the template.`
`13`	`17`	`*`
`14`	`18`	`* @example`
`15`	`19`	`<doc:example>`