| | 1 | // summary: |
| | 2 | // This is the "source loader" for Dojo. This dojo.js ensures that all |
| | 3 | // Base APIs are available once its execution is complete and attempts to |
| | 4 | // automatically determine the correct host environment to use. |
| | 5 | // description: |
| | 6 | // "dojo.js" is the basic entry point into the toolkit for all uses and |
| | 7 | // users. The "source loader" is replaced by environment-specific builds |
| | 8 | // and so you should not assume that built versions of the toolkit will |
| | 9 | // function in all supported platforms (Browsers, Rhino, Spidermonkey, |
| | 10 | // etc.). In most cases, users will receive pre-built dojo.js files which |
| | 11 | // contain all of the Base APIs in a single file and which specialize for |
| | 12 | // the Browser platform. After loading dojo.js, you will be able to do the |
| | 13 | // following with the toolkit: |
| | 14 | // All platforms: |
| | 15 | // - load other packages (dojo core, dijit, dojox, and custom |
| | 16 | // modules) to better structure your code and take advantage of |
| | 17 | // the inventive capabilities developed by the broad Dojo |
| | 18 | // community |
| | 19 | // - perform basic network I/O |
| | 20 | // - use Dojo's powerful language supplementing APIs |
| | 21 | // - take advantage of the Dojo event system to better structure |
| | 22 | // your application |
| | 23 | // Browser only: |
| | 24 | // - use Dojo's powerful and blisteringly-fast CSS query engine to |
| | 25 | // upgrade and active your web pages without embedding |
| | 26 | // JavaScript in your markup |
| | 27 | // - get and set accurate information about element style |
| | 28 | // - shorten the time it takes to build and manipulate DOM |
| | 29 | // structures with Dojo's HTML handling APIs |
| | 30 | // - create more fluid UI transitions with Dojo's robust and |
| | 31 | // battle-tested animation facilities |
| | 32 | |
| | 33 | // NOTE: |
| | 34 | // If you are reading this file, you have received a "source" build of |
| | 35 | // Dojo. Unless you are a Dojo developer, it is very unlikely that this is |
| | 36 | // what you want. While functionally identical to builds, source versions |
| | 37 | // of Dojo load more slowly than pre-processed builds. |
| | 38 | // |
| | 39 | // We strongly recommend that your applications always use a build of |
| | 40 | // Dojo. To download such a build or find out how you can create |
| | 41 | // customized, high-performance packages of Dojo suitable for use with |
| | 42 | // your application, please visit: |
| | 43 | // |
| | 44 | // http://dojotoolkit.org |
| | 45 | // |
| | 46 | // Regards, |
| | 47 | // The Dojo Team |
| | 48 | |
