docs(angular.module): improve docs

Sequoia · IgorMinar · commit 411c84bf2cb5 · 2013-08-21T02:20:56.000-07:00
it wasn't clear before that if given the same name a second time this method RETRIEVES an EXISTING module. Not even sure if my description is accurate, hoping someone will either confirm and merge or clear it up. Closes angular#3666
diff --git a/src/loader.js b/src/loader.js
@@ -23,10 +23,13 @@ function setupModuleLoader(window) {
      * @name angular.module
      * @description
      *
-     * The `angular.module` is a global place for creating and registering Angular modules. All
-     * modules (angular core or 3rd party) that should be available to an application must be
+     * The `angular.module` is a global place for creating, registering and retrieving Angular modules.
+     * All modules (angular core or 3rd party) that should be available to an application must be
      * registered using this mechanism.
      *
+     * When passed two or more arguments, a new module is created.  If passed only one argument, an
+     * existing module (the name passed as the first argument to `module`) is retrieved.
+     *
      *
      * # Module
      *

Original file line number	Diff line number	Diff line change
`@@ -23,10 +23,13 @@ function setupModuleLoader(window) {`
`23`	`23`	`* @name angular.module`
`24`	`24`	`* @description`
`25`	`25`	`*`
`26`		- * The `angular.module` is a global place for creating and registering Angular modules. All
`27`		`- * modules (angular core or 3rd party) that should be available to an application must be`
	`26`	+ * The `angular.module` is a global place for creating, registering and retrieving Angular modules.
	`27`	`+ * All modules (angular core or 3rd party) that should be available to an application must be`
`28`	`28`	`* registered using this mechanism.`
`29`	`29`	`*`
	`30`	`+ * When passed two or more arguments, a new module is created. If passed only one argument, an`
	`31`	+ * existing module (the name passed as the first argument to `module`) is retrieved.
	`32`	`+ *`
`30`	`33`	`*`
`31`	`34`	`* # Module`
`32`	`35`	`*`